MCP Tool for GitHub

🚀 GitHub MCP 工具

概述

MCP（模型上下文协议）工具可帮助管理和跟踪 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 Token 进行身份验证。
  • 用于执行各种操作的集中式方法，例如：
    • 创建仓库
    • 上传／更新／删除文件
    • 获取用户／仓库数据

---

🔐 5. 身份验证与设置

• 从 .env 文件安全读取 GitHub Token。
• 设置适当的请求头（User-Agent、Accept、Authorization）。
• 使用 httpx 执行完全异步的请求。

---

🧰 前置条件

• ✅ Python 3.7+
• ✅ 已安装 Git 和 uv
• ✅ GitHub 个人访问令牌

---

📁 .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

---