MCP

🚀 @return-0/mcp-server

@return-0/mcp-server 是為 return0 打造的 MCP（模型上下文協議）服務器，return0 是一款用於即時調試生產環境應用程序的工具。

🚀 快速開始

關於 return0

return0 讓開發者能夠即時調試生產環境中的 Node.js 應用程序。藉助它，你可以連接到即時變量、觀察執行流程，並直接在 Cursor IDE 中瞭解運行時行為，從而對應用程序進行監控和故障排查。對於使用 Next.js 構建並部署在 Vercel 等平臺上的生產環境應用程序而言，傳統調試方法可能頗具挑戰，而 return0 的這一功能尤為強大。

• 官網：getreturn0.com
• 在線演示：getreturn0.com/livedemo
• 文檔：getreturn0.com/docs

在 Cursor 中配置

若要在 Cursor IDE 中使用此 MCP 服務器，你需要在 Cursor 設置中進行配置。首先，你需要獲取 return0 API 密鑰。

獲取 API 密鑰

訪問 return0 文檔，按照文檔指引獲取你的 return0 API 密鑰。

獲取 API 密鑰後，你可以通過以下兩種方式配置 MCP 服務器：

方式一：一鍵安裝

點擊下方按鈕，即可在 Cursor 中自動安裝並配置 return0 MCP 服務器：

此操作將自動配置 MCP 服務器。注意：安裝完成後，你需要在配置中添加 return0 API 密鑰。有關獲取 API 密鑰的說明，請參閱上述獲取 API 密鑰部分；有關如何添加密鑰的詳細信息，請參閱下面的手動配置部分。

方式二：手動配置

若你傾向於手動配置，請在 Cursor IDE 中按以下步驟操作：

1. 打開 Cursor IDE。
2. 轉到設置（在 macOS 上為偏好設置）：
   • 點擊左下角的齒輪圖標（⚙️）；
   • 或者使用鍵盤快捷鍵：Ctrl + ,（Windows/Linux）或 Cmd + ,（macOS）。
3. 在設置搜索欄中輸入 “MCP” 或 “模型上下文協議”。
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 自動安裝。

✨ 主要特性

工具：variable_extractor

此 MCP 服務器提供了一個 variable_extractor 工具，供與 MCP 兼容的客戶端使用。該工具可從生產代碼中提取變量的運行時值、類型和時間戳。

輸入模式：

{
  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

🔗 鏈接

• 官網
• 在線演示
• 文檔