Runpod MCP 서버

이 모델 컨텍스트 프로토콜(MCP) 서버를 사용하면 모든 MCP 호환 클라이언트를 통해 Runpod 인프라를 관리할 수 있습니다. Pod, 서버리스 엔드포인트, 템플릿, 네트워크 볼륨 및 컨테이너 레지스트리 인증을 다루기 위한 도구를 제공합니다.

빠른 시작

요구 사항

• Node.js 18 이상.

• Runpod 계정 및 API 키 (API 키 받기).

npx로 실행하기

설치 없이 서버를 직접 실행할 수 있습니다:

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

Smithery를 통한 설치

Smithery를 통해 Claude Desktop에 자동으로 설치하려면:

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

Related MCP server: Quickbase MCP Server

클라이언트 설정

대부분의 MCP 클라이언트는 동일한 일반 구조의 JSON 구성 파일을 사용합니다. 아래 예제는 npx 방식(대부분의 사용자에게 권장)과 로컬 빌드 방식(개발용)을 보여줍니다. YOUR_API_KEY를 실제 Runpod API 키로 바꾸십시오.

Claude Code

모든 프로젝트에서 사용할 수 있도록 MCP 서버를 전역으로 추가하십시오:

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

또는 특정 프로젝트에 추가하십시오(커밋 가능한 .mcp.json 파일이 생성됩니다):

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

claude mcp list로 서버가 연결되었는지 확인하십시오. 활성 세션 중이라면 /mcp를 입력하여 재시작 없이 다시 연결할 수 있습니다.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json(Windows)에 있는 구성 파일을 편집하십시오:

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

저장 후 Claude Desktop을 재시작하십시오.

Cursor

프로젝트 디렉토리의 .cursor/mcp.json 또는 전역 액세스를 위해 ~/.cursor/mcp.json에 다음을 추가하십시오:

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

Windsurf

Windsurf 설정(Cmd+Shift+P → "Open Windsurf Settings")을 열고 Cascade 섹션으로 이동하여 MCP를 활성화하십시오. 그런 다음 ~/.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는 VS Code의 에이전트 모드에서 작동합니다(VS Code 1.101+ 필요). 작업 공간의 .vscode/mcp.json에 다음을 추가하십시오:

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

서버 항목 옆의 "Start" 버튼을 클릭하여 연결하십시오.

Cline

VS Code에서 Cline을 열고 햄버거 메뉴(☰)를 클릭한 다음 MCP Servers로 이동하십시오. 마켓플레이스를 통해 서버를 추가하거나 위와 동일한 JSON 구조를 사용하여 Cline 설정에서 수동으로 구성할 수 있습니다.

JetBrains IDEs

~/.junie/mcp.json(전역) 또는 프로젝트의 .junie/mcp/에 mcp.json 파일을 생성하십시오:

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

기타 클라이언트

이 서버는 stdio 전송을 사용하며 모든 MCP 호환 클라이언트와 작동합니다. 구성 패턴은 모든 클라이언트에서 동일합니다. 명령어를 npx로 지정하고 인수로 @runpod/mcp-server@latest를 사용하며 환경 변수에 RUNPOD_API_KEY를 설정하십시오. 전체 MCP 클라이언트 목록은 공식 MCP 클라이언트 페이지를 참조하십시오.

로컬 빌드 사용

로컬 저장소 복제본에서 실행하려면(개발 또는 미출시 변경 사항 테스트용):

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

그런 다음 위의 구성에서 command와 args를 다음과 같이 바꾸십시오:

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

소스 변경 후 pnpm build를 다시 실행하고 MCP 서버를 재시작하거나 다시 연결하여 변경 사항을 적용하십시오.

사용 예시

모든 Pod 나열

Can you list all my Runpod Pods?

새 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 Runpod Serverless endpoint with the following configuration:
- Name: my-endpoint
- Template ID: 30zmvf89kd
- Minimum workers: 0
- Maximum workers: 3

기여하기

로컬 개발을 시작하려면 저장소를 복제하고 빌드하십시오:

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

변경 후 pnpm build로 다시 빌드하십시오. Claude Code에서는 /mcp를 입력하여 세션을 재시작하지 않고 업데이트된 서버에 다시 연결할 수 있습니다. 개발 중 자동 재빌드를 위해 pnpm build:watch를 사용할 수도 있습니다.

모든 도구는 src/index.ts에 있습니다. 서버는 두 가지 백엔드를 사용합니다. 인증된 CRUD 작업을 위한 REST API(runpodRequest())와 GPU 유형 및 데이터 센터와 같은 공개 읽기 전용 쿼리를 위한 GraphQL API(graphqlRequest())입니다. 새 도구를 추가할 때는 기존 패턴(kebab-case 이름, .describe()가 포함된 Zod 스키마, JSON 문자열화된 응답)을 따르십시오.

이 프로젝트는 버전 관리 및 npm 배포를 위해 changesets를 사용합니다. 사용자 대면 변경 사항이 있는 모든 PR은 .changeset/DESCRIPTIVE_NAME.md에 changeset 파일이 필요합니다:

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

Description of what changed and why.

버그 수정에는 patch, 새 도구 또는 기능에는 minor, 주요 변경 사항에는 major를 사용하십시오. .changeset/ 디렉토리는 gitignore 처리되므로 git add -f를 사용하여 changeset 파일을 스테이징하십시오.

아키텍처 세부 정보, 도구 규칙 및 알려진 문제를 포함한 전체 개발 가이드는 CLAUDE.md를 참조하십시오.

보안 고려 사항

이 서버는 Runpod 계정에 대한 전체 액세스 권한을 부여하는 Runpod API 키가 필요합니다. API 키를 절대 공유하지 마십시오. 수행하는 작업에 주의를 기울이고 권한이 제한된 별도의 API 키를 설정하는 것을 고려하십시오. 적절한 보안 조치 없이 프로덕션 환경에서 사용하지 마십시오.

라이선스

Apache-2.0