Sentry MCP Server 使用说明
项目简介
本项目是 Sentry 的 Model Context Protocol (MCP) 服务器实现,旨在为 AI 助手提供与 Sentry API 交互的能力。通过此 MCP 服务器,AI 助手可以检索和分析 Sentry 的错误数据,管理项目,并监控应用程序性能。
主要功能点
- 项目管理:列出 Sentry 组织中的项目、创建新项目。
- 问题追踪:检索和分析 Sentry 问题详情、事件详情,通过短ID解析问题。
- 错误监控:列出项目中的错误事件、问题事件,搜索特定文件的错误。
- 性能监控:列出 Sentry 组织中的 Replays (用户会话回放),用于分析用户体验问题。
- Sentry 设置:快速为项目设置 Sentry,获取 DSN 和安装指南。
安装步骤
- 确保已安装 Node.js (v14 或更高版本) 和 npm 或 yarn。
- 克隆此 GitHub 仓库到本地。
- 在终端中进入仓库根目录。
- 运行 'npm install' 安装项目依赖。
服务器配置
要将此 MCP 服务器与 MCP 客户端(如 Claude)配合使用,请在客户端中添加以下服务器配置。
{ "mcpServers": { "sentry": { "command": "npx", "args": ["ts-node", "/path/to/sentry-mcp-ts/index.ts"], "env": { "SENTRY_AUTH": "<YOUR_SENTRY_AUTH_TOKEN>" } } } }
配置参数说明:
- 'server name': 'sentry' (服务器名称,客户端用于标识和调用)
- 'command': 'npx' (运行服务器的命令)
- 'args': '["ts-node", "/path/to/sentry-mcp-ts/index.ts"]' (命令参数,'ts-node' 用于运行 TypeScript 代码,'/path/to/sentry-mcp-ts/index.ts' 请替换为实际仓库 index.ts 文件的绝对路径)
- 'env': '{"SENTRY_AUTH": "<YOUR_SENTRY_AUTH_TOKEN>"}' (环境变量,'SENTRY_AUTH' 是 Sentry API 认证 Token,请替换为您的 Sentry 认证 Token)
基本使用方法
- 启动 MCP 服务器:在仓库根目录运行 'npx ts-node index.ts'。
- 在 MCP 客户端中配置并连接到 'sentry' 服务器。
- 在客户端中使用提供的工具(例如 'list_projects', 'resolve_short_id' 等)与 Sentry 进行交互。工具的具体使用方法和参数请参考每个工具的描述信息。
注意: 使用前请确保已在 Sentry 账户中生成 API 访问 Token,并赋予 Token 相应的权限。
信息
分类
开发者工具