STARWARCLOUD STARWAR.AI
返回市场
错误提示MCP服务器

错误提示MCP服务器

作者：vltansky2 星标更新：2025-10-31
安装使用来源：spider==github.com

项目介绍

GlitchTip MCP Server

用于将GlitchTip错误监控集成到像Claude这样的AI助手中的MCP服务器。

安装

<details> <summary><b>在Cursor中安装</b></summary>

先决条件

  1. 已安装 Cursor IDE
  2. GlitchTip API令牌或会话ID
  3. 您的GlitchTip组织slug

快速安装

安装MCP服务器

点击上方按钮并按照安装流程操作，或者手动配置：

手动配置

  1. 打开您的MCP配置文件：

    • 全局（所有项目）：~/.cursor/mcp.json
    • 特定项目：项目根目录下的.cursor/mcp.json

  2. 添加以下配置：

{
  "mcpServers": {
    "glitchtip": {
      "command": "npx",
      "args": ["-y", "glitchtip-mcp"],
      "env": {
        "GLITCHTIP_TOKEN": "your-api-token",
        "GLITCHTIP_ORGANIZATION": "your-org-slug",
        "GLITCHTIP_BASE_URL": "https://app.glitchtip.com"
      }
    }
  }
}
  1. 将环境变量替换为您实际的值
  2. 保存文件并重启Cursor

使用.env文件（推荐）

为了更好的安全性，请将凭证存储在.env文件中：

  1. 在项目根目录下创建.env文件：
GLITCHTIP_TOKEN=your-api-token
GLITCHTIP_ORGANIZATION=your-org-slug
GLITCHTIP_BASE_URL=https://app.glitchtip.com
  1. 更新.cursor/mcp.json文件：
{
  "mcpServers": {
    "glitchtip": {
      "command": "npx",
      "args": ["-y", "glitchtip-mcp"]
    }
  }
}
  1. 将.env添加到.gitignore：
echo ".env" >> .gitignore

验证安装

  1. 完全重启Cursor
  2. 检查设置 → 工具与集成 → MCP工具中的绿色点
  3. 在聊天/编辑器中检查“可用工具”
  4. 测试：“显示GlitchTip错误”
</details> <details> <summary><b>在Claude Desktop中安装</b></summary>

先决条件

  1. 已安装 Claude Desktop
  2. GlitchTip API令牌或会话ID
  3. 您的GlitchTip组织slug

配置

  1. 打开您的Claude Desktop配置文件：

    • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows：%APPDATA%\Claude\claude_desktop_config.json
    • Linux：~/.config/Claude/claude_desktop_config.json

  2. 添加以下配置：

{
  "mcpServers": {
    "glitchtip": {
      "command": "npx",
      "args": ["-y", "glitchtip-mcp"],
      "env": {
        "GLITCHTIP_TOKEN": "your-api-token",
        "GLITCHTIP_ORGANIZATION": "your-org-slug",
        "GLITCHTIP_BASE_URL": "https://app.glitchtip.com"
      }
    }
  }
}
  1. 将环境变量替换为您实际的值
  2. 保存文件并重启Claude Desktop

使用.env文件（推荐）

为了更好的安全性，请将凭证存储在.env文件中：

  1. 在项目根目录下创建.env文件：
GLITCHTIP_TOKEN=your-api-token
GLITCHTIP_ORGANIZATION=
your-org-slug
GLITCHTIP_BASE_URL=https://app.glitchtip.com
  1. 更新claude_desktop_config.json文件：
{
  "mcpServers": {
    "glitchtip": {
      "command": "npx",
      "args": ["-y", "glitchtip-mcp"]
    }
  }
}
  1. 将.env添加到.gitignore：
echo ".env" >> .gitignore

验证安装

  1. 完全重启Claude Desktop
  2. 查看右下角的🔌图标
  3. 点击它以查看可用的MCP服务器
  4. 测试：“显示GlitchTip错误”
