AgentMatter
EN/中文
提交项目GitHub
MCP 服务器 · 官方实现

Runpod MCP server

Runpod MCP server 是 Runpod 官方维护的控制面 MCP 服务器，让 Agent 通过托管 HTTP 或本地 stdio 管理 Pods、Serverless endpoints、模板、网络卷与相关云资源。

79 StarsApache-2.0TypeScript1 天前更新
安装与使用 GitHub
01

项目介绍

Runpod MCP server 是 Runpod 官方维护的云资源控制 MCP 服务器。它把 Pods、Serverless endpoints、模板、网络卷、GPU 容量与相关账户操作暴露给支持 MCP 的 Agent，可选择托管 HTTP 加 OAuth，或在本地通过 npx 与 stdio 运行。它适合希望在对话中检查和操作 Runpod 控制面的团队，但服务器按凭据的完整权限执行，任何创建、更新、删除或可能产生成本的动作都应保留人工确认。

02

核心功能

01

Pods 与 GPU 容量

工具覆盖 Pod 生命周期、GPU 类型与可用性查询，可用于先检查容量，再由用户批准资源创建或变更。

02

Serverless endpoints 与作业

可管理 endpoints、发布版本和构建，并提交同步、异步或流式作业；配置文档提醒大输出可能超过上下文窗口。

03

模板、卷与镜像访问

支持模板、网络卷、注册表以及 AWS ECR 委派。对于 ECR，文档优先推荐不保存长期凭据的委派方式。

04

托管与本地双模式

托管端使用 HTTP 和 OAuth，本地端使用 stdio 与 RUNPOD_API_KEY；两者共享核心控制工具。

05

任务 playbook 与托管 ALP

两种模式均提供 10 个 runpod://skills/ 资源；仅托管端加入反馈、私有 journal 与问题收集工具。

03

安装与连接

优先从引导式安装器开始，明确目标客户端和配置作用域，再在托管 OAuth 与本地 API Key 之间选择。安装后只做只读检查，确认账户或团队正确，再逐项开放会产生成本或破坏性变更的工具。

AI AGENT INSTALL

让 AI Agent 帮你安装

把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。

请帮我安装 Runpod MCP server，项目地址是 https://github.com/runpod/runpod-mcp。先读取 README.md、docs/configuration.md、docs/agent-learning-protocol.md、LICENSE 和 v4.0.0 Release，并说明仓库没有独立 SECURITY.md。检查 Node.js 是否至少为 20，再询问我要使用托管 OAuth 还是本地 API Key，以及配置写入用户级还是项目级。不要在输出、日志或对话里展示 API Key，不要未经确认覆盖现有 MCP 配置。若选择托管模式，提醒我先在浏览器中切换到正确的 Runpod 账户或团队，并说明匿名分析及 `X-Runpod-Analytics: off`。若选择本地模式，先确认客户端会把 RUNPOD_API_KEY 保存在哪里。完成配置后只运行 MCP 连接检查和只读的 Pod 列表查询；创建、更新、扩缩容、执行作业或删除任何资源前都必须再次向我确认。
01开始前准备
  • Node.js 20 或更高版本
  • Runpod 账户
  • 本地模式需要 Runpod API Key
  • 支持 HTTP/OAuth 或 stdio 的 MCP 客户端
  • 对客户端配置写入和云资源操作的审批
02复制安装命令或配置
npx @runpod/mcp-server@latest add
03按步骤完成安装
  1. 1
    检查运行环境与目标客户端

    确认 Node.js 20+，记录要修改的 MCP 客户端和用户级或项目级作用域，并备份现有配置。

  2. 2
    选择托管或本地模式

    希望减少本地密钥落盘时选择托管 OAuth；需要本地 stdio 或不发送托管分析时选择本地 API Key。

  3. 3
    运行引导安装或精确命令

    可运行 `npx @runpod/mcp-server@latest add`，也可按 README 为 Claude Code 添加托管 HTTP 或本地 stdio 配置。

  4. 4
    验证连接和身份

    先检查 MCP 服务器列表，再只读列出 Pods，核对结果属于预期账户或团队；身份不对时切换 profile 并重新授权。

  5. 5
    建立资源操作审批线

    把查询与变更分开。创建 Pod、更新 endpoint、运行可能产生成本的作业或删除资源时，先展示参数和预估影响并等待确认。

