错误跟踪服务

Glitchtip MCP服务器

用于与Glitchtip API交互的MCP（模型上下文协议）服务器。

主要由Claude Code创建供内部使用。 许可证：GNU AGPLv3

特性

与Glitchtip错误跟踪平台完全集成，提供以下访问：

• 问题和错误详细信息
• 事件和错误发生
• 项目和组织管理
• 团队和成员信息

需求

• Node.js 18+
• 具有适当作用域的Glitchtip API令牌（请参阅“身份验证”部分）

安装

npm install

配置

设置以下环境变量：

export GLITCHTIP_API_TOKEN="your-api-token"
export GLITCHTIP_ORGANIZATION_SLUG="your-org-slug"
export GLITCHTIP_API_ENDPOINT="https://app.glitchtip.com"  # Or your self-hosted instance

使用Claude Desktop

添加到您的Claude Desktop配置(claude_desktop_config.json):

{
  "mcpServers": {
    "glitchtip": {
      "command": "npx",
      "args": ["-y", "github:CleverMobi/glitchtip-mcp"],
      "env": {
        "GLITCHTIP_API_TOKEN": "your-api-token",
        "GLITCHTIP_ORGANIZATION_SLUG": "your-org-slug",
        "GLITCHTIP_API_ENDPOINT": "https://your-glitchtip-instance.com"
      }
    }
  }
}

可用工具

问题和事件工具（必需 event:read 范围）

获取问题

获取特定Glitchtip问题的完整详细信息，包括：

• 基本问题信息（标题、状态、计数、项目等）
• 具有完整堆栈跟踪的最新事件详细信息
• 关于该问题的所有评论

参数：

• issue_id （必填）：要检索的问题的ID

例子：

get_issue(issue_id: "21241")

返回一个包含三个部分的综合对象：

• issue：核心问题详细信息
• latestEvent：最近发生的与堆栈跟踪、标记和元数据有关的事件
• comments：包含作者和时间戳的所有评论数组

list_issues

列出组织或特定项目中的问题。

参数：

• project_slug （可选）：按项目筛选问题
• limit （可选）：要返回的最大问题数（默认值：25）

例子：

list_issues(project_slug: "my-project", limit: 10)

list_事件

列出特定项目的事件。

参数：

• project_slug （必填）：项目进度
• limit （可选）：要返回的最大事件数（默认值：25）

例子：

list_events(project_slug: "my-project", limit: 5)

项目和组织工具

list_项目

列出组织中的所有Glitchtip项目。

无需参数。

例子：

list_projects()

get_工程

获取特定Glitchtip项目的详细信息。

参数：

• project_slug （必填）：要检索的项目段塞

例子：

get_project(project_slug: "my-project")

get_组织

获取组织详细信息，包括所有项目和团队。

无需参数。

例子：

get_organization()

list_teams

列出组织中的所有团队。

无需参数。

例子：

list_teams()

认证

此服务器使用承载令牌身份验证。您的API令牌需要特定的作用域，具体取决于您要使用的工具：

所需范围

最小令牌范围

• 有关基本项目/组织信息： project:read, org:read, team:read, member:read
• 对于包括问题在内的完整功能： project:read, org:read, team:read, member:read, event:read

要在Glitchtip中创建API令牌，请执行以下操作：

1. 转到您的Glitchtip实例
2. 导航到“设置”→ API令牌
3. 创建具有所需作用域的新令牌

测试

测试服务器功能：

# Run basic tests
node test-get-issue.js

故障排除

403禁止的错误

如果访问问题或事件时收到403个错误，则API令牌缺少 event:read 范围。创建具有适当作用域的新令牌。

401未经授权的错误

请确保您的API令牌有效，并使用承载身份验证格式。

连接问题

验证您的 GLITCHTIP_API_ENDPOINT 是正确和可访问的。