← 返回目录

PiAPI MCP Server

社区

通过 MCP 在 Claude 或任何兼容应用中直接生成媒体内容

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 165 / 230
Stars: ★ 75 热门
传输方式: stdio（本地进程）
运行环境: Node.js 16+
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 2 个月前
工具数: 6

48FMRS · D

该服务器通过 MCP 集成了 PiAPI 的多种媒体生成能力，功能丰富，但存在超时风险和第三方服务依赖。适合对生成速度要求不高的用户。

最强项 · 文档质量 12/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

8/20

维护活跃度

10/20

文档质量

12/20

安装易用性

10/20

查看各项评分依据

可靠性 8/20: 源码中包含了明确的构建流程（npm run build）和测试命令（npm run test:sync），且提供了MCP Inspector的测试指引，说明基础可运行性。但未提供完整的CI集成证据（工作流仅手动触发），且部分工具（如视频生成）受超时限制，可能影响可靠性。因此评分8分。
安全与权限 8/20: API密钥通过环境变量传入，未硬编码；文档明确要求不提交真实密钥。但缺乏对密钥泄露的自动化检测，且服务端有外部网络请求，需用户授权。未发现恶意行为，但权限管理细节未明确，故评分8分。
维护活跃度 10/20: 仓库活跃（73星），未归档，有明确的MIT许可证。但未看到版本发布记录或依赖更新策略，问题响应速度未知。存在同步工作流，但未自动运行，维护活跃度中等偏上，评分10分。
文档质量 12/20: README提供了安装、配置、使用示例（Claude Desktop和Cursor），并说明了工具列表和测试方法。但缺少成本说明、故障排查指南和详细的参数文档，文档质量中等，评分12分。
安装易用性 10/20: 提供了手动安装和Smithery一键安装两种方式，步骤清晰。但要求Node.js 16+且需编译，配置客户端时需要手动指定路径，有一定复杂度。静态证据显示CLI可生成dist/index.js，但未提供可验证的CI构建，评分10分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要快速生成多种类型媒体的创意工作者
希望将媒体生成集成到自动化工作流中的开发者
使用 Claude Desktop 或 Cursor 并需要媒体生成功能的用户

不适合谁

需要快速生成多种类型媒体的创意工作者
希望将媒体生成集成到自动化工作流中的开发者
使用 Claude Desktop 或 Cursor 并需要媒体生成功能的用户

所需权限

需要有效的 PiAPI API 密钥
发送请求到 PiAPI 的远程服务器
可能需要在本地编译 TypeScript 项目

风险与副作用

媒体生成可能耗时较长，可能超出某些客户端的超时限制
不要与其他人共享 API 密钥，以防滥用
PiAPI 服务可能无法保证可用性或稳定性

安装接入

准备工作

运行环境：Node.js 16+

PIAPI_API_KEY 必填密钥 PiAPI 平台的 API 密钥，需在 piapi.ai/workspace/key 获取，用于调用媒体生成服务。

克隆仓库，安装依赖，构建项目，配置 Claude Desktop 或 Cursor 的 MCP 设置，设置环境变量 PIAPI_API_KEY 为你的 PiAPI API 密钥。

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"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.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"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

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

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

重启客户端后，在工具列表中应看到以 piapi_ 开头的工具（如 piapi_midjourney_imagine）；输入"用 Flux 生成一张狗的图片"能返回生成的图片即证明连接成功。

常见排障

确保 Node.js 版本为 16.x 或更高
检查 API 密钥是否设置正确
如果生成超时，考虑使用 MCP Inspector 并增加超时时间
检查日志是否有编译错误

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 Flux 生成一张狗的图片
用 Midjourney imagine 生成一幅赛博朋克城市夜景
用 Kling 生成一段海浪拍打礁石的视频
用 Trellis 从这张图片生成一个 3D 模型

工具能力 6

piapi_qubico_flux1_schnell_txt2img 写入

使用 Flux 快速文本生成图像

piapi_midjourney_imagine 写入

使用 Midjourney 生成图像

piapi_kling_video_generation 写入

使用 Kling 生成视频和特效

piapi_luma_dream_machine 写入

使用 Luma 生成视频

piapi_suno_music_generation 写入

使用 Suno 生成音乐

piapi_trellis_3d_model 写入

使用 Trellis 从图像生成 3D 模型

使用场景

在对话中直接生成图像、视频、音乐等媒体内容

为创意工作流快速生成视觉素材

生成 3D 模型用于设计或游戏开发

支持客户端

Claude Desktop

Cursor

依据项目文档列出，未经本站实测。

详细介绍

PiAPI MCP 服务器是一个 TypeScript 实现的模型上下文协议服务器，集成 PiAPI 的 API，让用户能够直接在 Claude 或其他支持 MCP 的应用中，使用 Midjourney、Flux、Kling、Luma、Udio、Suno 和 Trellis 等生成图像、视频、音乐和 3D 模型。