Geekbot MCP

Geekbot MCP

Entsperren Sie Ihre Geekbot-Daten in Ihren LLM-Anwendungen 🚀

Der Geekbot MCP-Server (Model Context Protocol) fungiert als Brücke und verbindet LLM-Clientanwendungen (wie Claude) direkt mit Ihrem Geekbot-Arbeitsbereich. So können Sie nahtlos in Ihren Gesprächen mit Ihren Standups, Berichten und Teammitgliedern in natürlicher Sprache interagieren.

Hauptmerkmale ✨

• Zugriff auf Standup-Informationen : Listen Sie alle Standups in Ihrem Geekbot-Arbeitsbereich auf. 📊
• Standup-Berichte abrufen : Rufen Sie Berichte mit Filtern für bestimmte Standups, Benutzer oder Datumsbereiche ab. 📄
• Teammitglieder anzeigen : Erhalten Sie eine Liste der Mitglieder, mit denen Sie in Geekbot zusammenarbeiten. 👥

Installation 💻

Erfordert Python 3.10+ und uv .

1. Installieren Sie uv (falls noch nicht geschehen):
   curl -LsSf https://astral.sh/uv/install.sh | sh
   (Weitere Optionen finden Sie in den UV-Installationsdokumenten .)
2. Installieren Sie Geekbot MCP:
   uv tool install geekbot-mcp

Upgrade ⬆️

So aktualisieren Sie auf die neueste Version:

Konfiguration ⚙️

Verbinden Sie Geekbot MCP mit Ihrem LLM (z. B. Claude Desktop):

1. Holen Sie sich Ihren Geekbot-API-Schlüssel: Sie finden ihn in Ihren Geekbot-API-/Webhook-Einstellungen 🔑.
2. Suchen Sie den Pfad Ihrer uv ausführbaren Datei:
   which uv
