以下是mcp-sentry-custom项目的 README.md 的修订和完善版本，格式经过适当调整，清晰、正确且专业。它遵循 Markdown 标准规范，并将内容组织成合理的章节。
mcp-sentry-custom：Sentry MCP 服务器
概述
mcp-sentry-custom是一个模型上下文协议 (MCP) 服务器，旨在检索和分析来自Sentry.io或自托管 Sentry 实例的问题。此服务器提供一些工具，可直接从您的 Sentry 帐户检查错误报告、堆栈跟踪和其他调试信息。
特征
工具
get_sentry_issue- 描述：通过 ID 或 URL 检索并分析特定的 Sentry 问题。
- 输入：
issue_id_or_url （字符串）：要分析的 Sentry 问题 ID 或完整 URL。
- 返回：详细的问题信息，包括：
- 标题
- 问题 ID
- 地位
- 等级
- 首次出现时间戳
- 上次上线时间戳
- 事件计数
- 完整堆栈跟踪
get_list_issues- 描述：检索并分析特定项目的 Sentry 问题列表。
- 输入：
project_slug （字符串）：Sentry 项目 slug。organization_slug （字符串）：Sentry 组织 slug。
- 返回：包含详细信息的问题列表，包括：
- 标题
- 问题 ID
- 地位
- 等级
- 首次出现时间戳
- 上次上线时间戳
- 事件计数
- 基本问题信息
提示
sentry-issue- 描述：从 Sentry 检索格式化的问题详细信息以用于对话上下文。
- 输入：
issue_id_or_url （字符串）：Sentry 问题 ID 或 URL。
- 返回：格式化的问题详情。
安装
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装mcp-sentry-custom ：
npx -y @smithery/cli install @javaDer/mcp-sentry-custom --client claude
使用uv （推荐）
使用uv时，无需特殊安装。你可以直接使用uvx运行mcp-sentry-custom ：
uvx mcp-sentry-custom --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG --sentry-url YOUR_SENTRY_URL
使用pip
或者，通过pip安装mcp-sentry-custom ：
pip install mcp-sentry-custom
或者，使用uv ：
安装后，以脚本形式运行：
配置
与 Claude Desktop 一起使用
将以下内容添加到您的claude_desktop_config.json中：
使用uvx
{
"mcpServers": {
"sentry": {
"command": "uvx",
"args": [
"mcp-sentry-custom",
"--auth-token", "YOUR_SENTRY_TOKEN",
"--project-slug", "YOUR_PROJECT_SLUG",
"--organization-slug", "YOUR_ORGANIZATION_SLUG",
"--sentry-url", "YOUR_SENTRY_URL"
]
}
}
}
使用 Docker
{
"mcpServers": {
"sentry": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"mcp/sentry",
"--auth-token", "YOUR_SENTRY_TOKEN",
"--project-slug", "YOUR_PROJECT_SLUG",
"--organization-slug", "YOUR_ORGANIZATION_SLUG",
"--sentry-url", "YOUR_SENTRY_URL"
]
}
}
}
使用pip安装
{
"mcpServers": {
"sentry": {
"command": "python",
"args": [
"-m", "mcp_sentry",
"--auth-token", "YOUR_SENTRY_TOKEN",
"--project-slug", "YOUR_PROJECT_SLUG",
"--organization-slug", "YOUR_ORGANIZATION_SLUG",
"--sentry-url", "YOUR_SENTRY_URL"
]
}
}
}
与 Zed 一起使用
将以下内容添加到 Zed 中的settings.json中：
使用uvx
{
"context_servers": {
"mcp-sentry-custom": {
"command": {
"path": "uvx",
"args": [
"mcp-sentry-custom",
"--auth-token", "YOUR_SENTRY_TOKEN",
"--project-slug", "YOUR_PROJECT_SLUG",
"--organization-slug", "YOUR_ORGANIZATION_SLUG",
"--sentry-url", "YOUR_SENTRY_URL"
]
}
}
}
}
使用pip安装
{
"context_servers": {
"mcp-sentry-custom": {
"command": "python",
"args": [
"-m", "mcp_sentry",
"--auth-token", "YOUR_SENTRY_TOKEN",
"--project-slug", "YOUR_PROJECT_SLUG",
"--organization-slug", "YOUR_ORGANIZATION_SLUG",
"--sentry-url", "YOUR_SENTRY_URL"
]
}
}
}
使用自定义路径的pip安装
{
"context_servers": {
"mcp-sentry-custom": {
"command": "python",
"args": [
"-m", "mcp_sentry",
"--auth-token", "YOUR_SENTRY_TOKEN",
"--project-slug", "YOUR_PROJECT_SLUG",
"--organization-slug", "YOUR_ORGANIZATION_SLUG",
"--sentry-url", "YOUR_SENTRY_URL"
],
"env": {
"PYTHONPATH": "path/to/mcp-sentry-custom/src"
}
}
}
}
调试
使用 MCP 检查器调试服务器。
对于uvx安装
npx @modelcontextprotocol/inspector uvx mcp-sentry-custom --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG --sentry-url YOUR_SENTRY_URL
为了地方发展
如果您已将软件包安装在特定目录中或正在开发它：
cd path/to/mcp-sentry-custom/src
npx @modelcontextprotocol/inspector uv run mcp-sentry-custom --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG --sentry-url YOUR_SENTRY_URL
或者，使用自定义目录：
npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-sentry-custom/src run mcp_sentry --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG --sentry-url YOUR_SENTRY_URL
分叉自
该项目分叉自：
https://github.com/modelcontextprotocol/servers/tree/main/src/sentry
执照
此 MCP 服务器采用MIT 许可证。您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详细信息，请参阅项目仓库中的LICENSE文件。
变更说明
- 格式：使用适当的 Markdown 标题、列表和代码块以提高可读性。
- 一致性：标准化术语（例如，
mcp_sentry与mcp-sentry-custom ）并删除冗余的<TEXT>和<JSON>标签。 - 清晰度：重写了“概述”和“功能”等部分，使其简洁、准确。
- 完整性：修复不完整的句子并确保所有配置示例都结构正确。
- 专业语气：调整措辞，使其听起来更加正式和优雅。
如果您想要进一步改进，请告诉我！