piapi-mcp-server
一个TypeScript实现的模型上下文协议（MCP）服务器，与PiAPI API集成。PiAPI让用户可以直接从Claude或其他任何兼容MCP的应用中生成媒体内容，支持Midjourney/Flux/Kling/LumaLabs/Udio/Chrip/Trellis等模型。
功能（更多即将推出）
注意：由于Claude的超时限制，视频生成等耗时工具可能无法完成
- 基础图片工具箱
- 基础视频工具箱
- 从文本/图片提示生成Flux图片
- 从文本/图片提示生成Hunyuan视频
- 从图片提示生成Skyreels视频
- 从文本/图片提示生成Wan视频
- 从视频生成MMAudio音乐
- TTS零样本语音生成
- Midjourney图片生成
- imagine
- 其他
- Kling视频和特效生成
- Luma Dream Machine视频生成
- Suno音乐生成
- Suno歌词生成
- Udio音乐和歌词生成
- 从图片生成Trellis 3D模型
- 在LLMs内部进行工作流规划
与Claude桌面示例配合使用
前置条件
- Node.js 16.x或更高版本
- npm或yarn
- 一个PiAPI API密钥（在piapi.ai处获取）
安装
通过Smithery安装
要自动通过Smithery为Claude桌面安装PiAPI MCP服务器：
npx -y @smithery/cli install piapi-mcp-server --client claude
手动安装
- 克隆仓库：
git clone https://github.com/apinetwork/piapi-mcp-server
cd piapi-mcp-server
- 安装依赖：
npm install
- 构建项目：
npm run build
构建后，将生成dist/index.js文件。然后可以将其配置到Claude桌面和其他应用程序中。有关详细的配置说明，请参阅使用部分。
- （可选）使用MCP Inspector测试服务器：
首先，在项目根目录中创建一个.env文件并添加您的API密钥：
PIAPI_API_KEY=your_api_key_here
然后运行以下命令启动MCP Inspector：
npm run inspect
MCP Inspector是一个强大的开发工具，帮助您测试和调试MCP服务器实现。主要功能包括：
- 交互式测试：通过网页界面直接测试服务器功能
- 实时反馈：立即查看函数调用的结果和任何错误
- 请求/响应检查：查看请求和响应的详细信息
- 函数文档：浏览可用函数及其参数
- 自定义参数：设置自定义超时值和其他配置选项
- 历史记录：跟踪您之前的函数调用及其结果
有关使用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": ["/绝对路径/to/piapi-mcp-server/dist/index.js"],
"env": {
"PIAPI_API_KEY": "your_api_key_here"
}
}
}
}
更新配置文件后，需要重启Claude桌面。重启后，您应该在输入框右下角看到一个锤子图标。 有关更多详细信息，请访问官方MCP文档
连接到Cursor
注意：以下指南基于Cursor 0.47.5版本。不同版本的功能和行为可能会有所不同。
要配置MCP服务器：
- 导航到：文件 > 首选项 > Cursor设置，或使用快捷键
Ctrl+Shift+J - 在左侧面板选择"MCP"选项卡
- 点击右上角的"添加新的全局MCP服务器"按钮
- 在打开的
mcp.json文件中添加您的配置
{
"mcpServers": {
"piapi": {
"command": "node",
"args": ["/绝对路径/to/piapi-mcp-server/dist/index.js"],
"env": {
"PIAPI_API_KEY": "your_api_key_here"
}
}
}
}
- 配置后，您将在MCP服务器页面看到"piapi"条目
- 点击条目上的刷新按钮或重启Cursor以连接到piapi服务器
要测试piapi图片生成：
- 打开Cursor Chat并选择"代理模式"，或使用快捷键
Ctrl+I - 输入测试提示，例如："生成一只狗的图片"
- 图片将根据您的提示使用piapi服务器生成
要禁用piapi服务器：
- 导航到Cursor设置中的MCP服务器页面
- 在服务器列表中找到"piapi"条目
- 点击"启用"切换按钮将其切换为"禁用"
开发
项目结构
piapi-mcp-server/
├── assets/
├── src/
│ ├── index.ts # 主服务器入口
├── package.json
├── tsconfig.json
└── .env.example
许可证
MIT