3. Konfigurieren Sie Ihre LLM-Clientanwendung: Bearbeiten Sie Ihre claude_desktop_config.json (oder eine entsprechende Konfigurationsdatei für andere MCP-Clients), um den Geekbot MCP-Server hinzuzufügen
   { "globalShortcut": "", "mcpServers": { // Add or update this section "geekbot-mcp": { "command": "<path-returned-by-which-uv>", // Replace with your actual uv path "args": [ "tool", "run", "geekbot-mcp" ], // Environment variables needed by the server "env": { "GB_API_KEY": "<your-geekbot-api-key>" // Replace with your actual API key } } // ... other MCP servers if any } // ... other configurations }
   (Weitere Einzelheiten zur Clientkonfiguration finden Sie im MCP-Quickstart .)

Verwendung 💡

Nach der Konfiguration hat Ihre LLM-Clientanwendung Zugriff auf die folgenden Tools und Eingabeaufforderungen zur Interaktion mit Ihren Geekbot-Daten:

Werkzeuge 🛠️

• list_standups

Zweck: Listet alle Standups auf, die über Ihren API-Schlüssel erreichbar sind. Nützlich, um sich einen Überblick zu verschaffen oder eine bestimmte Standup-ID zu finden.

Beispielaufforderung: „Hey, kannst du meine Geekbot-Standups auflisten?“

Zurückgegebene Datenfelder:

• id : Eindeutige Standup-Kennung.
• name : Name des Standups.
• channel : Zugehöriger Kommunikationskanal (z. B. Slack-Kanal).
• time : Geplante Zeit für den Standup-Bericht.
• timezone : Zeitzone für die geplante Zeit.
• questions : Liste der im Standup gestellten Fragen.
• participants : Liste der Benutzer, die am Standup teilnehmen.
• owner_id : ID des Standup-Eigentümers.
• list_polls

Zweck: Listet alle Umfragen auf, die über Ihren API-Schlüssel erreichbar sind. Nützlich, um sich einen Überblick zu verschaffen oder eine bestimmte Umfrage-ID zu finden.

Beispiel-Eingabeaufforderung: „Hey, kannst du meine Geekbot-Umfragen auflisten?“

Zurückgegebene Datenfelder:

• id : Eindeutige Umfragekennung.
• name : Name der Umfrage.
• time : Geplante Zeit für die Umfrage.
• timezone : Zeitzone für die geplante Zeit.
• questions : Liste der in der Umfrage gestellten Fragen.
• participants : Liste der Benutzer, die an der Umfrage teilnehmen.
• creator : Der Ersteller der Umfrage.
• fetch_reports

Zweck: Ruft bestimmte Standup-Berichte ab. Sie können nach Standup, Benutzer und Datumsbereich filtern.

Beispiel-Eingabeaufforderungen:

• „Holen Sie sich die Berichte für gestern in der Retrospektive ab.“
• „Zeigen Sie mir Berichte von Benutzer John Doe für das Standup ‚Weekly Sync‘.“
• „Alle Berichte, die nach dem 1. Juni 2024 zum Daily Standup-Standup eingereicht werden, erhalten.“

Verfügbare Filter:

• standup_id : Filtern Sie nach einer bestimmten Standup-ID.
• user_id : Filtern Sie Berichte nach einer bestimmten Benutzer-ID.
• after : Berichte abrufen, die nach diesem Datum (JJJJ-MM-TT) übermittelt wurden 🗓️.
• before : Ruft Berichte ab, die vor diesem Datum (JJJJ-MM-TT) übermittelt wurden 🗓️.

Zurückgegebene Datenfelder:

• id : Eindeutige Berichtskennung.
• reporter_name : Name des Benutzers, der den Bericht übermittelt hat.
• reporter_id : ID des Benutzers, der den Bericht übermittelt hat.
• standup_id : ID des Standups, zu dem der Bericht gehört.
• created_at : Zeitstempel, wann der Bericht übermittelt wurde.
• content : Die eigentlichen Antworten/Inhalte des Berichts.
• post_report

Zweck: Postet einen Bericht an Geekbot.

Beispiel-Eingabeaufforderung: „Hey, kannst du den Bericht für das tägliche Standup posten?“

Zurückgegebene Datenfelder:

• id : Eindeutige Berichtskennung.
• reporter_name : Name des Benutzers, der den Bericht übermittelt hat.
• reporter_id : ID des Benutzers, der den Bericht übermittelt hat.
• standup_id : ID des Standups, zu dem der Bericht gehört.
• created_at : Zeitstempel, wann der Bericht übermittelt wurde.
• content : Die eigentlichen Antworten/Inhalte des Berichts.
• list_members

Zweck: Listet alle Teammitglieder auf, mit denen Sie Standups in Ihrem Geekbot-Arbeitsbereich teilen.

Beispiel-Eingabeaufforderung: „Wer sind die Mitglieder in meinem Geekbot-Arbeitsbereich?“

Zurückgegebene Datenfelder:

• id : Eindeutige Mitgliedskennung.
• name : Vollständiger Name des Mitglieds.
• email : E-Mail-Adresse des Mitglieds.
• role : Rolle des Mitglieds innerhalb von Geekbot (z. B. Administrator, Mitglied).
• fetch_poll_results

Zweck: Ruft bestimmte Umfrageergebnisse ab. Erfordert eine Umfrage-ID und optional einen Datumsbereich.

Beispiel-Eingabeaufforderung: „Hey, was wurde in den Geekbot-Umfragen über das neue Logo entschieden?“

Zurückgegebene Datenfelder:

• total_results : Gesamtzahl der Ergebnisse.
• question_results : Liste der Frageergebnisse.

Eingabeaufforderungen 💬

• weekly_rollup_report

Zweck: Generiert einen umfassenden wöchentlichen Rollup-Bericht, der die Standup-Reaktionen des Teams zusammenfasst, wichtige Aktualisierungen hervorhebt, Risiken und Minderungsstrategien identifiziert, die nächsten Schritte skizziert und bevorstehende Produkteinführungen verfolgt.

Argumente:

• standup_id : ID des Standups, das in den Rollup-Bericht aufgenommen werden soll.

Entwicklung 🧑‍💻

Möchten Sie einen Beitrag leisten oder den Server lokal betreiben?

Einrichten der Entwicklungsumgebung

Tests durchführen ✅

Mitwirken 🤝

Beiträge sind willkommen! Bitte forken Sie das Repository und senden Sie einen Pull Request mit Ihren Änderungen.

Lizenz 📜

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

Danksagungen 🙏

• Basierend auf dem Anthropic Model Context Protocol- Framework.
• Nutzt die offizielle Geekbot-API .