MCP Sentry Server (Node.js)
2025.04.03
1
TypeScript错误监控开发工具开发效率
MCP Sentry Server 是一个基于 Node.js 和 TypeScript 实现的 Sentry 集成服务，通过 Model Context Protocol (MCP) 提供错误报告和堆栈跟踪的检索功能。它支持标准 MCP 协议和 SSE (Server-Sent Events) 传输，适用于需要集成 Sentry 错误监控的开发场景。
View on GitHub
Overview
基本能力
产品定位
MCP Sentry Server 是一个用于集成 Sentry 错误监控的 MCP 服务，旨在通过 MCP 协议提供 Sentry 错误报告和堆栈跟踪的检索功能。
核心功能
- 与 Sentry API 集成，用于错误跟踪和监控
- 支持标准 MCP 协议（stdin/stdout）和 SSE (Server-Sent Events) 传输
- 可配置的 SSE 服务器端口（默认：3579）
- 提供以下 MCP 功能：
sentry-issue: 通过 ID 或 URL 检索 Sentry 问题most-triggered-issue: 从 Sentry 问题列表 URL 中查找影响最多用户的问题get_sentry_issue: 通过 ID 或 URL 检索和分析 Sentry 问题get_sentry_issues_list: 从 URL 检索和分析 Sentry 问题列表
适用场景
- 开发过程中需要集成 Sentry 错误监控的场景
- 需要通过 MCP 协议访问 Sentry 错误报告的自动化流程
- 需要实时监控和检索错误报告的 Web 应用
工具列表
get_sentry_issue: 通过 ID 或 URL 检索和分析 Sentry 问题get_sentry_issues_list: 从 URL 检索和分析 Sentry 问题列表
常见问题解答
- 如何获取 Sentry 认证令牌？ 从 Sentry 账户设置中获取认证令牌。
- 如何自定义 SSE 服务器端口？ 通过环境变量或命令行参数配置端口。
使用教程
使用依赖
- Node.js >= 20.0.0
- pnpm >= 10.5.2
安装教程
- 克隆仓库并安装依赖：
pnpm install
- 创建
.env文件并配置 Sentry 认证令牌：
SENTRY_TOKEN=your_sentry_auth_token_here
运行服务
- 构建项目：
pnpm build
- 运行服务器：
pnpm start
或指定认证令牌和 API 基础地址：
pnpm start --auth-token your_sentry_auth_token_here --api-base your_sentry_api_base_here
- 运行带 SSE 支持的服务器：
pnpm start:sse
访问 SSE 端点：
http://localhost:3579/sse
调试方式
- 开发模式：
pnpm dev
- 运行测试：
pnpm test
- 运行单元测试：
pnpm test test/unit.test.ts
- 运行集成测试：
pnpm test test/integration.test.ts
- 查看测试覆盖率：
pnpm test -- --coverage