What is Runpod Mcp Ts

runpod-mcp-ts is a Model Context Protocol (MCP) server designed to manage pods, endpoints, templates, and volumes via a REST API, enabling interaction with the RunPod ecosystem through compatible clients like Claude.

Use cases

Use cases for runpod-mcp-ts include automating deployment processes, managing microservices, creating and managing serverless applications, and facilitating CI/CD pipelines.

How to use

To use runpod-mcp-ts, first ensure you have Node.js 18 or higher and a RunPod account with an API key. Clone the repository, install dependencies with ‘npm install’, build the server using ‘npm run build’, and set your API key as an environment variable. Finally, start the server with ‘npm start’.

Key features

Key features include managing pods (create, list, update, start, stop, delete), managing serverless endpoints, templates, network volumes, and container registry authentications through a comprehensive REST API.

Where to use

runpod-mcp-ts can be used in cloud computing environments, DevOps practices, and application development where container management and serverless architecture are required.

RunPod MCP Server

This Model Context Protocol (MCP) server enables you to interact with the RunPod REST API through Claude or other MCP-compatible clients.

Features

The server provides tools for managing:

• Pods: Create, list, get details, update, start, stop, and delete pods
• Endpoints: Create, list, get details, update, and delete serverless endpoints
• Templates: Create, list, get details, update, and delete templates
• Network Volumes: Create, list, get details, update, and delete network volumes
• Container Registry Authentications: Create, list, get details, and delete authentications

Setup

Prerequisites

• Node.js 18 or higher
• A RunPod account and API key
• Claude for Desktop or another MCP-compatible client

Installing via Smithery

To install runpod-mcp-ts for Claude Desktop automatically via Smithery:

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

Installation

1. Clone the repository
2. Install dependencies:

   npm install
   

3. Build the server:

   npm run build
   

Configuration

Set your RunPod API key as an environment variable:

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

You can get your API key from the RunPod console.

Running the Server

Start the server:

npm start

Setting up with Claude for Desktop

1. Open Claude for Desktop
2. Edit the config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
3. Add the server configuration:

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

Make sure to replace the "args": ["/path/to/runpod-mcp-server/build/index.js"] with the path to the build folder in the repository.

4. Restart Claude for Desktop

Usage Examples

Here are some examples of how to use the server with Claude:

List all pods

Can you list all my RunPod pods?

Create a new 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

Create a serverless endpoint

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

Security Considerations

This server requires your RunPod API key, which grants full access to your RunPod account. For security:

• Never share your API key
• Be cautious about what operations you perform
• Consider setting up a separate API key with limited permissions
• Don’t use this in a production environment without proper security measures

License

MIT