@feedbug/mcp

AI 助手能真正修复的可视化 bug 报告。

Feedbug 让您的测试人员通过点击元素来报告 bug。每个报告都会捕获截图、控制台日志、失败的网络请求、会话回放以及所点击元素的 HTML/DOM 上下文，然后自动在您的 Linear 项目或 GitHub 仓库中创建一个 issue。当关联了代码源时，该 issue 还会附带一个指向 bug 最可能来源文件的链接。

此 MCP 服务器将这些数据直接接入您的 AI 编码助手（Claude Code、Cursor、Windsurf、VS Code）。AI 助手读取 bug，获取精确的 CSS 选择器和组件路径，追踪到源文件，提出修复补丁，并将 bug 标记为已解决。

关于产品端的完整介绍：feedbug.app/mcp-bug-tracking。

指向 bug。发布修复。

快速开始

npx @feedbug/mcp init

安装程序会询问您的客户端和项目密钥，然后为您写入配置。非交互模式：

npx @feedbug/mcp init --client claude pk_your_project_key

支持的客户端：claude（Claude Code）、cursor、windsurf。从 feedbug.app 上的项目页面获取您的项目密钥（pk_...）。

重新启动客户端，工具即可生效。

Related MCP server: Skippr Extension MCP Server

手动配置

将此内容添加到您的客户端的 MCP 配置中（.mcp.json、.cursor/mcp.json、.windsurf/mcp.json 等）：

{
  "mcpServers": {
    "feedbug": {
      "command": "npx",
      "args": ["-y", "@feedbug/mcp"],
      "env": {
        "FEEDBUG_API_URL": "https://api.feedbug.app",
        "FEEDBUG_PROJECT_KEY": "pk_your_project_key"
      }
    }
  }
}

使用 Docker 运行

docker build -t feedbug-mcp .

{
  "mcpServers": {
    "feedbug": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "FEEDBUG_PROJECT_KEY", "feedbug-mcp"],
      "env": {
        "FEEDBUG_PROJECT_KEY": "pk_your_project_key"
      }
    }
  }
}

环境变量

工具

每个工具都接受反馈 UUID 或跟踪器标识符（例如 Linear 上的 PRE-13，GitHub 上的 owner/repo#42）。

工作原理

当测试人员点击一个 bug 时，Feedbug 小部件会快照所点击元素周围的 DOM：CSS 选择器路径、可检测到的框架组件名称、元素的属性和文本，以及它的祖先元素和兄弟元素。该快照会随 Linear 工单一起传递。

通过此 MCP 服务器，您的 AI 助手能读取该上下文，并将 bug 映射到确切的文件和行号，而无需根据模糊的“仪表盘坏了”这样的描述进行猜测。

链接

• 产品：feedbug.app

• API：https://api.feedbug.app

许可证

MIT