piapi-mcp-server

这是一个用 TypeScript 实现的 Model Context Protocol (MCP) 服务器，可以与 PiAPI 的 API 集成。PiAPI 使用户能够通过 Claude 或其他任何支持 MCP 的应用程序直接使用 Midjourney/Flux/Kling/LumaLabs/Udio/Chrip/Trellis 生成媒体内容。

功能（更多功能即将推出）

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

• 基础图片工具包
• 基础视频工具包
• 从文本/图片提示生成 Flux 图片
• 从文本/图片提示生成 Hunyuan 视频
• 从图片提示生成 Skyreels 视频
• 从文本/图片提示生成 Wan 视频
• 从视频生成 MMAudio 音乐
• TTS Zero-Shot 语音生成
• Midjourney 图片生成
  • imagine
  • 其他
• Kling 视频和特效生成
• Luma Dream Machine 视频生成
• Suno 音乐生成
• Suno 歌词生成
• Udio 音乐和歌词生成
• 从图片生成 Trellis 3D 模型
• 在 LLM 中的工作流规划

与 Claude 桌面版配合使用的示例

前提条件

• Node.js 16.x 或更高版本
• npm 或 yarn
• PiAPI API 密钥（在 piapi.ai 获取）

安装

1. 克隆仓库：

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

1. 安装依赖项：

npm install

1. 构建项目：

npm run build

构建完成后，会生成一个 dist/index.js 文件。然后你可以使用 Claude Desktop 和其他应用程序来配置这个文件。有关详细配置说明，请参阅“使用”部分。

1. （可选）使用 MCP Inspector 测试服务器：

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

PIAPI_API_KEY=your_api_key_here

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

npm run inspect

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

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

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

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

使用方法

连接到 Claude Desktop

将以下内容添加到您的 Claude Desktop 配置文件中（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 上为 %APPDATA%\Claude\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 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"
      }
    }
  }
}

1. 配置完成后，您将在 MCP 服务器页面看到一个 "piapi" 条目
2. 单击条目上的刷新按钮或重启 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        # Main server entry point
├── package.json
├── tsconfig.json
└── .env.example

许可证

MIT