基本能力
产品定位
mcp-sentry 是一个专门用于从 Sentry.io 平台获取和分析错误报告的 MCP 服务器,旨在帮助开发者更高效地调试和解决问题。
核心功能
- 获取 Sentry 问题详情:通过 ID 或 URL 检索特定问题的详细信息,包括标题、状态、级别、首次和最后出现时间、事件计数以及完整的堆栈跟踪。
- 列出项目问题:根据项目和组织 slug 检索项目中的所有问题列表,包含每个问题的基本信息。
适用场景
- 开发过程中快速查看和分析 Sentry 报告的错误
- 监控应用健康状况,及时发现和解决问题
- 团队协作调试时共享错误信息
工具列表
get_sentry_issue
- 能力:通过 ID 或 URL 检索和分析 Sentry 问题
- 输入:
issue_id_or_url
(字符串) -
输出:包含问题详细信息的对象
-
get_list_issues
- 能力:通过项目和组织 slug 检索和分析 Sentry 问题列表
- 输入:
project_slug
和organization_slug
(字符串) -
输出:包含问题列表的对象
-
sentry-issue
提示 - 能力:以对话形式返回格式化的问题详情
- 输入:
issue_id_or_url
(字符串) - 输出:格式化的问题详情
常见问题解答
- 如何配置 Sentry 认证令牌?
-
需要在配置文件中提供
--auth-token
参数 -
如何指定要分析的项目?
- 需要提供
--project-slug
和--organization-slug
参数
使用教程
使用依赖
- 确保已安装 Python 3.x
- 可选:安装 uv 工具(推荐)
安装教程
-
通过 Smithery 安装(推荐):
bash
npx -y @smithery/cli install @qianniuspace/mcp-sentry --client claude -
通过 PIP 安装:
bash
pip install mcp-sentry
或使用 uv:
bash
uv pip install -e .
- 运行服务:
bash
python -m mcp_sentry
调试方式
-
使用 MCP 检查器调试 uvx 安装:
bash
npx @modelcontextprotocol/inspector uvx mcp-sentry --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG -
对于本地开发安装:
bash
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