Jungle Grid MCP Server

Claude Desktop, Cursor, Windsurf, MCP Inspector와 같은 MCP 지원 AI 호스트에서 Jungle Grid GPU 워크로드를 실행하세요.

이 서버는 stdio를 통해 로컬에서 실행되며 도구 호출을 사용자의 API 키와 함께 Jungle Grid REST API로 전달합니다.

요구 사항

• Node.js 18 이상

• Jungle Grid API 키

• 선택 사항: 자체 호스팅 오케스트레이터를 위한 JUNGLE_GRID_API_URL

전체 제출 워크플로우를 위해서는 API 키에 jobs:write 권한이 필요합니다. 이 범위가 있으면 키 계정이 소유한 작업에 대해 견적, 제출, 폴링, 취소 및 로그 확인이 가능합니다. list_jobs는 여전히 jobs:read가 필요합니다.

Related MCP server: jlab-mcp

빠른 시작

JUNGLE_GRID_API_KEY=jg_... npx -y @jungle-grid/mcp

Windows PowerShell에서:

$env:JUNGLE_GRID_API_KEY = "jg_..."
npx -y @jungle-grid/mcp

서버는 stdio를 사용하므로 성공적으로 수동 실행되면 MCP 메시지를 기다리는 상태로 표시됩니다. JUNGLE_GRID_API_KEY가 누락되면 명확한 오류와 함께 종료됩니다.

Claude Desktop

claude_desktop_config.json에 다음을 추가한 후 Claude Desktop을 완전히 다시 시작하세요.

{
  "mcpServers": {
    "junglegrid": {
      "command": "npx",
      "args": ["-y", "@jungle-grid/mcp"],
      "env": {
        "JUNGLE_GRID_API_KEY": "jg_..."
      }
    }
  }
}

Windows 설정 경로:

%APPDATA%\Claude\claude_desktop_config.json

macOS 설정 경로:

~/Library/Application Support/Claude/claude_desktop_config.json

Cursor 또는 프로젝트 MCP 설정

체크인된 프로젝트 설정의 경우 보안 정보를 커밋하지 마세요. API 키를 Cursor 실행에 사용되는 환경 변수에 넣고 설정 파일은 보안 정보 없이 유지하세요.

{
  "mcpServers": {
    "junglegrid": {
      "command": "npx",
      "args": ["-y", "@jungle-grid/mcp"]
    }
  }
}

로컬의 커밋되지 않는 설정의 경우 키를 직접 포함할 수 있습니다:

{
  "mcpServers": {
    "junglegrid": {
      "command": "npx",
      "args": ["-y", "@jungle-grid/mcp"],
      "env": {
        "JUNGLE_GRID_API_KEY": "jg_..."
      }
    }
  }
}

자체 호스팅 오케스트레이터

JUNGLE_GRID_API_URL의 기본값은 https://api.junglegrid.dev입니다. 호스트가 다른 오케스트레이터를 호출해야 할 때 이를 재정의하세요.

{
  "mcpServers": {
    "junglegrid": {
      "command": "npx",
      "args": ["-y", "@jungle-grid/mcp"],
      "env": {
        "JUNGLE_GRID_API_KEY": "jg_...",
        "JUNGLE_GRID_API_URL": "https://your-orchestrator.example.com"
      }
    }
  }
}

도구

• estimate_job: GPU 티어, 리전, 기간 및 크레딧 비용을 견적합니다.

• submit_job: 선택적 environment 값을 사용하여 비동기 GPU 워크로드를 제출합니다.

• get_job: 현재 작업 상태 및 세부 정보를 가져옵니다.

• list_jobs: 인증된 계정의 최근 작업 목록을 가져옵니다.

• cancel_job: 대기 중, 큐에 있거나 실행 중인 작업을 취소합니다.

• get_job_logs: stdout, stderr 및 종료 정보를 가져옵니다.

• stream_job_logs: 완료 또는 시간 초과 시까지 실시간 로그를 스트리밍합니다.

• list_job_artifacts: 작업에 대해 업로드된 관리형 아티팩트 목록을 가져옵니다.

• get_artifact_download_url: 관리형 아티팩트에 대한 서명된 다운로드 URL을 생성합니다.

실시간 작업 패턴

submit_job을 사용하여 작업을 시작하고, stream_job_logs로 실시간 출력을 확인한 다음, 완료 후 list_job_artifacts를 사용하여 저장된 파일을 검색하세요.

{
  "command": ["python", "-c", "import os; exec(os.environ['CODE'])"],
  "environment": {
    "CODE": "import os, json\nos.makedirs('/workspace/artifacts', exist_ok=True)\nwith open('/workspace/artifacts/output.json','w') as f:\n    json.dump({'status':'ok'}, f)"
  }
}

이는 실제 Python 페이로드가 command 배열에 넣기에 너무 길 때 권장되는 패턴입니다.

관리형 작업의 경우 Jungle Grid는 자동으로 /workspace/artifacts를 생성하고 그곳에 작성된 모든 일반 파일을 업로드합니다. 사용자가 서명된 업로드 URL을 생성하거나 아티팩트 완료 엔드포인트를 수동으로 호출할 필요는 없습니다.

로컬 개발

npm install
npm run build
JUNGLE_GRID_API_KEY=jg_... node dist/index.js

MCP Inspector로 서버를 검사하세요:

JUNGLE_GRID_API_KEY=jg_... npx @modelcontextprotocol/inspector node dist/index.js

게시

게시하기 전에 패키지를 확인하세요:

npm run build
npm pack --dry-run

범위가 지정된 패키지를 공개적으로 게시하세요:

npm publish --access public

문제 해결

• JUNGLE_GRID_API_KEY environment variable is required: 호스트 설정 env 블록이나 호스트를 실행하는 환경에 키를 추가하세요.

• 도구가 나타나지 않음: 설정을 편집한 후 MCP 호스트를 완전히 종료하고 다시 여세요.

• 이전 패키지 버전: 설정에서 버전을 고정하거나(예: ["@jungle-grid/mcp@0.1.0"]), npx 캐시를 삭제하세요.

• API 호출 실패: 키가 유효한지, JUNGLE_GRID_API_URL이 사용하려는 오케스트레이터를 가리키고 있는지 확인하세요.

기여자 모집

AI 에이전트, MCP, 개발자 도구 및 워크로드 실행에 관심 있는 기여자분들을 위해 Jungle Grid MCP 서버를 오픈하고 있습니다.

시작하기 좋은 분야:

• 문서 개선

• 예제 프롬프트 추가

• MCP 도구 핸들러에 대한 테스트 추가

• Docker 지원 추가

• GitHub Actions 개선

• 통합 예제 빌드

good first issue 라벨이 붙은 이슈부터 시작해 보세요.