Athena Agent — Live-Erdbeben-Feed

Ein Athena-KI-Agent, der von einem MCP-Server unterstützt wird. Er ruft echte seismische Messwerte aus dem öffentlichen USGS-Feed ab und rendert sie in einem interaktiven Widget im Chat.

Ausführen

npm install
npm start          # http://localhost:8787/mcp

Bevor du Athena anfasst, verifiziere:

npx @modelcontextprotocol/inspector@latest --server-url http://localhost:8787/mcp --transport http

Du solltest ein Tool, get_recent_earthquakes, und eine Ressource, ui://widget/quakes.html, mit dem mimeType text/html+skybridge sehen.

Related MCP server: usgs-earthquakes

Über HTTPS bereitstellen

Athena erfordert HTTPS. Für die Entwicklung:

ngrok http 8787

Registriere den Agenten unter https://athenachat.bot/chatbot/mybots/create und setze die MCP-URL auf https://<your-subdomain>.ngrok.app/mcp — der Pfad /mcp ist erforderlich.

Für eine URL, die die Demo übersteht, pushe dieses Repository und stelle es auf Render oder Railway bereit. Build-Befehl npm install, Start-Befehl npm start. Beide injizieren die Umgebungsvariable PORT, die der Server liest.

Prompts, die das Tool auslösen

• „Zeig mir aktuelle Erdbeben“

• „Gab es heute irgendwelche seismische Aktivität?“

• „Gab es in der letzten Woche große Beben?“

Was das Widget interaktiv macht

Der Zustand übersteht das erneute Rendern über window.openai.setWidgetState.

Anpassung an eine andere Datenquelle

Zwei Stellen ändern sich, beide sind im Code markiert.

1. server.js — die fetchData-Funktion. Gib { items: [...], meta: {...} } zurück. Aktualisiere auch den Tool-Namen, die Beschreibung und inputSchema, damit sie zur neuen Domäne passen.

2. public/widget.html — die render-Funktion und die beiden Steuerungs-Handler.

Alles andere (Transport, Ressourcenregistrierung, CORS, Metadaten) ist domänenunabhängig.

Dinge, die dir Zeit rauben

• window.openai ist undefined → der mimeType der Ressource ist nicht exakt text/html+skybridge.

• callTool tut nichts → dem Tool fehlt _meta["openai/widgetAccessible"]: true.

• Das Widget kann keine API direkt abrufen → das iframe-CSP blockiert es. Rufe serverseitig ab.

• Athena zeigt noch alte Tools → Einstellungen → Konnektoren → Aktualisieren.

• Athenas Dokumentation importiert @modelcontextprotocol/sdk/server/streamable-http.js. Dieser Pfad existiert nicht. Der richtige Pfad ist streamableHttp.js.