MCP Tool for GitHub

🚀 GitHub 用 MCP ツール

概要

MCP（Model Context Protocol）ツールは、GitHub リポジトリでモデルコンテキストを管理・追跡するのに役立ちます。モデルのバージョン、データセット、メトリクス、トレーニング設定など、重要な詳細を記録できます。

📦 概要

GitHub 用 MCP ツールは、以下の管理に役立ちます。

• リポジトリ
• ファイル（作成／更新／削除）
• ユーザー情報
• GitHub API リクエスト

✨ 機能

🧑‍💻 1. ユーザー情報

• git_info(username: str)
  • GitHub ユーザーの公開プロフィール情報を取得します。

---

📁 2. リポジトリ管理

• create_repo(repo_name: str, private: bool, description: str)

  • 新しいリポジトリ（プライベート／パブリック）を作成します。

• delete_repo(username: str, repo_name: str)

  • ユーザー名とリポジトリ名を指定して、リポジトリを削除します。

---

📄 3. リポジトリ内のファイル操作

• create_file(...)

  • リポジトリに新しいファイルを追加します。
  • コンテンツは自動的に Base64 エンコードされます。

• update_file(...)

  • 既存のファイルを更新します。
  • GitHub のファイル SHA が必要です。

• delete_file(...)

  • ファイルを削除します。
  • SHA とコミットメッセージが必要です。

---

🔄 4. リクエストユーティリティ

• make_request(...)
  • すべての API 操作（GET、POST、PUT、DELETE）を処理します。
  • GitHub トークンで認証します。
  • 以下のようなさまざまな操作を実行するための一元化されたメソッドです。
    • リポジトリの作成
    • ファイルのアップロード／更新／削除
    • ユーザー／リポジトリデータの取得

---

🔐 5. 認証とセットアップ

• .env ファイルから GitHub トークンを安全に読み込みます。
• 適切なヘッダー（User-Agent、Accept、Authorization）を設定します。
• httpx を使用して、完全に非同期でリクエストを実行します。

---

🧰 前提条件

• ✅ Python 3.7+
• ✅ Git と uv がインストールされていること
• ✅ GitHub Personal Access Token

---

📁 .env ファイルの形式

ルートディレクトリに .env ファイルを作成し、以下を追加します。

GITHUB_TOKEN=your_personal_access_token_here

---

🛠️ セットアップと使用方法

# Clone the Repo
git clone https://github.com/jalaj-pandey/github-mcp-tool.git

# Change Directory
cd github-mcp-tool

# Initialize virtual environment using uv
uv init
uv venv
.venv/Scripts/activate  # Use `source ./venv/bin/activate` on Unix/Mac

# Add dependencies
uv add mcp[cli] httpx python-dotenv

# Start MCP dev server
mcp dev main.py

---