Github Project Manager

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

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

🚀 クイックスタート

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

✨ 主な機能

• プロジェクト管理

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

• プロジェクトリソース

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

• MCP 実装

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

• GitHub 統合

  • Zod 検証を伴う GraphQL API 統合
  • 関連リソースの一括クエリ
  • バックグラウンドでのリフレッシュ機能

📦 インストール

依存関係のインストール

npm install mcp-server express graphql axios dotenv

環境変数

プロジェクトのルートディレクトリに .env ファイルを作成します：

PORT=3000
DATABASE_URL=jdbc:mysql://localhost:3306/gpm_mcp?user=root&password=example
GRAPHQL_ENDPOINT=https://api.github.com/graphql

💻 使用例

サーバーの起動

node index.js

API 呼び出しの例

curl または Postman を使用して、http://localhost:3000/api に POST リクエストを送信します：

{
  "tool": {
    "id": "github-projects",
    "name": "GitHub Projects Manager"
  },
  "command": "listProjects",
  "args": {
    "username": "your_github_username",
    "token": "your_github_token"
  }
}

🔧 技術詳細

階層化アーキテクチャ

1. 表現層：ユーザーのリクエストと応答を処理します。
2. 業務ロジック層：プロジェクト管理やデータ処理などの核心機能を実装します。
3. データアクセス層：データベースや GitHub などの外部 API とのやり取りを行います。

主要コンポーネント

• MCPServer：HTTP リクエストを処理し、ツールの命令を解析します。
• ProjectManager：GitHub プロジェクトに関連するすべての操作を担当します。
• DatabaseAdapter：データベースの接続とクエリ機能を提供します。
• GraphQLClient：GitHub GraphQL API の呼び出しをラップします。

システムの現状

実装済みの機能

• MCP プロトコルに基づくツールの定義と実行。
• ユーザー識別子によるデータの分離を伴うマルチテナントサポート。
• デフォルトで有効になっている詳細な監査ログ記録。

今後のタスク

1. 指標とデータ分析機能の実装。
2. 可視化レポート生成器の追加。
3. クエリのバッチ処理を導入したパフォーマンスの最適化。

📚 ドキュメント

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

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

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

開発

テスト

# 単体テスト
npm test

# 統合テスト
npm run test:integration

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

コード品質

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

# 型チェック
npm run type-check

# コーディング規約のチェック
npm run lint

貢献

GitHub プロジェクト管理 MCP サーバーへの貢献を歓迎します！詳細については、コントリビューションガイド を参照してください。以下の項目が含まれています：

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

📄 ライセンス

MIT