PiAPI is an MCP server that connects MCP-compatible applications to PiAPI's API for generating multimedia assets. The server allows developers, digital artists, and creative professionals to trigger image, video, 3D model, and audio generation directly from within conversational client environments such as Claude Desktop or code editors like Cursor. By exposing deterministic tool calls mapped to the PiAPI platform, it provides access to external generative AI engines including Flux, Midjourney, Kling, Hunyuan, Skyreels, Wan, Luma Dream Machine, Suno, MMAudio, and Trellis. Users can configure prompts directly inside natural language chats to create pictures from text or image references, synthesize videos, generate zero-shot voice audio, construct 3D meshes from 2D images, and create music. The integration maintains an automated drift detection system backed by API contracts to synchronize newly added upstream models and capabilities into standardized tool schemas without requiring manual parameter rewriting.
Category: AI & LLM Tooling
Tags: audio-generation, flux, image generation, midjourney, video generation
bash npx -y @smithery/cli install piapi-mcp-server --client claude 2. Alternatively, clone the repository manually and install dependencies: bash git clone https://github.com/apinetwork/piapi-mcp-server cd piapi-mcp-server npm install npm run build 3. For Claude Desktop, edit claude_desktop_config.json and add the server configuration under mcpServers: json { "mcpServers": { "piapi": { "command": "node", "args": ["/absolute/path/to/piapi-mcp-server/dist/index.js"], "env": { "PIAPI_API_KEY": "your_api_key_here" } } } } 4. For Cursor, open Settings (Ctrl+Shift+J), select MCP, click "Add new global MCP server", and insert the same JSON block in mcp.json. Restart your client to apply changes.Part of MCP Servers
You can install the server automatically using Smithery by running the Smithery CLI command targeting Claude Desktop. Alternatively, clone the GitHub repository locally, run npm install followed by npm run build, and register the generated dist/index.js path alongside your PIAPI_API_KEY inside your MCP client configuration file.
The server enables MCP clients to execute media generation tasks through PiAPI. It supports generating images with Flux and Midjourney, videos with Kling, Luma, Wan, Skyreels, and Hunyuan, music and speech with Suno and MMAudio, and 3D models using Trellis.
PiAPI works with Claude Desktop and Cursor, as well as any other client or environment compliant with the Model Context Protocol that supports custom node command execution and environment variable configuration.
Yes, PiAPI MCP server is open-source software distributed under the MIT license, with source code hosted on GitHub.
Long-running generative tools like video generation can encounter timeouts in Claude Desktop because the generation process may exceed Claude's client-side request timeout limits before the remote task finishes processing.