M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
P

PiAPI MCP Server

Community
Generate media content directly from Claude or any MCP-compatible app
How to install ↓ Compare GitHub source repository ↗
Category
Other #165 of 230
Stars
★ 75 Popular
Transport
stdio (local process)
Runtime
Node.js 16+
Credentials
API key / credential required
License
MIT
Last commit
Tools
6
48FMRS · D

This server integrates multiple media generation capabilities via MCP, offering a rich feature set but with potential timeout issues and reliance on a third-party service. It is suitable for users who do not require real-time generation.

Strongest · Documentation 12/20 Weakest · Reliability 8/20

Reliability
8/20
Security and permissions
8/20
Maintenance
10/20
Documentation
12/20
Setup experience
10/20
Why each score
Reliability 8/20
The source includes explicit build (npm run build) and test (npm run test:sync) commands, and references the MCP Inspector for testing, indicating basic runnability. However, no full CI evidence is present (workflow is manual), and some tools (e.g., video generation) may be subject to timeout limitations, potentially affecting reliability. Score 8.
Security and permissions 8/20
API key is passed via environment variables, not hardcoded; documentation advises not to commit real keys. However, there is no automated detection for key leakage, and the server makes external network requests. No malicious behavior spotted, but permission details are not clear. Score 8.
Maintenance 10/20
Repo is active (73 stars), not archived, with a clear MIT license. However, no release history or dependency update strategy is visible, and issue response time is unknown. A sync workflow exists but is not automated, indicating moderate-high maintenance activity. Score 10.
Documentation 12/20
README offers installation, configuration, and usage examples for Claude Desktop and Cursor, and lists tools and testing methods. It lacks cost explanations, troubleshooting guide, and detailed parameter docs. Score 12.
Setup experience 10/20
Provides both manual and Smithery one-click installation, with clear steps. However, requires Node.js 16+ and compilation, and client configuration needs manual path specification, adding complexity. Static evidence shows CLI can generate dist/index.js, but no verifiable CI build, score 10.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

Best for

  • Creative professionals who need to generate various media quickly
  • Developers who want to integrate media generation into automated workflows
  • Users of Claude Desktop or Cursor who need media generation capabilities

Not for

  • Users who require instant results due to potential timeouts
  • Those needing a solution with a stable, guaranteed third-party service

Required permissions

  • Requires a valid PiAPI API key
  • Sends requests to PiAPI remote servers
  • May require local TypeScript compilation

Risks and side effects

  • Media generation can be time-consuming and may exceed client timeouts
  • Sharing your API key with others may lead to misuse
  • Dependence on PiAPI service availability and reliability

Setup

Before you start

Runtime：Node.js 16+

PIAPI_API_KEY requiredsecret API key for PiAPI, obtained at piapi.ai/workspace/key, required to call the media generation services.

Clone the repository, install dependencies, build the project, configure MCP settings in Claude Desktop or Cursor, and set the PIAPI_API_KEY environment variable to your PiAPI API key.

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

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

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

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add piapi -e PIAPI_API_KEY=your_api_key_here -- node /absolute/path/to/piapi-mcp-server/dist/index.js

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After restarting the client, piapi_ prefixed tools (e.g. piapi_midjourney_imagine) should appear in the tool list; a prompt like "generate image of a dog" returning a generated image confirms the connection.

Troubleshooting

  1. Ensure Node.js version is 16.x or higher
  2. Check that the API key is correctly set
  3. If generation times out, consider using MCP Inspector with increased timeout
  4. Check logs for compilation errors

Things to try

Once connected, you can ask your AI assistant things like:

  • Generate an image of a dog using Flux
  • Use Midjourney imagine to create a cyberpunk city at night
  • Generate a video of waves crashing on rocks with Kling
  • Create a 3D model from this image using Trellis

Tools 6

piapi_qubico_flux1_schnell_txt2img writes
Generate images from text quickly using Flux
piapi_midjourney_imagine writes
Generate images using Midjourney
piapi_kling_video_generation writes
Generate videos and effects using Kling
piapi_luma_dream_machine writes
Generate videos using Luma
piapi_suno_music_generation writes
Generate music using Suno
piapi_trellis_3d_model writes
Generate 3D models from images using Trellis

Use cases

Generate images, videos, music, and other media directly in conversations
Quickly generate visual assets for creative workflows
Generate 3D models for design or game development

Supported clients

Claude Desktop
Cursor

Listed from the project's documentation, not tested by this site.

Overview

PiAPI MCP Server is a TypeScript implementation of an MCP server that integrates with PiAPI's API, enabling users to generate images, videos, music, and 3D models using models like Midjourney, Flux, Kling, Luma, Udio, Suno, and Trellis directly from Claude or other MCP-compatible applications.

Similar servers

BioMCP 75 · B

One binary. One grammar. Evidence from the biomedical sources you already trust.

★ 659 · Tools 11 Compare with this →
Compare with other MCP servers

Source revision 86240f5a1b9c Data synced 2026-10-19 Read the FMRS scoring method