🧠 GitHub MCP Server

一个使用FastMCP构建的轻量级模型上下文协议（MCP）服务器，用于通过与LLM兼容的工具来暴露和自动化GitHub操作。

---

✨ 功能

• ⚙️ 通过MCP工具集成GitHub API
• 🤖 适合与AI代理交互的LLM友好模式
• 🔐 可选的身份验证支持
• 🧩 容易扩展新的GitHub操作

---

🔧 支持的GitHub操作

此服务器当前支持以下作为可调用MCP工具的GitHub功能：

工具名称	描述
get_user_bio	获取用户的简介
get_github_files	从GitHub仓库中递归获取指定路径下的所有文件和目录
get_file_content	从GitHub仓库中获取文件内容
create_pull_request_with_branch	在GitHub上创建一个新的分支并生成拉取请求
create_github_issue	在GitHub仓库上创建一个问题

✅ 可以轻松地通过装饰Python函数为@mcp.tool()添加更多工具。

---

🚀 快速开始

1. 克隆仓库：

   git clone https://github.com/mymadhavyadav07/Github-MCP-server.git
   cd Github-MCP-Server
   

2. 安装依赖项：

   使用uv（推荐用于Python 3.11+）：

   uv venv
   uv pip install -r requirements.txt
   

3. 配置GitHub访问令牌：

   • 创建一个**.env文件，并将.env.example的内容复制到.env**中
   • 将GITHUB_TOKEN替换为你自己的GitHub访问令牌。你可以在这里生成一个

   GITHUB_TOKEN = "<GITHUB_TOKEN>"
   

4. 下载并安装Claude Desktop - Claude Desktop

5. 在Claude中安装MCP服务器：

   • 激活虚拟环境：

   .venv\Scripts\activate
   

   • 最后，在Claude中安装MCP服务器：

   uv run mcp install main.py
   

6. 现在你可以使用这个自定义的Github-MCP-Server在你的Claude Desktop中了

🙌 致谢

FastMCP由@jlowin

GitHub REST API v3

🤝 贡献

欢迎贡献！ 如果你有新的GitHub工具的想法、错误修复或改进，请随意：

1. 打开一个issue

2. 分叉仓库

3. 提交PR 🚀

📫 联系

如有问题或建议，请通过Twitter联系或提出一个issue。 </中文翻译>