内容
# 🚀 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 个人访问令牌](https://github.com/settings/tokens)
---
## 📁 .env 文件格式
在根目录中创建 `.env` 文件并添加:
```env
GITHUB_TOKEN=您的个人访问令牌
```
---
## 🛠️ 设置和使用
```bash
# 克隆仓库
git clone https://github.com/jalaj-pandey/github-mcp-tool.git
# 更改目录
cd github-mcp-tool
# 使用 uv 初始化虚拟环境
uv init
uv venv
.venv/Scripts/activate # 在 Unix/Mac 上使用 `source ./venv/bin/activate`
# 添加依赖项
uv add mcp[cli] httpx python-dotenv
# 启动 MCP 开发服务器
mcp dev main.py
```
---