MCP

🚀 @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サーバーを以下の2つの方法のいずれかで構成できます。

オプション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サーバーをクリックするか、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"を使用することができます。Cursorが起動すると、MCPサーバーはnpxを介して自動的にインストールされます。

ツール

このMCPサーバーは、MCP互換クライアントで使用できるvariable_extractorツールを提供します。

ツール: variable_extractor

本番コードから変数のランタイム値、型、およびタイムスタンプを抽出します。

入力スキーマ:

{
  files: Array<{
    fileName: string;        // ファイルの完全な絶対パス
    variables: Array<{
      name: string;          // 抽出する変数名
      lineNumber: number;    // 変数が定義されている行番号
    }>
  }>
}

例:

{
  "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

リンク

• ウェブサイト
• ライブデモ
• ドキュメント