ギークボットMCP

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

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

主な機能 ✨

• スタンドアップとアンケートの情報にアクセス: Geekbot ワークスペース内のすべてのスタンドアップとアンケートを一覧表示します。📊

• スタンドアップ レポートと投票結果の取得: 特定のスタンドアップ、ユーザー、または日付範囲のフィルターを使用して、レポートと投票結果を取得します。📄

• チームメンバーの表示: Geekbot で共同作業するメンバーのリストを取得します。👥

• スタンドアップ レポートを投稿する: Geekbot にスタンドアップ レポートを投稿します。📝

Related MCP server: MCP Gemini Server

インストール💻

Smithery経由でインストール

Smithery経由で Geekbot MCP をリモート サーバーとしてインストールするには:

リモート サーバーは、リリースごとに自動的に最新バージョンに更新されます。

Smitheryのデータポリシーに関する詳細情報

手動インストール

Python 3.10+ とuvが必要です。

1. Python 3.10+ をインストールします (まだインストールしていない場合)。

   • macOS:

     brew install python@3.10

     詳細については、 Homebrew Python インストール ガイドを参照してください。

   • Ubuntu/Debian:

     sudo apt update sudo apt install python3.10

   • Windows: Python.orgからダウンロードしてインストールします。

     詳細については、 Windows Python インストール ガイドを参照してください。

2. uv をインストールします (まだインストールしていない場合)。

   • **macOS/Linux:**ターミナルで次のコマンドを実行します。

     curl -LsSf https://astral.sh/uv/install.sh | sh

   • Windows: PowerShell で次のコマンドを実行します。

     powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

   (詳細なオプションについては、 UV インストール ドキュメントを参照してください。)

3. Geekbot MCPのインストール/アップグレード:

   • **macOS/Linux:**ターミナルで次のコマンドを実行します。

     uv tool install --upgrade geekbot-mcp

   • Windows: PowerShell で次のコマンドを実行します。

     uv tool install --upgrade geekbot-mcp

設定 ⚙️

Geekbot MCP をインストールしたら、LLM クライアント デスクトップ アプリケーション (Claude Desktop、Cursor、Windsurf など) に接続できます。

1. Geekbot API キーを取得します。Geekbot API/Webhooks 設定で見つけます🔑。

2. uv

• **Linux/macOS:**ターミナルで、次のコマンドを実行します。

  which uv

• Windows: PowerShell で次のコマンドを実行します。

  (Get-Command uv | Select-Object -ExpandProperty Path) -replace '\\', '\\'

3. LLM クライアント デスクトップ アプリケーションを構成します。MCPをサポートする各 LLM クライアントには、Geekbot MCP サーバーを追加するために編集できる構成ファイルが用意されています。

• クロードデスクトップ

• カーソル

• ウィンドサーフィン

別の LLM クライアントを使用している場合は、クライアントのドキュメントを参照して、MCP サーバーを構成する方法を確認してください。

設定ファイルを見つけたら、それを編集して Geekbot MCP サーバーを追加します。

必ず置き換えてください:

• UV-PATHはステップ 2 のuv実行ファイルへのパスです。

• YOUR-API-KEYステップ1のGeekbot APIキーに置き換えます

使用方法💡

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

ツール 🛠️

list_standups

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

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

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

• id : 一意のスタンドアップ識別子。

• name : スタンドアップの名前。

• channel : 関連付けられている通信チャネル (例: Slack チャネル)。

• time : スタンドアップレポートのスケジュールされた時間。

• timezone : スケジュールされた時間のタイムゾーン。

• questions : スタンドアップで尋ねられた質問のリスト。

• participants : スタンドアップに参加しているユーザーのリスト。

• owner_id : スタンドアップ所有者の ID。

• confidential : スタンドアップが機密かどうか。

• anonymous : スタンドアップが匿名かどうか。

list_polls

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

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

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

• id : 一意のポーリング識別子。

• name : 投票の名前。

• time : 投票の予定時刻。

• timezone : スケジュールされた時間のタイムゾーン。

• questions : アンケートで尋ねられる質問のリスト。

• participants : 投票に参加するユーザーのリスト。

• creator : 投票の作成者。

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 : レポートの実際の回答/内容。

post_report

目的: Geekbot にレポートを投稿します。

プロンプトの例: 「Daily Standup スタンドアップのレポートを投稿してもらえますか?」

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

• id : 一意のレポート識別子。

• reporter_name : レポートを送信したユーザーの名前。

• reporter_id : レポートを送信したユーザーの ID。

• standup_id : レポートが属するスタンドアップの ID。

• created_at : レポートが送信されたときのタイムスタンプ。

• content : レポートの実際の回答/内容。

list_members

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

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

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

• id : 一意のメンバー識別子。

• name : メンバーのフルネーム。

• email : メンバーのメールアドレス。

• role : Geekbot 内でのメンバーの役割 (例: 管理者、メンバー)。

fetch_poll_results

**目的:**特定の投票結果を取得します。投票IDと、オプションで日付範囲を指定する必要があります。

プロンプトの例: 「ねえ、Geekbot の投票で新しいロゴについて何が決まりましたか?」

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

• total_results : 結果の合計数。

• question_results : 質問結果のリスト。

プロンプト💬

weekly_rollup_report

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

ヒント💡

• ツールの使用状況を確認：エージェントがツール操作を行うたびに明示的な承認を求め、自動的なツール呼び出しを許可しないようにします。この安全機能により、特にGeekbotにレポートを送信する際など、機密性の高い操作を確実に制御できます。ツール呼び出しを実行する前に、各ツール呼び出しの確認と承認を求めるプロンプトが表示されるため、意図しないデータの送信を防ぐことができます。

• プレビューを依頼する：レポートを投稿する前に、エージェントにレポートをプレビューするよう依頼してください。ただし、実際には投稿しないでください。これにより、Geekbotに投稿する前にレポートを確認し、正確性を確認したり、修正を加えたりすることができます。

• 取得fetch_reportsデータの量を制限してください。fetch_reportsツールを使用する場合は、日付範囲を適切な期間に制限してください。これにより、エージェントが大量のデータを取得し、パフォーマンスの問題が発生するのを防ぐことができます。エージェントは取得できるレポートの数に制限を設けることにご注意ください。

引数:

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

開発🧑‍💻

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

開発環境のセットアップ

テストの実行 ✅

貢献中🤝

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

ライセンス📜

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

謝辞🙏

• Anthropic Model Context Protocolフレームワークに基づいて構築されています。

• 公式のGeekbot APIを活用します。