gh-board-mcp

GitHub Projects v2 を個人用カンバンボードとして管理する MCP サーバー。実際の Issue にリンクすることなく、アクティビティ（ドラフトアイテム）の作成、列間の移動、優先度の追跡が可能です。

要件

• Node.js >= 18

• project スコープ（細粒度：プロジェクトの読み取り/書き込み）を持つ GitHub パーソナルアクセストークン

Related MCP server: GitHub Projects MCP Server

使用方法

GITHUB_TOKEN=ghp_xxx npx gh-board-mcp

MCP クライアント（例：Claude Code）で次のように設定します：

claude mcp add gh-board-mcp -- env GITHUB_TOKEN=ghp_xxx npx gh-board-mcp

ツール

ステータスと優先度

• create_project は、ステータス = Todo / In Progress / Done、優先度 = Urgent / High / Medium / Low を持つ新しいボードを作成します。

• GitHub テンプレートから作成されたボードは、独自のステータス/優先度オプションを保持します。ボード上に存在する値を渡してください。create_activity、move_activity、list_activities は、不明な値が指定された場合に有効なオプションを報告します。

• カスタム列は API 経由ではサポートされていません（GitHub UI で設定してください）。

注意事項

• 読み取り上限： list_activities と list_projects は 1 回の呼び出しで最大 100 アイテム/プロジェクトを読み取ります。大きなボードでは切り捨てられます。

• 結果整合性： GitHub Projects v2 への書き込みが読み取りに反映されるまでに時間がかかることがあります。create_activity の直後に list_activities を実行しても、新しいアイテムが一時的に表示されない場合があります。

• 作成はアトミックではありません： create_activity は作成前にステータス/優先度オプションを検証するため、不正なオプションを指定しても何も残りません。ただし、作成途中の一時的なネットワークエラーにより、フィールド値が設定されていないドラフトが残る可能性があります。

開発

npm install
npm test
npm run build
npm run dev

ライセンス

MIT