如何确认安装成功

安装后先运行客户端的 MCP 列表命令；Claude Code 可用 `claude mcp list`。随后只请求列出当前 Pods，并核对返回资源是否属于预期账户或团队。不要把创建、更新、运行作业或删除资源当作首次验证。

使用前注意
  • 引导式安装命令是 `npx @runpod/mcp-server@latest add`，卸载命令是 `npx @runpod/mcp-server@latest remove`。
  • Claude Code 托管命令是 `claude mcp add --transport http runpod -s user https://mcp.getrunpod.io/`。
  • 如需项目级 Claude 配置，把 README 示例中的 `-s user` 改为 `-s project`。
  • 托管 OAuth 使用批准时浏览器当前所选的 Runpod profile；切换后需要重新授权。
04

使用场景

SCENARIO 01

GPU 容量与 Pod 盘点

让 Agent 汇总当前 Pods、GPU 类型、区域和可用性，为人工选择部署位置提供依据。

SCENARIO 02

Serverless 发布与作业操作

检查 endpoints、版本和构建，按批准参数提交作业，并把过大的输出写入文件或对象存储。

SCENARIO 03

模板与网络卷管理

查询和整理模板、网络卷与镜像访问配置，在变更前生成可审阅的计划。

SCENARIO 04

Runpod 运维 playbook

读取 runpod://skills/ 下的任务资源，为部署、排障和资源管理提供官方步骤上下文。

05

使用评价

从公开仓库看，Runpod MCP server 的优势是官方身份、托管与本地两种接入方式、覆盖完整控制面的生成式工具集，以及把大输出、身份选择和分析数据写进文档。主要代价同样清晰：凭据拥有完整权限，工具可创建付费资源，v4 移除了旧版接口，托管端还有本地端没有的数据收集功能。本评估来自 README、配置与 ALP 文档、Release、源码结构和测试目录，不包含实际账户连接或长期使用结论。

值得一试的地方

  • Runpod 官方维护，工具与 REST v2 规格同步
  • 托管 OAuth 和本地 stdio 两种部署路径均有精确命令
  • 权限、团队 profile、匿名分析与大输出边界有公开说明
  • Apache-2.0 许可证、Release、变更记录与测试目录可审查

使用前要知道

  • API Key 权限直接决定 Agent 可执行的全部操作范围
  • v4 与旧版工具命名和 v1 接口不兼容
  • ALP 仅托管端提供，且 ask_question 不会返回答案
  • 本次没有完成安装或功能实测
06

README

Runpod MCP server

Overview

Runpod MCP server 是 Runpod 官方维护的控制面 MCP 服务器，让 Agent 通过托管 HTTP 或本地 stdio 管理 Pods、Serverless endpoints、模板、网络卷与相关云资源。 用于与 Runpod API 交互的官方 MCP 服务器。

Getting started

  • 优先从引导式安装器开始，明确目标客户端和配置作用域，再在托管 OAuth 与本地 API Key 之间选择。安装后只做只读检查，确认账户或团队正确，再逐项开放会产生成本或破坏性变更的工具。
  • 引导式安装器可检测多个 MCP 客户端，让用户选择托管或本地模式；同一命令也提供 remove 流程。
  • 托管模式通过 OAuth 获取当前浏览器所选 Runpod 账户或团队 profile 的会话 Key，README 表示该 Key 不写入本地磁盘。
  • 安装后先运行客户端的 MCP 列表命令；Claude Code 可用 `claude mcp list`。随后只请求列出当前 Pods，并核对返回资源是否属于预期账户或团队。不要把创建、更新、运行作业或删除资源当作首次验证。

Configuration

npx @runpod/mcp-server@latest add
在 GitHub 阅读完整 README →