return0 MCP Server

官方

直接在您的 AI IDE（如 Cursor）中調試遠端 Node.js 和 Next.js 應用程式。

GitHub
1

文件

@return-0/mcp-server

用於 return0 的 MCP（模型上下文協定）伺服器 - 一款即時除錯正式環境應用程式的工具。

關於 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. 前往 Settings（或在 macOS 上為 Preferences）：
    • 點擊左下角的齒輪圖示 (⚙️)，或
    • 使用鍵盤快捷鍵：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" 進行測試。MCP 伺服器將在 Cursor 啟動時透過 npx 自動安裝。

工具

此 MCP 伺服器提供一個 variable_extractor 工具，可供相容於 MCP 的客戶端使用。

工具：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

連結