Runpod

🚀 Run the RunPod MCP Server

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

🚀 Quick Start

This MCP server allows seamless interaction with the RunPod REST API through Claude or other MCP-compatible clients. It offers a range of functions for managing various RunPod resources.

✨ Features

The server provides the following functions for management:

• _pod: 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 Authentication: Create, list, get details, and delete authentication.

📦 Installation

Prerequisites

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

Install via Smithery

Automatically install runpod-mcp-ts for Claude Desktop through Smithery:

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

Manual Installation

1. Clone the repository.
2. Install dependencies:

   npm install
   

3. Build the server:

   npm run build
   

Configuration

Set the 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 obtain your API key from the RunPod console.

Running the Server

Start the server:

npm start

Integration with Claude Desktop

1. Open Claude for Desktop.
2. Edit the configuration 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"
      }
    }
  }
}

Replace "args": ["/path/to/runpod-mcp-server/build/index.js"] with the actual path to the build folder in the repository. 4. Restart Claude for Desktop.

💻 Usage Examples

Basic Usage

Here are some examples when using 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
- Number of GPUs: 1

Create a serverless endpoint

Create a new RunPod serverless endpoint with the following specifications:
- Name: my-serverless-endpoint
- Port: 3000

📄 Security Considerations

⚠️ Important Note

• Do not share API keys: Always ensure the security of your RunPod API key and avoid sharing it with unauthorized individuals.
• Set permissions: Assign appropriate permission levels to different applications or services as needed to minimize potential security risks.
• Regularly update keys: Periodically change your API key, especially when a security incident is suspected.

By following the above steps and considerations, you can successfully configure and run the RunPod MCP server and integrate it seamlessly with Claude Desktop.