return0 MCP Server

공식

Cursor와 같은 AI IDE에서 직접 원격 Node.js 및 Next.js 애플리케이션을 디버깅하세요.

GitHub
1

문서

@return-0/mcp-server

return0을 위한 MCP (Model Context Protocol) 서버 - 프로덕션 애플리케이션을 실시간으로 디버깅하기 위한 도구입니다.

return0 소개

return0은 개발자가 프로덕션 Node.js 애플리케이션을 실시간으로 디버깅할 수 있게 해줍니다. 라이브 변수에 연결하고, 실행 흐름을 관찰하며, 런타임 동작을 Cursor IDE 내에서 직접 이해함으로써 애플리케이션을 모니터링하고 문제를 해결할 수 있습니다. 이는 특히 Next.js로 구축되고 Vercel과 같은 플랫폼에 배포된 프로덕션 애플리케이션을 디버깅할 때 강력하며, 기존 디버깅 방식으로는 어려운 점을 해결해 줍니다.

Chat Demo

Cursor에서의 설정

이 MCP 서버를 Cursor IDE와 함께 사용하려면 Cursor 설정에서 구성해야 합니다. 먼저 return0 API 키를 발급받아야 합니다.

API 키 발급받기

return0 API 키를 발급받으려면 return0 문서를 방문하세요. 문서에서 API 키를 얻는 과정을 안내해 줍니다.

API 키를 발급받은 후에는 다음 두 가지 방법 중 하나로 MCP 서버를 구성할 수 있습니다.

옵션 1: 원클릭 설치

아래 버튼을 클릭하여 Cursor에 return0 MCP 서버를 자동으로 설치하고 구성하세요.

Add to Cursor

이 버튼을 클릭하면 MCP 서버가 자동으로 구성됩니다. 참고: 설치 후 구성에 return0 API 키를 추가해야 합니다. API 키를 얻는 방법은 위의 API 키 발급받기 섹션을 참조하고, 키를 추가하는 방법은 아래 수동 구성 섹션을 참조하세요.

옵션 2: 수동 구성

수동으로 구성하려면 Cursor IDE에서 다음 단계를 따르세요.

  1. Cursor IDE를 엽니다.
  2. 설정(macOS에서는 환경설정)으로 이동합니다.
    • 왼쪽 하단의 톱니바퀴 아이콘(⚙️)을 클릭하거나,
    • 키보드 단축키를 사용합니다: Ctrl+, (Windows/Linux) 또는 Cmd+, (macOS)
  3. 설정 검색창에 "MCP" 또는 "Model Context Protocol"을 입력합니다.
  4. MCP 서버를 클릭하거나 MCP 구성 섹션으로 이동합니다.
  5. 서버 추가 또는 + 버튼을 클릭하여 새 MCP 서버를 추가합니다.
  6. 다음 구성을 입력합니다.
    • 이름: return0
    • 명령어: npx
    • 인수: -y, @return-0/mcp-server
    • 환경 변수: RETURN0_API_KEY을 추가하고 값으로 API 키를 입력합니다.
  7. 저장 또는 적용을 클릭하여 구성을 저장합니다.

구성은 mcp.json 파일에서 다음과 같이 표시되어야 합니다.

{
  "mcpServers": {
    "return0": {
      "command": "npx",
      "args": ["-y", "@return-0/mcp-server"],
      "env": {
        "RETURN0_API_KEY": "your-api-key-here"
      }
    }
  }
}

참고: "your-api-key-here"를 실제 return0 API 키로 교체하세요. 아직 API 키가 없다면 위의 API 키 발급받기 섹션에서 안내를 참조하거나, 테스트 목적으로 "demo"을 사용할 수 있습니다. MCP 서버는 Cursor가 시작될 때 npx를 통해 자동으로 설치됩니다.

도구

이 MCP 서버는 MCP 호환 클라이언트에서 사용할 수 있는 variable_extractor 도구를 제공합니다.

도구: variable_extractor

프로덕션 코드에서 변수의 런타임 값, 타입, 타임스탬프를 추출합니다.

입력 스키마:

{
  files: Array<{
    fileName: string;        // Full absolute path to the file
    variables: Array<{
      name: string;          // Variable name to extract
      lineNumber: number;    // Line number where variable is defined
    }>
  }>
}

예시:

{
  "files": [
    {
      "fileName": "C:\\Users\\username\\project\\src\\app\\api\\route.ts",
      "variables": [
        {
          "name": "userData",
          "lineNumber": 42
        }
      ]
    }
  ]
}

작동 방식

  1. MCP 서버는 프로덕션 코드에서 런타임 변수 값을 추출하라는 요청을 받습니다.
  2. 로컬 파일 시스템에서 소스 파일을 읽습니다.
  3. TypeScript AST 분석을 사용하여 정확한 변수 위치를 위해 줄 번호를 보정합니다.
  4. 실행 중인 프로덕션 애플리케이션에 연결하여 라이브 변수 값을 가져옵니다.
  5. 실시간 런타임 값, 타입, 타임스탬프와 함께 보정된 변수 추출 데이터를 반환합니다.

라이선스

자세한 내용은 LICENSE 파일을 참조하세요.

작성자

return0

링크