README
🚀 运行RunPod MCP 服务器
此模型上下文协议(MCP)服务器使您能够通过Claude或其他与MCP兼容的客户端与RunPod REST API交互。
🚀 快速开始
此模型上下文协议(MCP)服务器可让您借助Claude或其他支持MCP的客户端,与RunPod REST API进行交互。下面将为您详细介绍如何安装、配置和运行该服务器。
✨ 主要特性
该服务器具备以下管理功能:
- _pod:可创建、列出、查看详细信息、更新、启动、停止和删除pod。
- 端点:能够创建、列出、查看详细信息、更新和删除无服务器端点。
- 模板:支持创建、列出、查看详细信息、更新和删除模板。
- 网络卷:可以创建、列出、查看详细信息、更新和删除网络卷。
- 容器注册表身份验证:可创建、列出、查看详细信息和删除身份验证。
📦 安装指南
先决条件
- Node.js 18 或更高版本。
- 拥有 RunPod 账户及 API 密钥。
- 安装 Claude for Desktop 或其他与 MCP 兼容的客户端。
使用 Smithery 安装
通过 Smithery 可自动为 Claude Desktop 安装 runpod-mcp-ts:
npx -y @smithery/cli install @runpod/runpod-mcp-ts --client claude
手动安装方法
- 克隆仓库。
- 安装依赖项:
npm install - 构建服务器:
npm run build
📚 详细文档
配置
需将 RunPod API 密钥设置为环境变量:
# Linux/macOS
export RUNPOD_API_KEY=your_api_key_here
# Windows (Command Prompt)
set RUNPOD_API_KEY=your_api_key_here
# Windows (PowerShell)
$env:RUNPOD_API_KEY="your_api_key_here"
您可在 RunPod 控制台 获取 API 密钥。
运行服务器
启动服务器:
npm start
与 Claude Desktop 配置结合使用
- 打开 Claude for Desktop。
- 编辑配置文件:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
- 添加服务器配置:
{
"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"] 替换为仓库中构建文件夹的实际路径。
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
创建无服务器端点
创建一个具有以下规格的新的RunPod无服务器端点:
- 名称:my-serverless-endpoint
- 端口:3000
📄 许可证
文档未提及相关内容,暂不展示。
🔧 技术细节
文档未提及相关内容,暂不展示。
⚠️ 重要提示
不要共享 API 密钥,始终确保您的 RunPod API 密钥安全,避免将其共享给未经授权的人。
💡 使用建议
- 根据需要为不同的应用程序或服务分配适当的权限级别,以最小化潜在的安全风险。
- 定期更改您的 API 密钥,特别是在怀疑发生安全事件时。
Scan to join WeChat group