Pygithub

🚀 PyGithub MCP サーバ

PyGithub MCP Server は、Python ベースの GitHub API 操作フレームワークです。開発者に GitHub プラットフォームとの簡単なインターフェースを提供することを目的としています。このプロジェクトはモジュール化設計を採用し、さまざまな GitHub 機能をサポートし、安定性と信頼性を確保するために詳細なドキュメントとテストセットを提供しています。

🚀 クイックスタート

このセクションでは、PyGithub MCP サーバの基本的な使い方を説明します。

✨ 主な機能

• モジュール化設計により、拡張性が高い。
• 多様な GitHub 機能をサポート。
• 詳細なドキュメントとテストセットで安定性と信頼性を保証。

📦 インストール

MCP パッケージマネージャを使用したインストール

uv add pygithub-mcp-server

ソースコードからのコンパイルとインストール

1. リポジトリをクローンします：

   git clone https://github.com/your-username/pygithub-mcp-server.git
   cd pygithub-mcp-server
   

2. 依存関係をインストールします：

   uv install
   

💻 使用例

基礎的な使用法

GitHub トークンの設定

1. 環境変数を設定します：

   export GITHUB_PERSONAL_ACCESS_TOKEN=your-token-here
   

2. コード内でトークンを使用します：

   from pygithub_mcp_server.client import GithubClient
   
   client = GithubClient()
   

📚 ドキュメント

プロジェクトのドキュメントは GitHub Pages でホストされており、詳細な API ドキュメントと使用ガイドが含まれています。

🔧 技術詳細

開発ガイド

設定

MCP パッケージマネージャを使用した設定

1. 開発環境を起動します：

   uv run pygithub-mcp-server
   

2. Web インターフェースにアクセスしてツールの登録とテストを行います。

手動設定

1. 仮想環境を作成してアクティブ化します：

   python -m venv .venv
   source .venv/bin/activate  # Windows の場合は .venv\Scripts\activate を使用
   

2. 依存関係をインストールします：

   pip install -r requirements.txt
   

ツールの登録

1. 新しいツールファイルを作成します：

   # src/pygithub_mcp_server/tools/my_tool.py
   from pygithub_mcp_server.tools import Tool
   
   class MyTool(Tool):
       pass
   

2. __init__.py でツールを登録します：

   # src/pygithub_mcp_server/tools/__init__.py
   from .my_tool import MyTool
   

問題解決

1. サーバーの起動に失敗した場合：
   • MCP 設定内の仮想環境のパスが正しいか確認してください。
   • すべての依存関係が現在の環境にインストールされていることを確認してください。
2. ビルドエラーが発生した場合：
   • --no-build-isolation フラグを使用してビルドコマンドを実行してください。
3. GitHub API エラーが発生した場合：
   • トークンの有効性と権限設定を検証してください。

プロジェクト構造

tests/
├── unit/                # 単体テスト、外部依存なし
│   ├── config/          # 設定関連のテスト
│   └── tools/           # ツール登録のテスト
└── integration/         # 統合テスト、実際の GitHub API を使用
    └── issues/          # 問題処理ツールのテスト

src/
├── pygithub_mcp_server/
│   ├── __init__.py
│   ├── server.py        # サーバーファクトリ（サーバーの作成）
│   ├── version.py       # バージョン情報
│   ├── config/          # 設定システム
│   │   └── settings.py  # グローバル設定
│   ├── client/          # GitHub クライアントインターフェース
│   │   └── github.py    # 主要な実装ファイル
│   └── tools/           # ツール拡張ディレクトリ
│       └── __init__.py  # ツール登録ファイル
└── requirements.txt     # プロジェクトの依存関係リスト

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細な条項については LICENSE を参照してください。

PyGithub MCP Server を選んでいただき、ありがとうございます！ご質問やフィードバックがある場合は、GitHub リポジトリ にアクセスするか、メンテナンスチームにご連絡ください。