哨兵-mcp

这是一个远程 MCP 服务器的原型，充当上游 Sentry API 提供商的中间件。

它基于Cloudflare 针对远程 MCP 的工作。

入门

通过访问生产中部署的服务，您将找到需要了解的一切：

https://mcp.sentry.dev

如果您希望做出贡献、了解其工作原理或为自托管 Sentry 运行它，请继续阅读以下内容。

Stdio 与 Remote

虽然此仓库专注于充当 MCP 服务，但我们也支持stdio传输。此功能仍在开发中，但它是在自托管 Sentry 安装中运行 MCP 的最简单方法。

要使用stdout传输，您需要在 Sentry 中创建一个具有必要范围的个人 API 令牌 (PAT)。截至撰写本文时，情况如下：

org:read
project:read
project:write
team:read
team:write
event:read

克隆存储库并按通常方式进行设置：

pnpm install
pnpm build

启动运输：

pnpm start:stdio --access-token=sentry-pat --host=sentry.example.com

注意：您还可以使用环境变量：

SENTRY_AUTH_TOKEN=
SENTRY_HOST=

MCP 检查器

MCP 包含一个检查器，可以轻松测试服务：

pnpm inspector

输入https://[domain].workers.dev/sse (TODO) 并点击“连接”。完成身份验证流程后，您将看到工具正常运行：

从 Claude Desktop 访问远程 MCP 服务器

打开 Claude Desktop 并导航至“设置”，按下⌘ + , （逗号）-> 开发者 -> 编辑配置。这将打开配置文件，该文件控制 Claude 可以访问哪些 MCP 服务器。

将内容替换为以下配置。重启 Claude Desktop 后，将打开一个浏览器窗口，显示您的 OAuth 登录页面。完成身份验证流程，授予 Claude 访问您的 MCP 服务器的权限。授予访问权限后，您就可以使用这些工具了。

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-github-oauth.<your-subdomain>.workers.dev/sse"
      ]
    }
  }
}

当工具（位于🔨下方）出现在界面中时，您可以要求 Claude 使用它们。例如：“您可以使用数学工具将 23 和 19 相加吗？”。Claude 应该会调用该工具并显示 MCP 服务器生成的结果。

本地开发

如果您想迭代和测试您的 MCP 服务器，您可以在本地开发中进行。这需要在 Sentry 中创建另一个 OAuth 应用（设置 => API =>应用程序）：

对于主页 URL，指定http://localhost:8788
对于授权重定向 URI，请指定http://localhost:8788/callback
记下您的客户端 ID 并生成客户端密钥。
使用以下命令在项目根目录中创建.dev.vars文件：

SENTRY_CLIENT_ID=your_development_sentry_client_id
SENTRY_CLIENT_SECRET=your_development_sentry_client_secret

核实

在本地运行服务器，使其在http://localhost:8788上可用

pnpm dev

要测试本地服务器，请在 Inspector 中输入http://localhost:8788/sse并点击“连接”。按照提示操作后，您将能够“列出工具”。

测试

其中包括两个测试套件：基本单元测试和一些评估。

可以使用以下方式运行单元测试：

pnpm test

Evals 需要一个带有一些配置的.env文件：

OPENAI_API_KEY=

完成后，您可以使用以下方式运行它们：

pnpm test

笔记

使用 Claude 和其他 MCP 客户端

使用 Claude 连接到远程 MCP 服务器时，您可能会看到一些错误消息。这是因为 Claude Desktop 尚不支持远程 MCP 服务器，因此有时会出现错误。要验证 MCP 服务器是否已连接，请将鼠标悬停在 Claude 界面右下角的 🔨 图标上。您应该会在那里看到可用的工具。

使用 Cursor 和其他 MCP 客户端

要将 Cursor 连接到您的 MCP 服务器，请选择Type ：“命令”，然后在Command字段中将命令和参数字段组合为一个（例如npx mcp-remote https://<your-worker-name>.<your-subdomain>.workers.dev/sse ）。

请注意，虽然 Cursor 支持 HTTP+SSE 服务器，但它不支持身份验证，因此您仍然需要使用mcp-remote （并使用 STDIO 服务器，而不是 HTTP 服务器）。

您可以通过打开客户端的配置文件、添加用于 Claude 设置相同的 JSON 并重新启动 MCP 客户端，将您的 MCP 服务器连接到其他 MCP 客户端（如 Windsurf）。

Sentry MCP

Integrations