Easy MCP Github Tools Python

🚀 GitHub API インターフェースラッパー

このプロジェクトは、Python で開発された GitHub API インターフェースのラッパーツールです。ユーザーに GitHub の様々な機能を簡単に呼び出せるインターフェースを提供することを目的としています。

✨ 主な機能

• GitHub公式ドキュメントに完全に基づいて実装されています。
• ほぼすべての GitHub REST API 機能をサポートしています。
• ユーザーの認証と承認機能を提供します。
• Python で記述されており、互換性が高いです。

🚀 クイックスタート

📦 インストール

このプロジェクトをデプロイするには、以下の手順に従ってください。

git clone https://github.com/yourusername/YourProject.git
cd YourProject
pip install -r requirements.txt
python app.py

💻 使用例

基本的な使用法

新しいリポジトリを作成するサンプルコードです。

from your_module import GitHubAPI

gh = GitHubAPI(token="your_token_here")
response = gh.create_repository(name="new-repo", description="This is a new repository")
print(response.status_code)
print(response.json())

高度な使用法

ユーザー情報を取得するサンプルコードです。

from your_module import GitHubAPI

gh = GitHubAPI(token="your_token_here")
user_info = gh.get_user_info(username="githubusername")
print(user_info)

📚 ドキュメント

開発手順

ステップ 1: プロジェクトの初期化

1. 新しい Python プロジェクトを作成します。
2. プロジェクトのバージョン管理ツール（Git など）を初期化します。

ステップ 2: 基本フレームワークの構築

1. 必要な依存ライブラリをインストールします。

   pip install requests python-dotenv
   

2. いくつかの定数と設定を保存するための基本的な設定ファイル config.py を作成します。

ステップ 3: API インターフェースのラッパーを実装する

1. GitHub API リクエスト機能をラッパーします。

   • GET リクエスト
   • POST リクエスト
   • PUT リクエスト
   • DELETE リクエスト

2. Token 検証機能を実装し、すべてのリクエストが合法的なアクセストークンを持っていることを確認します。

ステップ 4: コア業務ロジックを開発する

1. ユーザー認証モジュール：

   • OAuth 2.0 承認フローの実装
   • Token の生成と検証

2. API リクエストの処理：

   • GitHub のさまざまな REST API インターフェースをラッパーします。
   • リクエストパラメータを処理します。
   • 標準の JSON 形式のレスポンスを返します。

ステップ 5: ユーザーインターフェースを開発する

1. ユーザーが操作できる簡単な Web インターフェースを作成します。
2. リクエスト結果の可視化表示を実装します。

ステップ 6: テストと最適化

1. 各機能が正常に動作することを確認するための単体テストケースを作成します。
2. コード構造とパフォーマンスを最適化します。

注意事項

⚠️ 重要提示

プロジェクト内のすべてのインターフェースには適切な例外処理が必要です。

⚠️ 重要提示

プロジェクトのログ記録機能が十分に機能していることを確認し、後のデバッグとメンテナンスを容易にしてください。

⚠️ 重要提示

GitHub API のバージョンを定期的に更新し、互換性を維持してください。

ツール説明

すべてのツールの詳細な仕様は、{APP_HOST} パラメータが.env ファイルに設定されているサーバー情報ページで確認できます。

スクリーンショット

サーバー情報ページ：

GitHub アプリ OAuth ページ

認証済みユーザーページ