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

🔗 链接

• 官网
• 在线演示
• 文档