mcpField
R
return0

return0

本地服务
github.com/getreturn0开发工具149 周前更新
代码仓库

关于 return0

return0 是面向开发者的 MCP 服务，可从 Cursor 调试生产环境中的 Node.js 应用。其 variable_extractor 可获取变量的实时值、类型和时间戳，并介绍了用于 Next.js 应用的工作流程。

主要功能

  1. 01提取生产环境变量实时信息
  2. 02获取运行时值、类型和时间戳
  3. 03通过 TypeScript AST 修正行号
  4. 04配置 Cursor

适用场景

  1. 01检查生产应用中的变量
  2. 02排查 Next.js 运行时行为
  3. 03在 Cursor 中调试 Node.js 应用

MCP 相关

向兼容 MCP 的客户端提供 variable_extractor 工具。它读取本地源文件，通过 TypeScript AST 分析修正变量位置，并从运行中的生产应用获取实时值。

#return0#debugging#nodejs#nextjs#cursor-ide

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "getreturn0": {
      "command": "npx",
      "args": [
        "-y",
        "@return-0/mcp-server"
      ],
      "env": {
        "RETURN0_API_KEY": "<RETURN0_API_KEY>"
      }
    }
  }
}
启动命令npx -y @return-0/mcp-server
需要配置的环境变量
RETURN0_API_KEY密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@return-0/mcp-server

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

@return-0/mcp-server

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

关于 return0

return0 让开发者能够实时调试生产环境中的 Node.js 应用。它可以通过连接实时变量、观察执行流程，并直接在 Cursor IDE 中了解运行时行为，帮助你监控和排查应用问题。对于使用 Next.js 构建并部署在 Vercel 等平台上的生产环境应用，这种方式尤其强大，因为传统的调试方法可能会很棘手。

聊天演示

在 Cursor 中配置

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

获取 API 密钥

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

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

选项 1：一键安装

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

添加到 Cursor

这将自动配置 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 启动时将通过 npx 自动安装 MCP 服务。

工具

此 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 文件。

Author

return0

Links

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。