piapi-mcp-服务器

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

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

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

• [x] 基础图像工具包

• [x] 基础视频工具包

• [x] 从文本/图像提示生成 Flux 图像

• [x] 根据文本/图像提示生成混元视频

• [x] 从图像提示生成 Skyreels 视频

• [x] 从文本/图像提示生成 Wan 视频

• [x] MMAudio 从视频生成音乐

• [x] TTS Zero-Shot 语音生成

• [ ] 旅途中图像生成

  • [x] 想象一下

  • [ ] 其他

• [x] Kling 视频和效果生成

• [x] Luma Dream Machine 视频生成

• [x] Suno 音乐世代

• [ ] Suno 歌词生成

• [ ] Udio 音乐和歌词生成

• [x] 从图像生成网格 3D 模型

• [ ] LLM 内部的工作流程规划

Related MCP server: erpnext-server

使用 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

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

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

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

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

PIAPI_API_KEY=your_api_key_here

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

npm run inspect

运行命令后，MCP Inspector 将在http://localhost:5173 （默认端口：5173）上可用。在浏览器中打开此 URL 即可开始测试。检查器操作的默认超时时间为 10000 毫秒（10 秒），对于图像生成任务来说，这可能不够用。在测试图像生成或其他耗时操作时，建议增加超时时间。您可以通过在 URL 中添加超时参数来调整超时时间，例如： 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 0.47.5。不同版本的功能和行为可能会有所不同。

要配置 MCP 服务器：

1. 导航至：文件 > 首选项 > 光标设置，或使用快捷键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. 导航至“光标设置”中的“MCP 服务器”页面

2. 在服务器列表中找到“piapi”条目

3. 单击“启用”切换按钮将其切换为“禁用”

发展

项目结构

piapi-mcp-server/
├── assets/
├── src/
│   ├── index.ts        # Main server entry point
├── package.json
├── tsconfig.json
└── .env.example

执照

麻省理工学院