Sentry MCP

🚀 遠程MCP服務器

這是一個遠程MCP服務器的原型，它作為上游Sentry API提供商的中間件發揮作用。該項目基於Cloudflare在遠程MCP方面的工作構建。

🚀 快速開始

你可以通過訪問此鏈接查看入門指南。

✨ 主要特性

Stdio vs 遠程

雖然此倉庫主要用於遠程MCP使用場景，但我們同樣支持stdio傳輸。

⚠️ 重要提示

目前這是一個草稿，還未通過分發可用。你需要確保你的令牌具有必要的作用域，在撰寫本文時為：

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

你可以在源代碼中找到所需作用域的規範參考。

要啟動stdio傳輸，只需綁定SENTRY_AUTH_TOKEN並運行提供的腳本：

SENTRY_AUTH_TOKEN= npm run start:stdio

自託管Sentry

你可以通過覆蓋SENTRY_URL環境變量來設置你自己的Sentry基礎URL：

SENTRY_URL=https://sentry.mycompany.com

MCP Inspector

MCP包含一個Inspector，用於輕鬆測試服務：

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 => 應用程序）：

• 對於Homepage URL，請指定http://localhost:8788
• 對於Authorized Redirect URIs，請指定http://localhost:8788/callback
• 注意你的Client ID並生成一個Client secret。
• 在項目根目錄中創建一個.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

評估需要一個.env文件，其中包含一些配置：

OAUTH_API_KEY=your_oauth_api_key

然後用以下命令運行評估：

pnpm lint

⚠️ 重要提示

評估腳本會檢查代碼質量和格式問題。

📚 詳細文檔

其他注意事項

• 項目使用TypeScript編寫，因此請確保安裝了Node.js和npm。
• 使用pnpm進行依賴管理。如果你不熟悉pnpm，請先閱讀其文檔。
• 項目包含.gitignore文件，以排除不必要的文件和目錄。