mcp-sentry-custom：Sentry MCP 服务器

概述

mcp-sentry-custom 是一个模型上下文协议 (MCP) 服务器，旨在从 Sentry.io 或自托管的 Sentry 实例检索和分析问题。 此服务器提供工具，可直接从您的 Sentry 帐户检查错误报告、堆栈跟踪和其他调试信息。

功能

工具

1. get_sentry_issue

   • 描述: 通过问题 ID 或 URL 检索和分析特定的 Sentry 问题。
   • 输入:
     • issue_id_or_url (字符串): 要分析的 Sentry 问题 ID 或完整 URL。
   • 返回: 详细的问题信息，包括：
     • 标题
     • 问题 ID
     • 状态
     • 级别
     • 首次出现时间戳
     • 最近出现时间戳
     • 事件计数
     • 完整堆栈跟踪

2. get_list_issues

   • 描述: 检索和分析特定项目的 Sentry 问题列表。
   • 输入:
     • project_slug (字符串): Sentry 项目 slug。
     • organization_slug (字符串): Sentry 组织 slug。
   • 返回: 包含详细信息的 Issue 列表，包括：
     • 标题
     • 问题 ID
     • 状态
     • 级别
     • 首次出现时间戳
     • 最近出现时间戳
     • 事件计数
     • 基本问题信息

提示

1. sentry-issue
   • 描述: 从 Sentry 检索格式化的 Issue 详细信息，以用于对话上下文。
   • 输入:
     • issue_id_or_url (字符串): Sentry 问题 ID 或 URL。
   • 返回: 格式化的 Issue 详细信息。

安装

通过 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

Fork 自

此项目 fork 自： https://github.com/modelcontextprotocol/servers/tree/main/src/sentry

许可证

此 MCP 服务器已获得 MIT 许可证 的许可。 您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。

---

更改说明

1. 格式: 使用适当的 Markdown 标题、列表和代码块以提高可读性。
2. 一致性: 标准化术语（例如，mcp_sentry 与 mcp-sentry-custom）并删除冗余的 <TEXT> 和 <JSON> 标签。
3. 清晰度: 重写了“概述”和“功能”等部分，以使其简洁明了。
4. 完整性: 修复了不完整的句子，并确保所有配置示例都已正确构建。
5. 专业语气: 调整措辞，使其听起来更正式和更严谨。

如果您需要进一步的改进，请告诉我！