piapi-mcp-server

一个 TypeScript 实现的模型上下文协议 (MCP) 服务器，与 PiAPI 的 API 集成。PiAPI 使用户能够直接从 Claude 或任何其他 MCP 兼容的应用程序生成 Midjourney/Flux/Kling/LumaLabs/Udio/Chrip/Trellis 的媒体内容。

<a href="https://glama.ai/mcp/servers/ywvke8xruo"><img width="380" height="200" src="https://glama.ai/mcp/servers/ywvke8xruo/badge" alt="PiAPI-Server MCP server" /></a>

功能 (更多功能即将推出)

注意：由于 Claude 的超时限制，视频生成等耗时工具可能无法完成

• [x] 基础图像工具包
• [x] 基础视频工具包
• [x] 通过文本/图像提示生成 Flux 图像
• [x] 通过文本/图像提示生成 混元 视频
• [x] 通过图像提示生成 Skyreels 视频
• [x] 通过文本/图像提示生成 Wan 视频
• [x] MMAudio 通过视频生成音乐
• [x] TTS 零样本语音生成
• [ ] Midjourney 图像生成
  • [x] imagine
  • [ ] 其他
• [x] Kling 视频和特效生成
• [x] Luma Dream Machine 视频生成
• [x] Suno 音乐生成
• [ ] Suno 歌词生成
• [ ] Udio 音乐和歌词生成
• [x] Trellis 通过图像生成 3D 模型
• [ ] LLM 内部的工作流程规划

与 Claude Desktop 配合使用的示例

前提条件

• Node.js 16.x 或更高版本
• npm 或 yarn
• 一个 PiAPI API 密钥 (在 piapi.ai 获取)

安装

1. 克隆存储库:

git clone https://github.com/apinetwork/piapi-mcp-server
cd piapi-mcp-server

2. 安装依赖:

npm install

3. 构建项目:

npm run build

构建完成后，将生成一个 dist/index.js 文件。 然后，您可以将此文件配置到 Claude Desktop 和其他应用程序中。 有关详细的配置说明，请参阅“用法”部分。

4. (可选) 使用 MCP Inspector 测试服务器:

首先，在项目根目录中创建一个 .env 文件，其中包含您的 API 密钥：

PIAPI_API_KEY=your_api_key_here

然后运行以下命令来启动 MCP Inspector：

npm run inspect

运行命令后，MCP Inspector 将在 http://localhost:5173 上可用（默认端口：5173）。 在浏览器中打开此 URL 以开始测试。 Inspector 操作的默认超时时间为 10000 毫秒（10 秒），这可能不足以完成图像生成任务。 建议在测试图像生成或其他耗时操作时增加超时时间。 您可以通过向 URL 添加 timeout 参数来调整超时时间，例如：http://localhost:5173?timeout=60000（将超时时间设置为 60 秒）

MCP Inspector 是一个强大的开发工具，可帮助您测试和调试 MCP 服务器实现。 主要功能包括：

• 交互式测试：通过 Web 界面直接测试服务器的功能
• 实时反馈：查看函数调用的即时结果以及发生的任何错误
• 请求/响应检查：查看有关请求和响应的详细信息
• 功能文档：浏览可用功能及其参数
• 自定义参数：设置自定义超时值和其他配置选项
• 历史记录跟踪：跟踪您之前的函数调用及其结果

有关使用 MCP Inspector 及其功能的详细信息，请访问 官方 MCP 文档。

用法

连接到 Claude Desktop

将其添加到您的 Claude Desktop 配置文件中 (~/Library/Application Support/Claude/claude_desktop_config.json 在 macOS 上或 %APPDATA%\Claude\claude_desktop_config.json 在 Windows 上):

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

更新配置文件后，您需要重新启动 Claude for Desktop。 重新启动后，您应该在输入框的右下角看到一个锤子图标。 有关更多详细信息，请访问 官方 MCP 文档

连接到 Cursor

注意：以下指南基于 Cursor 0.47.5。 功能和行为可能因版本而异。

要配置 MCP 服务器：

1. 导航到：文件 > 首选项 > Cursor 设置，或使用快捷键 Ctrl+Shift+J
2. 选择左侧面板上的“MCP”选项卡
3. 单击右上角的“添加新的全局 MCP 服务器”按钮
4. 在打开的 mcp.json 文件中添加您的配置

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

5. 配置完成后，您将在 MCP 服务器页面中看到一个“piapi”条目
6. 单击条目上的“刷新”按钮或重新启动 Cursor 以连接到 piapi 服务器

要测试 piapi 图像生成：

1. 在 Cursor Chat 中打开并选择“代理模式”，或使用快捷键 Ctrl+I
2. 输入一个测试提示，例如：“生成一只狗的图像”
3. 将根据您的提示使用 piapi 服务器生成图像

要禁用 piapi 服务器：

1. 导航到 Cursor 设置中的 MCP 服务器页面
2. 在服务器列表中找到“piapi”条目
3. 单击“已启用”切换按钮将其切换为“已禁用”

开发

项目结构

piapi-mcp-server/
├── assets/
├── src/
│   ├── index.ts        # 主服务器入口点
├── package.json
├── tsconfig.json
└── .env.example

许可证

MIT