RunPod MCP Server

Servidor MCP RunPod

Este servidor Model Context Protocol (MCP) permite que você interaja com a API REST do RunPod por meio do Claude ou de outros clientes compatíveis com MCP.

Recursos

O servidor fornece ferramentas para gerenciar:

• Pods: Criar, listar, obter detalhes, atualizar, iniciar, parar e excluir pods
• Endpoints: Criar, listar, obter detalhes, atualizar e excluir endpoints serverless
• Modelos: Criar, listar, obter detalhes, atualizar e excluir modelos
• Volumes de Rede: Criar, listar, obter detalhes, atualizar e excluir volumes de rede
• Autenticações do Registro de Contêineres: Criar, listar, obter detalhes e excluir autenticações

Configuração

Pré-requisitos

• Node.js 18 ou superior
• Uma conta RunPod e chave de API
• Claude for Desktop ou outro cliente compatível com MCP

Instalação via Smithery

Para instalar o runpod-mcp-ts para Claude Desktop automaticamente via Smithery:

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

Instalação

1. Clone o repositório
2. Instale as dependências:

   npm install
   

3. Compile o servidor:

   npm run build
   

Configuração

Defina sua chave de API RunPod como uma variável de ambiente:

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

Você pode obter sua chave de API no console RunPod.

Executando o Servidor

Inicie o servidor:

npm start

Configurando com Claude for Desktop

1. Abra o Claude for Desktop
2. Edite o arquivo de configuração: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows)
3. Adicione a configuração do servidor:

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

Certifique-se de substituir o "args": ["/path/to/runpod-mcp-server/build/index.js"] pelo caminho para a pasta de build no repositório.

4. Reinicie o Claude for Desktop

Exemplos de Uso

Aqui estão alguns exemplos de como usar o servidor com o Claude:

Listar todos os pods

Can you list all my RunPod pods?

Criar um novo 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

Criar um endpoint serverless

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

Considerações de Segurança

Este servidor requer sua chave de API RunPod, que concede acesso total à sua conta RunPod. Por segurança:

• Nunca compartilhe sua chave de API
• Tenha cuidado com as operações que você realiza
• Considere configurar uma chave de API separada com permissões limitadas
• Não use isso em um ambiente de produção sem medidas de segurança adequadas

Licença

MIT