</details> <details> <summary><b>在Claude Code CLI中安装</b></summary>

先决条件

  1. 已安装 Claude Code CLI
  2. GlitchTip API令牌或会话ID
  3. 您的GlitchTip组织slug

安装

在终端运行以下命令：

claude mcp add glitchtip -e GLITCHTIP_TOKEN=your-api-token -e GLITCHTIP_ORGANIZATION=your-org-slug -e GLITCHTIP_BASE_URL=https://app.glitchtip.com -- npx -y glitchtip-mcp

使用环境变量（推荐）

为了更好的安全性，请将凭证存储在.env文件中：

  1. 在项目根目录下创建.env文件：
GLITCHTIP_TOKEN=your-api-token
GLITCHTIP_ORGANIZATION=your-org-slug
GLITCHTIP_BASE_URL=https://app.glitchtip.com
  1. 添加MCP服务器：
claude mcp add glitchtip -e GLITCHTIP_TOKEN=$(grep GLITCHTIP_TOKEN .env | cut -d '=' -f2) -e GLITCHTIP_ORGANIZATION=$(grep GLITCHTIP_ORGANIZATION .env | cut -d '=' -f2) -e GLITCHTIP_BASE_URL=$(grep GLITCHTIP_BASE_URL .env | cut -d '=' -f2) -- npx -y glitchtip-mcp
  1. 将.env添加到.gitignore：
echo ".env" >> .gitignore

配置范围

  • -s user：跨所有项目可用
  • -s project：通过.mcp.json文件共享（提交到仓库）
  • 默认：local（仅当前项目）

验证安装

claude mcp list
claude mcp get glitchtip

测试：“显示GlitchTip错误”

</details> <details> <summary><b>在Cline（VS Code扩展）中安装</b></summary>

先决条件

  1. 已安装 VS Code
  2. 已安装 Cline扩展
  3. GlitchTip API令牌或会话ID
  4. 您的GlitchTip组织slug

配置

  1. 打开VS Code
  2. 点击Cline扩展中的MCP服务器图标（📚）
  3. 点击“已安装”标签
  4. 点击“配置MCP服务器”
  5. 向cline_mcp_settings.json文件添加以下内容：
{
  "mcpServers": {
    "glitchtip": {
      "command": "npx",
      "args": ["-y", "glitchtip-mcp"],
      "env": {
        "GLITCHTIP_TOKEN": "your-api-token",
        "GLITCHTIP_ORGANIZATION": "your-org-slug",
        "GLITCHTIP_BASE_URL": "https://app.glitchtip.com"
      }
    }
  }
}
  1. 将环境变量替换为您实际的值
  2. 保存文件
  3. 重启VS Code或重新加载Cline扩展

使用.env文件（推荐）

为了更好的安全性，请将凭证存储在.env文件中：

  1. 在项目根目录下创建.env文件：
GLITCHTIP_TOKEN=your-api-token
GLITCHTIP_ORGANIZATION=your-org-slug
GLITCHTIP_BASE_URL=https://app.glitchtip.com
  1. 更新cline_mcp_settings.json文件：
{
  "mcpServers": {
    "glitchtip": {
      "command": "npx",
      "args": ["-y", "glitchtip-mcp"]
    }
  }
}
  1. 将.env添加到.gitignore：
echo ".env" >> .gitignore

验证安装

  1. 重启VS Code或重新加载Cline
  2. 检查Cline中的MCP服务器面板
  3. 查找连接服务器列表中的“glitchtip”
  4. 测试：“显示GlitchTip错误”
</details>

获取GlitchTip凭证

<details> <summary><b>API令牌（推荐）</b></summary>
  1. 登录GlitchTip
  2. 转到https://app.glitchtip.com/profile/auth-tokens
  3. 创建一个新的API令牌
  4. 复制该令牌
