星战科技xingzhan.cloud
返回市场
蜜獾-MCP

蜜獾-MCP

作者：vishalzambre6 星标更新：2025-09-24
安装使用来源：spider==github.com

项目介绍

Honeybadger MCP 服务器设置指南

此MCP服务器集成了Honeybadger错误跟踪与Cursor IDE，允许您直接从开发环境中获取并分析错误。

<a href="https://glama.ai/mcp/servers/@vishalzambre/honeybadger-mcp"> <img width="380" height="200" src="https://gips2.baidu.com/it/u=483936806,3554869413&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Honeybadger Server MCP 服务器" /> </a>

<a href="https://www.buymeacoffee.com/vishalzambre" target="_blank"><img src="https://gips0.baidu.com/it/u=2811292181,1350118012&fm=3081&app=3081&f=PNG?w=545&h=153" alt="买我一杯咖啡" style="height: 60px !important;width: 217px !important;" ></a>

预备条件

  • 安装了Node.js 18+
  • 具有API访问权限的Honeybadger账户
  • 支持MCP的Cursor 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

在这种情况下，您的Cursor 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文件：

# 必需：您的Honeybadger API密钥
HONEYBADGER_API_KEY=your_api_key_here

# 可选：默认项目ID（可以在每次请求时覆盖）
HONEYBADGER_PROJECT_ID=your_project_id

# 可选：自定义Honeybadger URL（默认为https://app.honeybadger.io）
HONEYBADGER_BASE_URL=https://app.honeybadger.io

获取Honeybadger凭证

  1. API密钥：

  2. 项目ID：

    • 在Honeybadger中访问您的项目
    • 项目ID在URL中：https://app.honeybadger.io/projects/{PROJECT_ID}
    • 或者在项目设置中找到它

Cursor配置

1. 在Cursor中配置MCP

将MCP服务器添加到您的Cursor配置中。编辑您的~/.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包以方便更新和管理。

如果从本地克隆安装：

# 导航到您克隆的honeybadger-mcp目录
npm install -g . # 从当前目录安装

# 然后像之前一样在Cursor中配置
# ... (Cursor配置用于本地全局安装)

使用方法

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

1. 列出最近的故障

列出生产环境中最近未解决的错误

2. 获取特定故障详情

获取Honeybadger故障ID 12345的详细信息

3. 分析问题

分析Honeybadger问题12345并提供修复建议

4. 获取错误发生次数

获取Honeybadger故障12345最新的5次发生情况

可用工具

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. 分析特定错误："分析Honeybadger故障12345并提出修复建议"
  3. 获取错误上下文："获取故障12345的最新发生情况，带有完整上下文"
  4. 审查并修复：使用分析结果理解并修复代码中的问题

故障排除

常见问题

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

调试模式

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

node dist/index.js

日志

检查Cursor日志以查找与MCP相关的问题：

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

安全注意事项

  • 安全存储API密钥，切勿将其提交到版本控制系统
  • 当可能时，使用环境特定的API密钥
  • 考虑为此集成使用只读API令牌
  • 定期轮换您的API密钥

贡献

要扩展此MCP服务器：

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

支持

对于以下问题：

  • 此MCP服务器：检查代码和配置
  • Honeybadger API：参考Honeybadger API文档
  • Cursor MCP集成：检查Cursor文档