Honeybadger MCP Server

蜜獾MCP服务器设置指南

此MCP服务器将Honeybacker错误跟踪与Cursor IDE集成在一起，允许您直接从开发环境中获取和分析错误。

先决条件

• 已安装Node.js 18+
• 具有API访问权限的蜜狗帐户
• 支持MCP的游标IDE

安装

1.克隆MCP服务器

git clone git@github.com:vishalzambre/honeybadger-mcp.git
cd honeybadger-mcp
npm install

2.建设项目

npm run build

3.用作NPM包（推荐）

全球安装：

npm install -g honeybadger-mcp

然后在Cursor中配置它：

{
  "mcpServers": {
    "honeybadger": {
      "command": "honeybadger-mcp",
      "env": {
        "HONEYBADGER_API_KEY": "your_api_key_here",
        "HONEYBADGER_PROJECT_ID": "your_project_id"
      }
    }
  }
}

基于项目的安装（替代方案）：

如果您更喜欢将MCP服务器作为项目依赖项进行管理：

npm install honeybadger-mcp

在这种情况下，光标中的命令 mcp_servers.json 将指向项目中的本地安装 node_modules:

{
  "mcpServers": {
    "honeybadger": {
      "command": "node",
      "args": ["./node_modules/honeybadger-mcp/dist/index.js"],
      "env": {
        "HONEYBADGER_API_KEY": "your_api_key_here",
        "HONEYBADGER_PROJECT_ID": "your_project_id"
      }
    }
  }
}

4.配置环境变量

创建一个 .env 项目根目录中的文件：

# Required: Your Honeybadger API key
HONEYBADGER_API_KEY=your_api_key_here

# Optional: Default project ID (can be overridden per request)
HONEYBADGER_PROJECT_ID=your_project_id

# Optional: Custom Honeybadger URL (defaults to https://app.honeybadger.io)
HONEYBADGER_BASE_URL=https://app.honeybadger.io

4.获取您的蜜獾证书

1. API密钥:

- 首选https://app.honeybadger.io/users/auth_tokens - 创建新的个人身份验证令牌 - 复制您的令牌 .env 文件

1. 项目ID:

- 前往您在Honeybacker的项目 - 项目ID位于URL中： https://app.honeybadger.io/projects/{PROJECT_ID} - 或者在项目设置中找到它

光标配置

1.在游标中配置MCP

将MCP服务器添加到游标配置中。编辑您的 ~/.cursor/mcp_servers.json （或同等）：

{
  "mcpServers": {
    "honeybadger": {
      "command": "node",
      "args": ["/path/to/honeybadger-mcp/dist/index.js"],
      "env": {
        "HONEYBADGER_API_KEY": "your_api_key_here",
        "HONEYBADGER_PROJECT_ID": "your_project_id"
      }
    }
  }
}

2.替代方案：全球安装

本节将更新或删除，因为上面已经介绍过了。如果你更喜欢从本地路径全局克隆和安装的旧方式，你仍然可以这样做，但建议使用已发布的npm包，以便于更新和管理。

如果从本地克隆安装：

# Navigate to your cloned honeybadger-mcp directory
npm install -g . # Installs from the current directory

# Then configure in Cursor as before
# ... (Cursor configuration for local global install)

用法

配置后，您可以在Cursor中使用这些工具：

1.列出最近的故障

List recent unresolved errors from Honeybadger in production environment

2.获取具体故障详细信息

Get details for Honeybadger fault ID 12345

3.分析问题

Analyze Honeybadger issue 12345 and provide fix suggestions

4.获取错误发生次数

Get the latest 5 occurrences for Honeybadger fault 12345

可用工具

list_honeybadger_faults

列出最近的故障，并可选择按环境和已解决状态进行筛选。

参数：

• project_id （可选）：项目ID
• limit （可选）：故障数（默认值：20，最大值：100）
• environment （可选）：按环境筛选
• resolved （可选）：按已解决状态筛选

get_honeybadger_fault

获取特定故障的详细信息。

参数：

• fault_id （必填）：故障ID
• project_id （可选）：项目ID

get_honeybadger_notices

获取特定故障的通知（错误发生）。

参数：

• fault_id （必填）：故障ID
• project_id （可选）：项目ID
• limit （可选）：通知数量（默认：10，最大：100）

analyze_honeybadger_issue

提供全面的分析和修复建议。

参数：

• fault_id （必填）：故障ID
• project_id （可选）：项目ID
• include_context （可选）：包含请求上下文（默认值：true）

工作流示例

1. 列出最近的错误：“显示生产中最新未解决的错误”
2. 分析具体错误：“分析蜜獾故障12345并提出修复建议”
3. 获取错误上下文：“获取故障12345的最新事件及其完整上下文”
4. 检查并修复：使用分析来理解和修复代码中的问题

故障排除

常见问题

1. 认证错误：验证您的API密钥是否正确并且具有正确的权限
2. 未找到项目：检查您的项目ID是否正确
3. 连接问题：验证对Honeybager API的网络访问

调试模式

直接运行服务器以查看错误消息：

node dist/index.js

日志

检查游标日志以了解MCP相关问题：

• macOS： ~/Library/Logs/Cursor/
• 窗户： %APPDATA%\Cursor\logs\
• Linux： ~/.config/Cursor/logs/

安全说明

• 安全存储API密钥，永远不要将其提交到版本控制
• 尽可能使用特定于环境的API密钥
• 请考虑为此集成使用只读API令牌
• 定期旋转API键

贡献

要扩展此MCP服务器，请执行以下操作：

1. 在中添加新工具 setupToolHandlers() 方法
2. 实现相应的处理程序方法
3. 更新工具列表和文档
4. 使用Honeybacker设置进行彻底测试

支持

对于以下问题：

• 此MCP服务器：检查代码和配置
• 蜜狗API：请参阅 蜜狗API文件
• 光标MCP集成：检查Cursor文档