ギークボットMCP

LLM アプリケーション内で Geekbot データのロックを解除します 🚀

Geekbot MCP（Model Context Protocol）サーバーはブリッジとして機能し、LLMクライアントアプリケーション（Claudeなど）をGeekbotワークスペースに直接接続します。これにより、スタンドアップミーティング、レポート作成、チームメンバーとの会話の中で、自然言語によるシームレスなやり取りが可能になります。

主な機能 ✨

• スタンドアップ情報にアクセス: Geekbot ワークスペース内のすべてのスタンドアップを一覧表示します。📊
• スタンドアップ レポートの取得: 特定のスタンドアップ、ユーザー、または日付範囲のフィルターを使用してレポートを取得します。📄
• チームメンバーを表示: Geekbot で共同作業するメンバーのリストを取得します。👥

インストール💻

Python 3.10+ とuvが必要です。

1. uv をインストールします (まだインストールしていない場合)。
   curl -LsSf https://astral.sh/uv/install.sh | sh
   (詳細なオプションについては、 UV インストール ドキュメントを参照してください。)
2. Geekbot MCPをインストールします。
   uv tool install geekbot-mcp

アップグレード中⬆️

最新バージョンに更新するには:

設定 ⚙️

Geekbot MCP を LLM (例: Claude Desktop) に接続します。

1. Geekbot API キーを取得します。Geekbot API/Webhooks 設定で見つけます🔑。
2. uv実行可能パスを見つけます:
   which uv
3. LLMクライアントアプリケーションを構成する: claude_desktop_config.json (または他のMCPクライアントの同等の構成ファイル)を編集して、Geekbot MCPサーバーを追加します。
   { "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 }
   (クライアント構成の詳細については、 MCP クイックスタートを参照してください。)

使用方法💡

設定が完了すると、LLM クライアント アプリケーションは次のツールとプロンプトにアクセスして、Geekbot データを操作できるようになります。

ツール 🛠️

• list_standups

目的: APIキーでアクセスできるすべてのスタンドアップを一覧表示します。概要を確認したり、特定のスタンドアップIDを見つけたりするのに役立ちます。

プロンプトの例: 「ねえ、私の Geekbot スタンドアップをリストしてもらえますか?」

返されるデータフィールド:

• id : 一意のスタンドアップ識別子。
• name : スタンドアップの名前。
• channel : 関連付けられている通信チャネル (例: Slack チャネル)。
• time : スタンドアップレポートのスケジュールされた時間。
• timezone : スケジュールされた時間のタイムゾーン。
• questions : スタンドアップで尋ねられた質問のリスト。
• participants : スタンドアップに参加しているユーザーのリスト。
• owner_id : スタンドアップ所有者の ID。
• fetch_reports

**目的:**特定のスタンドアップレポートを取得します。スタンドアップ、ユーザー、日付範囲でフィルタリングできます。

プロンプトの例:

• 「Retrospective で昨日送信されたレポートを取得します。」
• 「「Weekly Sync」スタンドアップのユーザー John Doe からのレポートを表示してください。」
• 「2024 年 6 月 1 日以降に Daily Standup スタンドアップに送信されたすべてのレポートを取得します。」

利用可能なフィルター:

• standup_id : 特定のスタンドアップ ID でフィルタリングします。
• user_id : 特定のユーザー ID でレポートをフィルタリングします。
• after : この日付 (YYYY-MM-DD) 以降に送信されたレポートを取得します🗓️。
• before : この日付 (YYYY-MM-DD) より前に送信されたレポートを取得します🗓️。

返されるデータフィールド:

• id : 一意のレポート識別子。
• reporter_name : レポートを送信したユーザーの名前。
• reporter_id : レポートを送信したユーザーの ID。
• standup_id : レポートが属するスタンドアップの ID。
• created_at : レポートが送信されたときのタイムスタンプ。
• content : レポートの実際の回答/内容。
• list_members

目的: Geekbot ワークスペース内でスタンドアップを共有するすべてのチーム メンバーを一覧表示します。

プロンプトの例: 「私の Geekbot ワークスペースのメンバーは誰ですか?」

返されるデータフィールド:

• id : 一意のメンバー識別子。
• name : メンバーのフルネーム。
• email : メンバーのメールアドレス。
• role : Geekbot 内でのメンバーの役割 (例: 管理者、メンバー)。

プロンプト💬

• weekly_rollup_report

**目的:**チームのスタンドアップ応答を要約し、主要な更新を強調し、リスクと軽減戦略を特定し、次のステップの概要を示し、今後のリリースを追跡する包括的な週次ロールアップ レポートを生成します。

引数:

• standup_id : ロールアップ レポートに含めるスタンドアップの ID。

開発🧑‍💻

貢献したり、ローカルでサーバーを実行したりすることに興味がありますか?

開発環境のセットアップ

テストの実行 ✅

貢献中🤝

貢献を歓迎します！リポジトリをフォークし、変更を加えたプルリクエストを送信してください。

ライセンス📜

このプロジェクトはMIT ライセンスに基づいてライセンスされています。

謝辞🙏

• Anthropic Model Context Protocolフレームワークに基づいて構築されています。
• 公式のGeekbot APIを活用します。