</details> <details> <summary><b>会话ID（替代方案）</b></summary>
  1. 登录GlitchTip
  2. 打开浏览器开发者工具（F12）
  3. 转到应用程序/存储 → Cookie
  4. 复制sessionidCookie值
</details>

配置

变量必需描述默认值
GLITCHTIP_TOKEN是*API令牌-
GLITCHTIP_SESSION_ID是*会话Cookie-
GLITCHTIP_ORGANIZATION是组织slug-
GLITCHTIP_BASE_URL否实例URLhttps://app.glitchtip.com

*需要GLITCHTIP_TOKEN或GLITCHTIP_SESSION_ID中的一个

可用工具

glitchtip_issues

从GlitchTip获取问题。

参数：

  • status（可选）：'resolved'，'unresolved' 或 'all'（默认：'unresolved'）

示例：

  • “显示所有GlitchTip错误”
  • “获取已解决的问题”
  • “显示包括已解决的所有问题”

glitchtip_latest_event

获取特定问题的最新事件及其完整上下文。

参数：

  • issueId：问题ID

示例： “获取问题#123的详细信息”

可用资源

glitchtip://issues

提供所有当前问题的资源端点，以JSON格式。

可用提示

recent_errors

获取最近生产错误的概述，附带分析和优先级排序。

使用场景：快速处理生产问题

示例： “使用recent_errors提示”

debug_issue

深入调查特定错误，附带完整上下文和建议修复方法。

参数：

  • issueId：要调试的问题ID

使用场景：对特定错误进行详细调查

示例： “使用debug_issue提示对问题12345进行调试”

使用示例

调试生产错误

用户： “检查GlitchTip最近的500错误”

AI： 我发现了3个最近的500错误：
1. 数据库连接错误在/api/users
2. 支付处理超时错误
3. 结算流程验证错误

用户： “显示支付超时的详细信息”

AI： [分析事件] 超时错误发生在...
[提供堆栈跟踪和建议修复方法]

监控错误趋势

用户： “最常见的错误是什么？”

AI： 按频率排名的顶级错误：
1. CORS策略错误（145次）
2. 缺少认证令牌（89次）
3. 超出速率限制（67次）

使用提示进行引导分析

用户： “使用recent_errors提示”

AI： [分析所有未解决的问题]
总结：
- 5个项目中有23个未解决的问题
- 严重：数据库连接错误（89次）
- 高：支付流超时错误（45次）
- 中：验证错误（12次）

推荐优先处理：
1. 修复数据库连接池
2. 调查支付超时的根本原因
3. 对边缘情况进行验证

用户： “使用debug_issue提示对问题12345进行调试”

AI： [深入特定错误，提供堆栈跟踪和修复建议]

故障排除

认证失败

  • 验证您的令牌/会话ID有效
  • 检查组织slug是否正确
  • 确保令牌具有适当的权限

连接错误

  • 验证GLITCHTIP_BASE_URL是否正确
  • 检查网络连接
  • 确保可以访问GlitchTip实例

未找到问题

  • 验证GlitchTip中是否存在问题
  • 检查组织slug
  • 确保您有权限查看问题

安全性

  • 切勿将.mcp.json、.cursor/mcp.json或.env提交到版本控制
  • 使用.env文件存储密钥（如果添加到.gitignore，则自动被git忽略）
  • 团队使用时使用API令牌而不是会话ID
  • 每位开发者应使用自己的凭证

开发与贡献

安装

npm install

构建

npm run build

监视模式

npm run watch

使用MCP Inspector测试

export GLITCHTIP_TOKEN="your-token"
export GLITCHTIP_ORGANIZATION="your-org"
npm run inspector

项目结构

glitchtip-mcp/
├── src/
│   ├── types.ts      # TypeScript类型定义
│   ├── client.ts     # GlitchTip API客户端
│   └── index.ts      # MCP服务器实现
├── package.json
├── tsconfig.json
└── README.md

许可证

MIT

基于mcp-glitchtip