Servidor MCP de Runpod

Este servidor del Protocolo de Contexto de Modelo (MCP) le permite gestionar la infraestructura de Runpod a través de cualquier cliente compatible con MCP. Proporciona herramientas para trabajar con Pods, endpoints Serverless, plantillas, volúmenes de red y autenticaciones de registro de contenedores.

Inicio rápido

Requisitos

• Node.js 18 o superior.

• Una cuenta de Runpod y una clave API (obtenga su clave API).

Ejecución con npx

Puede ejecutar el servidor directamente sin instalación:

RUNPOD_API_KEY=YOUR_API_KEY npx @runpod/mcp-server@latest

Instalación a través de Smithery

Para instalar automáticamente en Claude Desktop a través de Smithery:

npx -y @smithery/cli install @runpod/runpod-mcp-ts --client claude

Related MCP server: Quickbase MCP Server

Configuración con su cliente

La mayoría de los clientes MCP utilizan un archivo de configuración JSON con la misma estructura general. Los ejemplos a continuación muestran el enfoque con npx (recomendado para la mayoría de los usuarios) y el enfoque de compilación local (para desarrollo). Reemplace YOUR_API_KEY con su clave API real de Runpod.

Claude Code

Añada el servidor MCP globalmente para que esté disponible en todos sus proyectos:

claude mcp add runpod -s user \
  -e RUNPOD_API_KEY=YOUR_API_KEY \
  -- npx -y @runpod/mcp-server@latest

O añádalo a un proyecto específico (crea un archivo .mcp.json que puede confirmar):

claude mcp add runpod -s project \
  -e RUNPOD_API_KEY=YOUR_API_KEY \
  -- npx -y @runpod/mcp-server@latest

Verifique que el servidor esté conectado con claude mcp list. Si está en una sesión activa, escriba /mcp para reconectar sin reiniciar.

Claude Desktop

Edite el archivo de configuración en ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "runpod": {
      "command": "npx",
      "args": ["-y", "@runpod/mcp-server@latest"],
      "env": {
        "RUNPOD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Reinicie Claude Desktop después de guardar.

Cursor

Añada lo siguiente a .cursor/mcp.json en el directorio de su proyecto, o a ~/.cursor/mcp.json para acceso global:

{
  "mcpServers": {
    "runpod": {
      "command": "npx",
      "args": ["-y", "@runpod/mcp-server@latest"],
      "env": {
        "RUNPOD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Abra la configuración de Windsurf (Cmd+Shift+P → "Open Windsurf Settings"), navegue a la sección Cascade y habilite MCP. Luego edite ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "runpod": {
      "command": "npx",
      "args": ["-y", "@runpod/mcp-server@latest"],
      "env": {
        "RUNPOD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

VS Code (GitHub Copilot)

MCP funciona en el modo agente de VS Code (requiere VS Code 1.101+). Añada lo siguiente a .vscode/mcp.json en su espacio de trabajo:

{
  "mcpServers": {
    "runpod": {
      "command": "npx",
      "args": ["-y", "@runpod/mcp-server@latest"],
      "env": {
        "RUNPOD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Haga clic en el botón "Start" junto a la entrada del servidor para conectar.

Cline

Abra Cline en VS Code, haga clic en el menú hamburguesa (☰) y vaya a MCP Servers. Puede añadir servidores a través del marketplace o configurar manualmente en la configuración de Cline usando la misma estructura JSON mostrada arriba.

IDEs de JetBrains

Cree un archivo mcp.json en ~/.junie/mcp.json (global) o .junie/mcp/ en su proyecto:

{
  "mcpServers": {
    "runpod": {
      "command": "npx",
      "args": ["-y", "@runpod/mcp-server@latest"],
      "env": {
        "RUNPOD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Otros clientes

Este servidor utiliza transporte stdio y funciona con cualquier cliente compatible con MCP. El patrón de configuración es el mismo en todos los clientes: apunte el comando a npx con @runpod/mcp-server@latest como argumento y establezca RUNPOD_API_KEY en el entorno. Para obtener una lista completa de clientes MCP, consulte la página oficial de clientes MCP.

Uso de una compilación local

Si desea ejecutar desde un clon local del repositorio (para desarrollo o para probar cambios no publicados):

git clone https://github.com/runpod/runpod-mcp.git
cd runpod-mcp
pnpm install
pnpm build

Luego reemplace el command y los args en cualquiera de las configuraciones anteriores con:

{
  "command": "node",
  "args": ["/absolute/path/to/runpod-mcp/dist/index.mjs"]
}

Después de realizar cambios en el código fuente, vuelva a ejecutar pnpm build y reinicie o reconecte el servidor MCP para que los cambios surtan efecto.

Ejemplos de uso

Listar todos los Pods

Can you list all my Runpod Pods?

Crear un nuevo Pod

Create a new Runpod Pod with the following specifications:
- Name: test-pod
- Image: runpod/pytorch:2.1.0-py3.10-cuda11.8.0-devel-ubuntu22.04
- GPU Type: NVIDIA GeForce RTX 4090
- GPU Count: 1

Crear un endpoint Serverless

Create a Runpod Serverless endpoint with the following configuration:
- Name: my-endpoint
- Template ID: 30zmvf89kd
- Minimum workers: 0
- Maximum workers: 3

Contribución

Para comenzar con el desarrollo local, clone el repositorio y compile:

git clone https://github.com/runpod/runpod-mcp.git
cd runpod-mcp
pnpm install
pnpm build

Después de realizar cambios, vuelva a compilar con pnpm build. En Claude Code, escriba /mcp para reconectar al servidor actualizado sin reiniciar su sesión. También puede usar pnpm build:watch para la recompilación automática durante el desarrollo.

Todas las herramientas residen en src/index.ts. El servidor utiliza dos backends: la API REST (runpodRequest()) para operaciones CRUD autenticadas y la API GraphQL (graphqlRequest()) para consultas públicas de solo lectura como tipos de GPU y centros de datos. Siga los patrones existentes al añadir nuevas herramientas: nombres en kebab-case, esquemas Zod con .describe() y respuestas serializadas en JSON.

Este proyecto utiliza changesets para el control de versiones y la publicación en npm. Cada PR con cambios orientados al usuario necesita un archivo de changeset en .changeset/DESCRIPTIVE_NAME.md:

---
"@runpod/mcp-server": minor
---

Description of what changed and why.

Use patch para correcciones de errores, minor para nuevas herramientas o características y major para cambios importantes. El directorio .changeset/ está ignorado por git, así que use git add -f para preparar los archivos de changeset.

Consulte CLAUDE.md para obtener la guía de desarrollo completa, incluidos detalles de arquitectura, convenciones de herramientas y problemas conocidos.

Consideraciones de seguridad

Este servidor requiere su clave API de Runpod, la cual otorga acceso total a su cuenta de Runpod. Nunca comparta su clave API. Sea cauteloso con las operaciones que realiza y considere configurar una clave API separada con permisos limitados. No utilice esto en un entorno de producción sin las medidas de seguridad adecuadas.

Licencia

Apache-2.0