mcp-sentry: A Sentry MCP server

mcp-sentry: A Sentry MCP server

site icon
2025.03.06 13
Python错误监控调试工具开发效率
mcp-sentry 是一个用于从 Sentry.io 检索和分析问题的 Model Context Protocol 服务器。该服务器提供工具来检查错误报告、堆栈跟踪和其他调试信息,帮助开发者更好地理解和解决应用中的问题。
View on GitHub

Overview

基本能力

产品定位

mcp-sentry 是一个专门用于从 Sentry.io 平台获取和分析错误报告的 MCP 服务器,旨在帮助开发者更高效地调试和解决问题。

核心功能

  1. 获取 Sentry 问题详情:通过 ID 或 URL 检索特定问题的详细信息,包括标题、状态、级别、首次和最后出现时间、事件计数以及完整的堆栈跟踪。
  2. 列出项目问题:根据项目和组织 slug 检索项目中的所有问题列表,包含每个问题的基本信息。

适用场景

  1. 开发过程中快速查看和分析 Sentry 报告的错误
  2. 监控应用健康状况,及时发现和解决问题
  3. 团队协作调试时共享错误信息

工具列表

  1. get_sentry_issue
  2. 能力:通过 ID 或 URL 检索和分析 Sentry 问题
  3. 输入:issue_id_or_url(字符串)
  4. 输出:包含问题详细信息的对象

  5. get_list_issues

  6. 能力:通过项目和组织 slug 检索和分析 Sentry 问题列表
  7. 输入:project_slugorganization_slug(字符串)
  8. 输出:包含问题列表的对象

  9. sentry-issue 提示

  10. 能力:以对话形式返回格式化的问题详情
  11. 输入:issue_id_or_url(字符串)
  12. 输出:格式化的问题详情

常见问题解答

  1. 如何配置 Sentry 认证令牌?
  2. 需要在配置文件中提供 --auth-token 参数

  3. 如何指定要分析的项目?

  4. 需要提供 --project-slug--organization-slug 参数

使用教程

使用依赖

  1. 确保已安装 Python 3.x
  2. 可选:安装 uv 工具(推荐)

安装教程

  1. 通过 Smithery 安装(推荐):
npx -y @smithery/cli install @qianniuspace/mcp-sentry --client claude
  1. 通过 PIP 安装
pip install mcp-sentry

或使用 uv:

uv pip install -e .
  1. 运行服务
python -m mcp_sentry

调试方式

  1. 使用 MCP 检查器调试 uvx 安装:
npx @modelcontextprotocol/inspector uvx mcp-sentry --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG
  1. 对于本地开发安装:
cd path/to/servers/src/sentry
npx @modelcontextprotocol/inspector uv run mcp-sentry --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG

许可证

该项目遵循 MIT 开源许可条款。