piapi-mcp-server

这是一个与PiAPI API集成的Model Context Protocol (MCP)服务器的TypeScript实现。通过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://gips3.baidu.com/it/u=1127884888,2738184241&fm=3081&app=3081&f=PNG?w=760&h=400" alt="PiAPI-Server MCP服务器" /></a>

特性（更多即将推出）

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

• 基础图像工具包
• 基础视频工具包
• 根据文本/图像提示生成Flux图像
• 根据文本/图像提示生成Hunyuan视频
• 根据图像提示生成Skyreels视频
• 根据文本/图像提示生成Wan视频
• 从视频中生成MMAudio音乐
• 零样本语音生成TTS
• Midjourney图像生成
  • 想象
  • 其他
• 生成Kling视频和效果
• 生成Luma Dream Machine视频
• 生成Suno音乐
• 生成Suno歌词
• 生成Udio音乐和歌词
• 从图像生成Trellis 3D模型
• 在LLMs内规划工作流程

使用Claude桌面示例

先决条件

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

安装

通过Smithery安装

要通过Smithery自动安装PiAPI MCP服务器：

npx -y @smithery/cli install piapi-mcp-server --client claude

手动安装

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桌面和其他应用程序中。有关详细配置说明，请参阅使用部分。

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添加超时参数来调整超时时间，例如：http://localhost:5173?timeout=60000（设置超时时间为60秒）

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

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

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

使用

连接到Claude桌面

将以下内容添加到您的Claude桌面配置文件中（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桌面。重启后，您应在输入框右下角看到锤子图标。 更多详细信息，请访问官方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聊天中的“代理模式”，或使用快捷键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