MCP Github Project Manager

🚀 GitHub プロジェクト管理 MCP サーバー

このサーバーは、Model Context Protocol (MCP) を実装し、標準化されたツールとリソースを通じて GitHub Projects の機能を提供します。LLM クライアントは、MCP インターフェースを介して GitHub プロジェクトをプログラムで管理することができます。

🚀 クイックスタート

このサーバーは、Model Context Protocol を実装し、LLM クライアントに GitHub Projects の機能を公開します。GitHub の GraphQL API を使用して、プロジェクト、マイルストーン、スプリント、指標を管理し、MCP 仕様に基づいて状態を維持し、エラーを処理します。

✨ 主な機能

• プロジェクト管理

  • GitHub Projects (v2) の作成と管理
  • プロジェクトの設定と構成の処理
  • プロジェクトの可視性とアクセス権限の管理

• プロジェクトリソース

  • イシューとマイルストーンの管理
  • スプリントの計画と追跡
  • カスタムフィールドとビュー
  • リソースのバージョン管理とロック

• MCP 実装

  • 完全な MCP 仕様の準拠
  • Zod 検証による標準化されたツール定義
  • リソースの状態管理
  • 進行中の応答処理
  • 包括的なエラー処理

• GitHub 統合

  • ページングサポート付きの GraphQL API 統合
  • スマートアクセストークン
  • 自動リトライとブレーカー付きの堅牢な HTTP クライアント
  • リソースのレート制限とキューイング

📦 インストール

依存関係のインストール

パッケージ管理ツールを使用して、プロジェクトの依存関係をインストールします。

npm install

または Yarn ユーザーの場合は：

yarn install

設定

config.json ファイルを作成し、以下の内容を追加します。

{
  "github": {
    "clientId": "YOUR_GITHUB_CLIENT_ID",
    "clientSecret": "YOUR_GITHUB_CLIENT_SECRET"
  }
}

💻 使用例

基本的な使用法

サーバーを起動します。

npm start

または Yarn ユーザーの場合は：

yarn start

高度な使用法

ユーザー情報を取得します。

curl http://localhost:3000/api/users

📚 ドキュメント

システムアーキテクチャ

• 階層化アーキテクチャ：保守と拡張が容易な明確な階層構造。
• モジュール化設計：コードの再利用性を高めるために、核心機能を独立したモジュールに分解。
• 依存性注入：依存性注入により、緩く結合されたコンポーネントを実現。

現在の状態分析

実装済みの機能

今後の予定

その他のドキュメント

• ユーザーガイド - 詳細な使用方法
• API リファレンス - 包括的なツールドキュメント
• チュートリアル - ステップバイステップガイド
• サンプル - 一般的なタスクのコード例
• アーキテクチャ - システムアーキテクチャと設計
• コントリビューションガイド - 開発規約

インタラクティブなドキュメント

ブラウザで API エクスプローラー を開き、インタラクティブな API 探索を行います。

🔧 開発

テスト

# 単体テスト
npm test

# 統合テスト
npm run test:integration

# エンドツーエンドテスト
npm run test:e2e

コード品質

# コードのフォーマット
npm run lint

# 型チェック
npm run type-check

# コーディングフォーマット
npm run format

🤝 コントリビューションガイド

私たちは、GitHub Project Manager MCP Server へのコントリビューションを歓迎します！詳細については、コントリビューションガイド を参照してください。

• 開発フロー
• コーディング標準
• テストガイドライン
• ドキュメント作成ガイド

📄 ライセンス

MIT