项目简介 Reality Check (RCDBG) 旨在解决AI编程助手在调试代码时效率低下的问题。传统AI助手将代码视为文本，需要大量上下文来理解运行时行为，导致高昂的Token成本和缓慢的响应。RCDBG通过运行一个本地MCP服务器，将真实调试器的能力（如变量值、堆栈跟踪、程序状态）暴露给AI代理，从而实现高达100倍的Token节省，并显著提高调试的准确性和效率。所有数据都在本地处理，确保隐私和安全。

主要功能点

实时调试能力: 允许AI代理启动调试会话、单步执行代码、检查变量作用域和获取完整的调用堆栈。
高度Token效率: AI代理无需读取整个代码库，只需获取运行时关键数据，大幅减少Token消耗。
提升调试准确性: 提供实际的程序执行状态，而非猜测，使AI代理能够精准定位问题。
本地运行与隐私保护: MCP服务器完全在本地运行，不依赖云服务，确保代码和调试数据100%私密。
广泛的AI代理兼容性: 与任何兼容MCP的AI代理（如Cursor, Windsurf, Claude Code, VS Code Copilot等）无缝集成。

安装步骤

安装Reality Check VS Code扩展:
- 在VS Code扩展市场搜索 "rcdbg" 并安装。
- 或者通过 '.vsix' 文件安装（适用于离线或开发版本）：'code --install-extension rcdbg-0.0.1.vsix'
启用MCP服务器:
- 在VS Code中打开命令面板 ('Ctrl+Shift+P' 或 'Cmd+Shift+P')。
- 输入并运行命令: 'Reality Check: Enable MCP Server'。
- 系统将提示您查看配置更改的差异预览，请仔细检查并选择“Apply Changes”确认。
- 根据提示重启您的AI编辑器（如Cursor），以使配置生效。

服务器配置 RCDBG MCP服务器通过JSON-RPC协议与AI客户端通信。AI客户端需要配置服务器的启动命令和参数才能建立连接。以下是典型的MCP客户端（如Cursor, Windsurf）所需的JSON配置信息示例及说明：

{
  "mcpServers": {
    "rcdbg": {
      "command": "node",
      "args": [
        "${extensionPath}/out/debugger/mcp-standalone.js"
      ],
      "env": {
        "RCDBG_PORT": "2114"
      }
    }
  }
}

server name (rcdbg): 这是MCP服务器的唯一标识符。
command (node): 启动MCP服务器所使用的可执行文件，这里是Node.js运行时。
args: 传递给Node.js运行时的参数列表。'"${extensionPath}/out/debugger/mcp-standalone.js"' 指向RCDBG扩展内部打包的MCP服务器脚本路径。
env (RCDBG_PORT): 环境变量，用于指定MCP服务器监听的端口，默认为'2114'。

基本使用方法 配置完成后，您的AI代理即可直接利用RCDBG提供的调试能力。例如，在您的AI编辑器中（如Cursor），您可以直接向AI代理提问：

"Debug example/main.py and tell me what the 'user' variable is at line 15."
"Why is the login function failing? Please debug it."
"Step through the current function and show me the local variables."

AI代理将通过调用RCDBG MCP服务器提供的调试工具来执行相应的操作，并返回精确的运行时信息。

关键词

信息