调试MCP服务器

Syncause Debug MCP Server是一个帮助AI代理通过查询运行时数据(如堆栈跟踪、日志、请求/响应、函数参数和关键变量值)来调试代码的工具,避免了猜测和多次提示。

  • by Syncause
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Syncause/mcp-server

使用说明

同步调试MCP服务器

无同步,编码代理通常会猜测并仅修复症状,因此您可能需要多次提示代理以修复根本原因。

同步,代理商可以一次性解决根本原因。同步捕获 运行时事实 (堆栈跟踪、日志、请求/响应、函数参数和关键变量值),并使其可由AI代理通过以下方式查询 主控程序--因此,代理使用证据而不是猜测进行调试。

与以下内容一起使用:

安装

[!注意] 推荐API密钥:在获取免费API密钥 syn-cause.com/dashboard 对于更高的速率限制。

通用MCP配置适用于大多数工具:

{
  "mcpServers": {
    "syncause-debug-mcp": {
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "env": { "API_KEY": "YOUR_API_KEY" }
    }
  }
}

在客户端中配置

Install in Cursor

编辑 .cursor/mcp.json (项目)或 ~/.cursor/mcp.json (全球):

{
  "mcpServers": {
    "syncause-debug-mcp": {
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "env": { "API_KEY": "YOUR_API_KEY" }
    }
  }
}
Install in VS Code

编辑 .vscode/settings.json:

{
  "mcp.servers": {
    "syncause-debug-mcp": {
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "env": { "API_KEY": "YOUR_API_KEY" }
    }
  }
}
Install in Antigravity

编辑 ~/.gemini/antigravity/mcp_config.json (全球):

{
  "mcp.servers": {
    "syncause-debug-mcp": {
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "env": { "API_KEY": "YOUR_API_KEY" }
    }
  }
}
Install in Claude Code

运行此命令(本地stdio服务器):

API_KEY=YOUR_API_KEY claude mcp add syncause-debug-mcp -- npx -y @syncause/debug-mcp@latest
Install in OpenAI Codex (CLI)
API_KEY=YOUR_API_KEY codex mcp add syncause-debug-mcp --command "npx -y @syncause/debug-mcp@latest"
Install in Gemini CLI
API_KEY=YOUR_API_KEY gemini mcp add syncause-debug-mcp -- npx -y @syncause/debug-mcp@latest
Install in Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "syncause-debug-mcp": {
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "env": { "API_KEY": "YOUR_API_KEY" }
    }
  }
}
Install in Goose

编辑 ~/.config/goose/config.yaml:

extensions:
  syncause-debug-mcp:
    type: stdio
    name: Syncause Debug MCP
    enabled: true
    timeout: 300
    cmd: npx
    args: ["-y", "@syncause/debug-mcp@latest"]
    envs:
      API_KEY: "YOUR_API_KEY"
Install in Opencode

将此添加到您的Opencode配置中:

{
  "mcp": {
    "syncause-debug-mcp": {
      "type": "local",
      "command": ["npx", "-y", "@syncause/debug-mcp@latest"],
      "env": { "API_KEY": "YOUR_API_KEY" },
      "enabled": true
    }
  }
}

故障排除

  • npx: command not found → 安装Node.js(或确保你的shell可以找到它)。
  • 服务器无法在客户端启动 → 首先尝试在终端中直接运行MCP服务器:
    npx -y @syncause/debug-mcp@latest
    
  • Env未应用 → 许多客户端在配置更改后需要重新启动。

安全说明

  • 你的 API_KEY 是敏感的。避免将MCP配置文件提交到Git。
  • 仅当需要每个仓库隔离时,才首选项目级配置。