Skip to main content
Glama
Sign In
enesjakozh

mcp-github-project-manager

by kunwarVivek
npmGitHub
TypeScript
MIT License
414
31
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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 エラーコードへの包括的なエラー マッピング
状態管理✅ 完了競合解決とレート制限

最近の改善点

  • 強化されたリソースシステム:
    • すべてのリソースタイプに Zod スキーマ検証を追加しました
    • リソース関係追跡を実装
    • 一貫したリソースアクセスのために集中型の ResourceFactory を作成しました
  • GitHub API統合の改善:
    • 自動スロットリングによるインテリジェントなレート制限を追加
    • RESTおよびGraphQL APIのページネーションサポートを実装しました
    • 特定のエラータイプに対する強化されたエラー処理
  • 高度なツールシステム:
    • Zod検証によるツール定義レジストリの作成
    • 標準化されたツール応答フォーマットを実装
    • すべてのツールに例ベースのドキュメントを追加しました
  • リッチレスポンスフォーマット:
    • 複数のコンテンツ タイプ (JSON、Markdown、HTML、テキスト) のサポートが追加されました
    • 長時間実行される操作の進行状況の更新を実装しました
    • 大規模な結果セットのページ区切りのサポートを追加しました

特定された機能ギャップ

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

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

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

ドキュメント

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

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

発達

テスト

# 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

貢献

GitHub Project Manager MCP Serverへの貢献を歓迎します。詳細については、貢献ガイドをご覧ください。

ライセンス

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

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

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.

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

  1. 概要
    1. 主な特徴
      1. インストール
        1. 構成
          1. 使用法
            1. 建築
              1. 現在の状況
                1. コア機能
                2. MCP実装
                3. 最近の改善点
                4. 特定された機能ギャップ
              2. ドキュメント
                1. インタラクティブドキュメント
              3. 発達
                1. テスト
                2. コード品質
              4. 貢献
                1. ライセンス

                  Related MCP Servers

                  • GitHub MCP Server

                    asbloom-py
                    -
                    security
                    F
                    license
                    -
                    quality
                    Enables interaction with GitHub through the GitHub API, supporting file operations, repository management, advanced search, and issue tracking with comprehensive error handling and automatic branch creation.
                    Last updated -
                    9
                    1
                    TypeScript

                  • DevHub MCP Server

                    peterparker57
                    -
                    security
                    F
                    license
                    -
                    quality
                    Enables management of development projects with GitHub integration, facilitating project tracking, repository linking, and metadata maintenance within the Model Context Protocol.
                    Last updated -
                    3
                    JavaScript

                  • GitHub Kanban MCP Server

                    Sunwood-ai-labs
                    A
                    security
                    A
                    license
                    A
                    quality
                    A Model Context Protocol server that enables efficient management of GitHub issues in a Kanban board format, allowing LLMs to automate task management through GitHub integration.
                    Last updated -
                    4
                    2
                    4
                    TypeScript
                    MIT License

                  • GitHub Projects MCP Server

                    taylor-lindores-reeves
                    A
                    security
                    A
                    license
                    A
                    quality
                    Enables users to interact with GitHub's Projects v2 API through natural language for Agile project management, supporting repository details, issue tracking, and project board management operations.
                    Last updated -
                    31
                    19
                    TypeScript
                    GPL 2.0

                  View all related MCP servers

                  Appeared in Searches

                  New MCP Servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/kunwarVivek/mcp-github-project-manager'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server