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)Note: Time-consuming tools like video generation may not complete due to Claude's timeout limitations
To install PiAPI MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install piapi-mcp-server --client claude
git clone https://github.com/apinetwork/piapi-mcp-server cd piapi-mcp-server
After building, a dist/index.js
file will be generated. You can then configure this file with Claude Desktop and other applications. For detailed configuration instructions, please refer to the Usage section.
First, create a .env
file in the project root directory with your API key:
PIAPI_API_KEY=your_api_key_here
Then run the following command to start the MCP Inspector:
After running the command, MCP Inspector will be available at http://localhost:5173 (default port: 5173). Open this URL in your browser to start testing. The default timeout for inspector operations is 10000ms (10 seconds), which may not be sufficient for image generation tasks. It's recommended to increase the timeout when testing image generation or other time-consuming operations. You can adjust the timeout by adding a timeout parameter to the URL, for example: http://localhost:5173?timeout=60000 (sets timeout to 60 seconds)
The MCP Inspector is a powerful development tool that helps you test and debug your MCP server implementation. Key features include:
For detailed information about using the MCP Inspector and its features, visit the official MCP documentation.
Connecting to Claude DesktopAdd 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" } } } }
After updating your configuration file, you need to restart Claude for Desktop. Upon restarting, you should see a hammer icon in the bottom right corner of the input box. For more detailed information, visit the official MCP documentation
Note: Following guide is based on Cursor 0.47.5. Features and behaviors may vary in different versions.
To configure the MCP server:
Ctrl+Shift+J
{ "mcpServers": { "piapi": { "command": "node", "args": ["/absolute/path/to/piapi-mcp-server/dist/index.js"], "env": { "PIAPI_API_KEY": "your_api_key_here" } } } }
To test the piapi image generation:
Ctrl+I
To disable the piapi server:
piapi-mcp-server/
├── assets/
├── src/
│ ├── index.ts # Main server entry point
├── package.json
├── tsconfig.json
└── .env.example
MIT
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4