RunPod MCP Server

Servidor MCP de RunPod

Este servidor del Protocolo de Contexto de Modelos (MCP) te permite interactuar con la API REST de RunPod a través de Claude u otros clientes compatibles con MCP.

Características

El servidor proporciona herramientas para gestionar:

• Pods: Crear, listar, obtener detalles, actualizar, iniciar, detener y eliminar pods
• Endpoints: Crear, listar, obtener detalles, actualizar y eliminar endpoints sin servidor
• Plantillas: Crear, listar, obtener detalles, actualizar y eliminar plantillas
• Volúmenes de red: Crear, listar, obtener detalles, actualizar y eliminar volúmenes de red
• Autenticaciones del registro de contenedores: Crear, listar, obtener detalles y eliminar autenticaciones

Configuración

Requisitos previos

• Node.js 18 o superior
• Una cuenta de RunPod y clave de API
• Claude para Desktop u otro cliente compatible con MCP

Instalación mediante Smithery

Para instalar runpod-mcp-ts para Claude Desktop automáticamente a través de Smithery:

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

Instalación

1. Clona el repositorio
2. Instala las dependencias:

   npm install
   

3. Compila el servidor:

   npm run build
   

Configuración

Establece tu clave de API de RunPod como variable de entorno:

# 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"

Puedes obtener tu clave de API desde la consola de RunPod.

Ejecutar el servidor

Inicia el servidor:

npm start

Configuración con Claude para Desktop

1. Abre Claude para Desktop
2. Edita el archivo de configuración: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows)
3. Agrega la configuración del servidor:

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

Asegúrate de reemplazar "args": ["/path/to/runpod-mcp-server/build/index.js"] con la ruta a la carpeta de compilación en el repositorio.

4. Reinicia Claude para Desktop

Ejemplos de uso

Aquí hay algunos ejemplos de cómo usar el servidor con Claude:

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 sin servidor

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

Consideraciones de seguridad

Este servidor requiere tu clave de API de RunPod, que otorga acceso completo a tu cuenta de RunPod. Por seguridad:

• Nunca compartas tu clave de API
• Ten precaución con las operaciones que realizas
• Considera configurar una clave de API separada con permisos limitados
• No uses esto en un entorno de producción sin las medidas de seguridad adecuadas

Licencia

MIT