README.md

piapi-mcp-server

A TypeScript implementation of a Model Context Protocol (MCP) server that integrates with PiAPI's API. PiAPI makes user able to generate media content with Midjourney/Flux/Kling/LumaLabs/Udio/Chrip/Trellis directly from Claude or any other MCP-compatible apps.

Features (more coming soon)

• Flux Image generation from text descriptions
• Flux Image generation with image prompt
• Midjourney Image generation
• Kling video generation
• Luma Dream Machine video generation
• Suno/Udio ai song generation
• Trellis 3D model generation
• Workflow planning inside LLMs

Working with Claude Desktop

Prerequisites

• Node.js 16.x or higher
• npm or yarn
• A PiAPI API key (get one at piapi.ai)

Installation

1. Clone the repository:

git clone https://github.com/apinetwork/piapi-mcp-server
cd piapi-mcp-server

2. Install dependencies:

npm install

3. Create a .env file in the project root:

PIAPI_API_KEY=your_api_key_here

4. Build the project:

npm run build

Usage

Running the Server

npm start

Connecting to Claude Desktop

Add this to your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "piapi": {
      "command": "node",
      "args": ["/absolute/path/to/piapi-mcp-server/dist/index.js"],
      "env": {
        "PIAPI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Development

Project Structure

piapi-mcp-server/
├── src/
│   ├── index.ts        # Main server entry point
├── package.json
├── tsconfig.json
└── .env

License

MIT