Leverages Cloudflare Workers for deployment of the MCP server, using Durable Objects for persistent state management and KV storage for token management
Integrates with GitHub's OAuth services for authentication, enabling secure access to the MCP server through GitHub credentials
Acts as a middleware to the upstream Sentry API provider, allowing AI agents to interact with Sentry's monitoring and error tracking capabilities
Dies ist ein Prototyp eines Remote-MCP-Servers, der als Middleware für den Upstream-Sentry-API-Anbieter fungiert.
Es basiert auf Cloudflares Arbeit an Remote-MCPs .
Alles, was Sie wissen müssen, finden Sie, indem Sie den bereitgestellten Dienst in der Produktion besuchen:
Wenn Sie einen Beitrag leisten, erfahren möchten, wie es funktioniert, oder dies für selbst gehostetes Sentry ausführen möchten, fahren Sie unten fort.
Obwohl dieses Repository hauptsächlich als MCP-Dienst fungiert, unterstützen wir auch einen stdio . Dies ist noch in Arbeit, stellt aber die einfachste Möglichkeit dar, MCP an eine selbstgehostete Sentry-Installation anzupassen.
Um den stdoio Transport zu nutzen, müssen Sie in Sentry einen Personal API Token (PAT) mit den erforderlichen Bereichen erstellen. Zum Zeitpunkt des Schreibens lautet dieser:
Starten Sie den Transport:
Hinweis: Sie können auch Umgebungsvariablen verwenden:
MCP enthält einen Inspector , um den Dienst einfach zu testen:
Geben Sie https://[domain].workers.dev/sse (TODO) ein und klicken Sie auf „Verbinden“. Sobald Sie den Authentifizierungsprozess durchlaufen haben, sehen Sie, wie die Tools funktionieren:
Öffnen Sie Claude Desktop und navigieren Sie zu Einstellungen. Drücken Sie ⌘ + , (Komma) -> Entwickler -> Konfiguration bearbeiten. Dadurch wird die Konfigurationsdatei geöffnet, die steuert, auf welche MCP-Server Claude zugreifen kann.
Ersetzen Sie den Inhalt durch die folgende Konfiguration. Nach dem Neustart von Claude Desktop öffnet sich ein Browserfenster mit Ihrer OAuth-Anmeldeseite. Schließen Sie den Authentifizierungsvorgang ab, um Claude Zugriff auf Ihren MCP-Server zu gewähren. Anschließend stehen Ihnen die Tools zur Verfügung.
Sobald die Tools (unter 🔨) in der Benutzeroberfläche angezeigt werden, können Sie Claude bitten, sie zu verwenden. Beispiel: „Könnten Sie das Mathe-Tool verwenden, um 23 und 19 zu addieren?“ Claude sollte das Tool aufrufen und das vom MCP-Server generierte Ergebnis anzeigen.
Wenn Sie Ihren MCP-Server iterieren und testen möchten, können Sie dies in der lokalen Entwicklung tun. Dazu müssen Sie eine weitere OAuth-App in Sentry erstellen (Einstellungen => API => Anwendungen ):
http://localhost:8788http://localhost:8788/callback.dev.vars Datei in Ihrem Projektstamm mit:Führen Sie den Server lokal aus, um ihn unter http://localhost:8788 verfügbar zu machen
Um den lokalen Server zu testen, geben Sie http://localhost:8788/sse in den Inspector ein und klicken Sie auf „Verbinden“. Sobald Sie den Anweisungen folgen, können Sie die Tools auflisten.
Es sind zwei Test-Suiten enthalten: grundlegende Unit-Tests und einige Auswertungen.
Unit-Tests können mit folgenden Methoden ausgeführt werden:
Für die Evaluierungen ist eine .env Datei mit einigen Konfigurationseinstellungen erforderlich:
Sobald dies erledigt ist, können Sie sie mit folgendem Befehl ausführen:
Wenn Sie Claude verwenden, um eine Verbindung zu Ihrem Remote-MCP-Server herzustellen, werden möglicherweise Fehlermeldungen angezeigt. Dies liegt daran, dass Claude Desktop Remote-MCP-Server noch nicht unterstützt und daher manchmal Verwirrung entsteht. Um zu überprüfen, ob der MCP-Server verbunden ist, bewegen Sie den Mauszeiger über das 🔨-Symbol in der unteren rechten Ecke von Claudes Benutzeroberfläche. Ihre Tools sollten dort verfügbar sein.
Um Cursor mit Ihrem MCP-Server zu verbinden, wählen Sie Type : „Befehl“ und kombinieren Sie im Feld Command “ die Felder „Befehl“ und „Argumente“ zu einem (z. B. npx mcp-remote https://<your-worker-name>.<your-subdomain>.workers.dev/sse ).
Beachten Sie, dass Cursor zwar HTTP+SSE-Server unterstützt, jedoch keine Authentifizierung. Sie müssen daher weiterhin mcp-remote verwenden (und einen STDIO-Server verwenden, keinen HTTP-Server).
Sie können Ihren MCP-Server mit anderen MCP-Clients wie Windsurf verbinden, indem Sie die Konfigurationsdatei des Clients öffnen, dasselbe JSON hinzufügen, das für das Claude-Setup verwendet wurde, und den MCP-Client neu starten.
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Ein Remote-Model-Context-Protocol-Server, der als Middleware für die Sentry-API fungiert und es KI-Assistenten wie Claude ermöglicht, über natürliche Sprachschnittstellen auf Sentry-Daten und -Funktionen zuzugreifen.