Claude Code と Codex 向けプラグイン: Pydantic v2 モデル、PEP 544
プロトコル、および GitHub Projects v2 ボード（例:
github.com/users/<owner>/projects/<n>）を管理するための MCP サーバー —
ドラフト版 HTTP QUERY メソッドをファーストクラスでサポート。
server.py MCP server (mcp SDK v2, stdio) — 19 tools, structured output
│ depends on
protocols.py ProjectsBackend / GraphQLTransport (runtime-checkable Protocols)
│ implemented by
service.py GitHubProjectsService — GraphQL over the transport,
project-id + field caching, string→typed field-value coercion
graphql.py GraphQL documents (works for both user and org owners)
http.py QueryClient — HTTP QUERY (draft-ietf-httpbis-safe-method-w-body)
with per-origin capability memory and POST fallback
models.py Frozen Pydantic v2 models, __typename-discriminated unionsMCP レイヤーは ProjectsBackend プロトコルにのみ依存するため、バックエンドは交換可能で、テストは構造的にフェイクで代用されます。
QueryClient は QUERY を楽観的に送信し、Accept-Query アドバタイズメントを記録し、トランスポートエラー時に 1 回再試行し（QUERY は安全かつ冪等）、405/501 ではオリジンごとに恒久的に POST へフォールバックします。つまり、現在の GitHub に対してはそのまま動作し、GitHub が QUERY サポートをリリースすると自動的にアップグレードされます。
Related MCP server: GitHub Project MCP Server
プライマリランタイムは CPython 3.14.7 free-threaded（3.14.7t）です。また、gh CLI が project スコープ付きで認証されている必要があります:
gh auth refresh -s project # grants read + write for Projects v2トークンは GITHUB_TOKEN / GH_TOKEN から解決され、それ以外の場合は gh auth token が使用されます。
uv sync
uv run pytest # 32 tests
uv run gh-projects-mcp # run the server on stdioリポジトリのルートから:
# Claude Code (registered user-wide)
claude mcp add --scope user github-projects -- uv --directory "$PWD" run gh-projects-mcp
# Codex
codex mcp add github-projects -- uv --directory "$PWD" run gh-projects-mcpプラグインマニフェストは .claude-plugin/plugin.json（MCP サーバーは ${CLAUDE_PLUGIN_ROOT} 経由で宣言）と .codex-plugin/plugin.json にあります。両ホスト向けの使用スキルは skills/github-projects/SKILL.md にあります。
ツール | 目的 |
| ユーザー/組織のボード一覧（オプションで検索） |
| オーナー + 番号によるボード |
| 単一選択オプションとイテレーションを含むフィールド |
| コンテンツとフィールド値を持つ項目。保存済みビューのフィルタークエリによる評価も可能 |
| ボードの作成、タイトル/README/可視性/クローズ状態の編集 |
| URL による issue/PR の追加 |
| ドラフト issue の追加 |
| フィールドの設定。値は文字列で、フィールドタイプに応じて変換 — 単一選択とイテレーションは名前でマッチ（ |
| フィールドのクリア |
| 項目のアーカイブまたは削除 |
| 冪等な望ましい状態の調整: フィールドとオプションのエイリアス、意味的に検証されたリーフ/コンテナビュー、順序付けされたカラム、明示的なリタイア、項目メタデータ、エピック/サブ issue 階層、ネイティブ issue 依存関係、レガシー依存関係プローズのクリーンアップ |
| 1 つのイテレーションのステータスカラムビュー（または全項目 + 未計画バケット） |
| ネイティブのサブ issue 階層からのエピックごとの完了ロールアップ |
| 名前、レイアウト、フィルター、順序付けされた表示フィールドを持つ保存済みビュー |
| プロジェクトの長期的なコンテキストトレイル |
This server cannot be deployed
Operate GitHub from your AI assistant: repos, PRs, issues, Actions. Previews and read-only mode.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
