MCP Server Sentry - TypeScript 实现

这是一个用 TypeScript 实现的 Model Context Protocol (MCP) 服务器，用于连接到 Sentry 错误跟踪服务。该服务器允许 AI 模型查询和分析 Sentry 上的错误报告和事件。

功能

1. get_sentry_issue 工具

   • 通过 ID 或 URL 检索和分析 Sentry 问题
   • 输入:
     • issue_id_or_url (string): 要分析的 Sentry 问题 ID 或 URL
   • 返回: 问题详情，包括:
     • 标题
     • 问题 ID
     • 状态
     • 级别
     • 首次出现时间戳
     • 最后出现时间戳
     • 事件计数
     • 完整堆栈跟踪

2. sentry-issue Prompt 模板

   • 从 Sentry 检索问题详情
   • 输入:
     • issue_id_or_url (string): Sentry 问题 ID 或 URL
   • 返回: 格式化的issue详情作为对话上下文

安装

# 安装依赖
npm install

# 构建项目
npm run build

配置

服务器使用环境变量进行配置。在项目根目录下创建一个 .env 文件:

# 必需: Sentry 身份验证令牌
SENTRY_AUTH_TOKEN=your_sentry_auth_token

# 可选: Sentry 组织名称
SENTRY_ORGANIZATION_SLUG=your_organization_slug

# 可选: Sentry 项目名称
SENTRY_PROJECT_SLUG=your_project_slug

# 可选: Sentry 基础 URL
SENTRY_BASE_URL=https://sentry.com/api/0

或者，您可以在运行时设置这些环境变量。

运行

通过标准 IO 运行服务器:

node dist/index.js

使用 MCP Inspector 调试:

npx @modelcontextprotocol/inspector node dist/index.js

环境变量描述

• SENTRY_AUTH_TOKEN (必需): 您的 Sentry API 访问令牌
• SENTRY_PROJECT_SLUG (可选): 您的 Sentry 项目的 slug
• SENTRY_ORGANIZATION_SLUG (可选): 您的 Sentry 组织的 slug

如果 URL 中提供了项目和组织信息，则可以省略后两个变量。

许可证

本项目采用 MIT 许可证。