return0

@return-0/mcp-server

return0 の MCP（Model Context Protocol）サーバーです。return0 は、本番アプリケーションをリアルタイムでデバッグするためのツールです。

return0 について

return0 を使用すると、開発者は本番環境で稼働する Node.js アプリケーションをリアルタイムでデバッグできます。Cursor IDE 内でライブ変数に接続し、実行フローを観察して、ランタイムの動作を直接把握することで、アプリケーションの監視とトラブルシューティングができます。これは、Next.js で構築され、Vercel などのプラットフォームにデプロイされた本番アプリケーションのデバッグで特に有効です。従来のデバッグ方法では困難な場合があります。

• ウェブサイト: getreturn0.com
• ライブデモ: getreturn0.com/livedemo
• ドキュメント: getreturn0.com/docs

Cursor での設定

この MCP サーバーを Cursor IDE で使用するには、Cursor の設定で構成する必要があります。まず、return0 の API キーを取得します。

API キーの取得

return0 の API キーを取得するには、return0 のドキュメントをご覧ください。API キーの取得方法が記載されています。

API キーを取得したら、次のいずれかの方法で MCP サーバーを構成できます。

方法 1：ワンクリックインストール

下のボタンをクリックすると、Cursor に return0 MCP サーバーが自動的にインストールされ、構成されます。

これにより、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 Servers をクリックするか、MCP の構成セクションに移動します
5. Add Server または + ボタンをクリックして、新しい MCP サーバーを追加します
6. 次の設定を入力します。
   • Name: return0
   • Command: npx
   • Args: -y, @return-0/mcp-server
   • Environment Variables: RETURN0_API_KEY を追加し、値に API キーを設定します
7. Save または Apply をクリックして設定を保存します

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" を使用できます。Cursor の起動時に、MCP サーバーは 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 ファイルをご覧ください。

Author

return0

Links

• Website
• Live Demo
• Documentation