以下是mcp-sentry-custom项目的 README.md 的修订和完善版本，格式经过适当调整，清晰、正确且专业。它遵循 Markdown 标准规范，并将内容组织成合理的章节。
mcp-sentry-custom：Sentry MCP 服务器
概述
mcp-sentry-custom是一个模型上下文协议 (MCP) 服务器，旨在检索和分析来自Sentry.io或自托管 Sentry 实例的问题。此服务器提供一些工具，可直接从您的 Sentry 帐户检查错误报告、堆栈跟踪和其他调试信息。
Related MCP server: Sentry MCP Server
特征
工具
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 ：
uv pip install -e .安装后，以脚本形式运行：
python -m mcp_sentry配置
与 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>标签。清晰度：重写了“概述”和“功能”等部分，使其简洁、准确。
完整性：修复不完整的句子并确保所有配置示例都结构正确。
专业语气：调整措辞，使其听起来更加正式和优雅。
如果您想要进一步改进，请告诉我！