RunPod MCP 服务器

此模型上下文协议 (MCP) 服务器使您能够通过 Claude 或其他 MCP 兼容的客户端与 RunPod REST API 进行交互。

功能

该服务器提供用于管理以下内容的工具：

• Pod: 创建、列出、获取详细信息、更新、启动、停止和删除 Pod
• Endpoint: 创建、列出、获取详细信息、更新和删除无服务器 Endpoint
• 模板: 创建、列出、获取详细信息、更新和删除模板
• 网络卷: 创建、列出、获取详细信息、更新和删除网络卷
• 容器注册表身份验证: 创建、列出、获取详细信息和删除身份验证

设置

前提条件

• Node.js 18 或更高版本
• 一个 RunPod 帐户和 API 密钥
• Claude for Desktop 或另一个 MCP 兼容的客户端

安装

1. 克隆存储库
2. 安装依赖项：

   npm install
   

3. 构建服务器：

   npm run build
   

配置

将您的 RunPod API 密钥设置为环境变量：

# Linux/macOS
export RUNPOD_API_KEY=your_api_key_here

# Windows (命令提示符)
set RUNPOD_API_KEY=your_api_key_here

# Windows (PowerShell)
$env:RUNPOD_API_KEY="your_api_key_here"

您可以从 RunPod 控制台 获取您的 API 密钥。

运行服务器

启动服务器：

npm start

使用 Claude for Desktop 进行设置

1. 打开 Claude for Desktop
2. 编辑配置文件：~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows)
3. 添加服务器配置：

{
  "mcpServers": {
    "runpod": {
      "command": "node",
      "args": ["/path/to/runpod-mcp-server/build/index.js"],
      "env": {
        "RUNPOD_API_KEY": "your_api_key_here"
      }
    }
  }
}

请确保将 "args": ["/path/to/runpod-mcp-server/build/index.js"] 替换为存储库中 build 文件夹的路径。

4. 重启 Claude for Desktop

使用示例

以下是一些如何将服务器与 Claude 一起使用的示例：

列出所有 Pod

你能列出我所有的 RunPod Pod 吗？

创建一个新的 Pod

创建一个具有以下规格的新 RunPod Pod：
- 名称：test-pod
- 镜像：runpod/pytorch:2.1.0-py3.10-cuda11.8.0-devel-ubuntu22.04
- GPU 类型：NVIDIA GeForce RTX 4090
- GPU 数量：1

创建一个无服务器 Endpoint

创建一个具有以下配置的 RunPod 无服务器 Endpoint：
- 名称：my-endpoint
- 模板 ID：30zmvf89kd
- 最小工作节点：0
- 最大工作节点：3

安全注意事项

此服务器需要您的 RunPod API 密钥，该密钥授予对您的 RunPod 帐户的完全访问权限。 为了安全起见：

• 永远不要分享您的 API 密钥
• 谨慎对待您执行的操作
• 考虑设置一个具有有限权限的单独 API 密钥
• 在没有适当安全措施的情况下，请勿在生产环境中使用它

许可证

MIT