return0 MCP Server

官方

直接从Cursor等AI IDE中调试远程Node.js和Next.js应用程序。

GitHub
1

文档

@return-0/mcp-server

用于 return0 的 MCP（模型上下文协议）服务器——一款用于实时调试生产环境应用程序的工具。

关于 return0

return0 使开发者能够实时调试生产环境中的 Node.js 应用程序。它允许你通过连接实时变量、观察执行流程以及直接在 Cursor IDE 中理解运行时行为来监控和排查应用程序问题。这对于调试使用 Next.js 构建并部署在 Vercel 等平台上的生产环境应用程序尤其强大，因为在这些场景下传统的调试方法往往面临挑战。

Chat Demo

在 Cursor 中的配置

要在 Cursor IDE 中使用此 MCP 服务器，你需要在 Cursor 设置中进行配置。首先，你需要获取 return0 API 密钥。

获取你的 API 密钥

要获取 return0 API 密钥，请访问 return0 文档。文档将指导你完成获取 API 密钥的过程。

获得 API 密钥后，你可以通过以下两种方式之一配置 MCP 服务器：

方式一：一键安装

点击下方按钮，即可在 Cursor 中自动安装并配置 return0 MCP 服务器：

Add to Cursor

这将自动配置 MCP 服务器。注意： 安装后你需要将 return0 API 密钥添加到配置中。有关获取 API 密钥的说明，请参阅上方的获取你的 API 密钥部分；有关如何添加密钥的详细信息，请参阅下方的手动配置部分。

方式二：手动配置

如果你更倾向于手动配置，请在 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

链接