remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides GitHub Projects functionality through the MCP interface, allowing management of projects, issues, milestones, sprints, and custom fields using GitHub's GraphQL API
Uses GitHub's GraphQL API to interact with GitHub Projects, handling API integration, rate limits, and optimistic concurrency

GitHub プロジェクトマネージャー MCP サーバー

標準化されたツールとリソースを通じてGitHubプロジェクト機能を提供する、モデルコンテキストプロトコル（MCP）サーバー実装。このサーバーにより、LLMクライアントはMCPインターフェースを介してGitHubプロジェクトをプログラム的に管理できるようになります。

概要

このサーバーは、モデルコンテキストプロトコル（ MCP）を実装し、LLMクライアントにGitHubプロジェクト機能を提供します。MCP仕様に従って状態を維持し、エラーを処理しながら、GitHubのGraphQL APIを介してプロジェクト、マイルストーン、スプリント、メトリクスを管理するためのツールを提供します。

主な特徴

プロジェクト管理
- GitHub プロジェクトの作成と管理 (v2)
- プロジェクトの設定と構成を処理する
- プロジェクトの可視性とアクセスを管理する
プロジェクトリソース
- 問題とマイルストーンの管理
- スプリントの計画と追跡
- カスタムフィールドとビュー
- リソースのバージョン管理とロック
MCP実装
- MCP仕様に完全準拠
- Zod検証による標準化されたツール定義
- リソース状態管理
- プログレッシブレスポンス処理
- 包括的なエラー処理
GitHub 統合
- ページネーションをサポートするGraphQL API統合
- インテリジェントなレート制限処理
- 楽観的同時実行性
- Webhook サポート（予定）

インストール

# Install dependencies
npm install
# or
pnpm install

# Set up environment variables
cp .env.example .env
# Edit .env with your GitHub token and details

構成

必要な環境変数:

GITHUB_TOKEN=your_github_token
GITHUB_OWNER=repository_owner
GITHUB_REPO=repository_name

GitHub トークンには次の権限が必要です。

repo (フルリポジトリアクセス)
project （プロジェクトアクセス）
write:org (組織アクセス)

使用法

# Start the MCP server
npm start

# Run tests
npm test
npm run test:e2e

詳細な使用方法については、ユーザーガイドを参照してください。

建築

サーバーは、明確なレイヤーを持つ Clean Architecture の原則に従います。

ドメイン層: コアエンティティ、リポジトリインターフェース、Zodスキーマ
インフラストラクチャ層: GitHub API の統合と実装
サービス層: ビジネスロジックの調整
MCP レイヤー: ツールの定義とリクエストの処理

詳細なアーキテクチャドキュメントについては、 ARCHITECTURE.md を参照してください。

現在の状況

コア機能

特徴	状態	注記
プロジェクトの作成	✅ 完了	v2プロジェクトの完全サポート
マイルストーン管理	✅ 完了	CRUD操作が実装されました
スプリント計画	✅ 完了	指標の追跡を含む
問題管理	✅ 完了	カスタムフィールドのサポート
リソースのバージョン管理	✅ 完了	楽観的ロックとスキーマ検証
Webhook統合	📅 計画済み	リアルタイム更新

MCP実装

成分	状態	注記
ツール定義	✅ 完了	すべてのコアツールはZod検証で実装されています
リソース管理	✅ 完了	楽観的ロックと関係追跡機能
レスポンス処理	✅ 完了	複数のコンテンツタイプによるリッチコンテンツのフォーマット
エラー処理	✅ 完了	MCP エラーコードへの包括的なエラーマッピング
状態管理	✅ 完了	競合解決とレート制限

特定された機能ギャップ

最近の改善にもかかわらず、次の機能ギャップが依然として存在しており、将来の開発の優先順位が付けられています。

永続キャッシュ戦略:
- ResourceCacheはメモリ内キャッシュを提供しますが、サーバーの再起動後の永続性がありません。
- マルチインスタンス展開では分散キャッシュは利用できません
- メモリ管理のためのキャッシュ削除ポリシーが欠落している
リアルタイムイベント処理:
- GitHub からのリアルタイム更新のための Webhook 統合がない
- クライアント向けのイベントベースのサブスクリプションシステムが欠落している
- ストリーミング更新のサーバー送信イベント (SSE) サポートの欠如
高度な GitHub プロジェクト v2 の機能:
- カスタムフィールドタイプと検証のサポートが限定的
- GitHub の新しい Projects v2 フィールドタイプとの統合が不完全
- 自動化ルール管理の欠如
パフォーマンスの最適化:
- 関連リソースに対するクエリのバッチ処理はありません
- 頻繁にアクセスされるリソースのバックグラウンド更新が失われる
- 関連リソースの不完全なプリフェッチ
データの視覚化とレポート:
- メトリクスの視覚化ジェネレータが組み込まれていない
- レポート生成機能が不足している
- 限定的な時系列データ分析

詳細な実装ステータスについては、 docs/mcp/gaps-analysis.mdを参照してください。

ドキュメント

ユーザーガイド- 詳細な使用方法の説明
アーキテクチャ- システムアーキテクチャと設計
貢献- 開発ガイドライン
MCP ドキュメント- MCP 固有の詳細

発達

テスト

# Unit tests
npm test

# Integration tests
npm run test:integration

# End-to-end tests
npm run test:e2e

コード品質

# Lint code
npm run lint

# Type check
npm run type-check

# Format code
npm run format

貢献

開発ガイドラインについてはCONTRIBUTING.md を参照してください。

ライセンス

マサチューセッツ工科大学

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

GitHubプロジェクト、マイルストーン、タスク、スプリントを管理するための包括的なツールを提供します。このサーバーはGitHub Projects V2と緊密に統合されており、自動化されたカンバンワークフロー、スプリント計画、カスタムフィールド管理などの機能を提供します。

mcp-github-project-manager