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/Wanx/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 limitationsWorking with Claude Desktop Example#
Prerequisites#
Installation#
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.4.
(Optional) Test server with MCP Inspector:
.env file in the project root directory with your API key: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:Interactive Testing: Test your server's functions directly through a web interface
Real-time Feedback: See immediate results of your function calls and any errors that occur
Request/Response Inspection: View detailed information about requests and responses
Function Documentation: Browse available functions and their parameters
Custom Parameters: Set custom timeout values and other configuration options
History Tracking: Keep track of your previous function calls and their results
Usage#
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"
}
}
}
}
For more detailed information, visit the official MCP documentationConnecting to Cursor#
Note: Following guide is based on Cursor 0.47.5. Features and behaviors may vary in different versions.To configure the MCP server:1.
Navigate to: File > Preferences > Cursor Settings, or use the shortcut key Ctrl+Shift+J
2.
Select "MCP" tab on the left panel
3.
Click "Add new global MCP server" button in the top right
4.
Add your configuration in the opened mcp.json file
{
"mcpServers": {
"piapi": {
"command": "node",
"args": ["/absolute/path/to/piapi-mcp-server/dist/index.js"],
"env": {
"PIAPI_API_KEY": "your_api_key_here"
}
}
}
}
5.
After configuration, you'll see a "piapi" entry in MCP Servers page
6.
Click the Refresh button on the entry or restart Cursor to connect to the piapi server
1.
Open and select "Agent mode" in Cursor Chat, or use the shortcut key Ctrl+I
2.
Enter a test prompt, for example: "generate image of a dog"
3.
The image will be generated based on your prompt using piapi server
1.
Navigate to the MCP Servers page in Cursor Settings
2.
Find the "piapi" entry in the server list
3.
Click the "Enabled" toggle button to switch it to "Disabled"
Development#
Project Structure#
piapi-mcp-server/
├── assets/
├── src/
│ ├── index.ts # Main server entry point
├── package.json
├── tsconfig.json
└── .env.example
Modified at 2025-04-24 07:43:01
