GitHub仓库管理工具

一个基于MCP协议的GitHub仓库管理工具,允许AI助手创建和删除GitHub仓库。

  • by amanueltefera843110
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 amanueltefera843110/mcp-integration-server

使用说明

GitHub存储库管理器MCP服务器

一个模型上下文协议(MCP)服务器,允许AI助手创建和删除GitHub存储库。

YOUTUBE演示

https://www.youtube.com/watch?v=hujbMUsrPSk&ab_channel=AmanuelTefera

特性

  • ✅ 创建GitHub存储库 具有可定制的设置
  • ✅ 删除GitHub存储库 (永久删除)
  • ✅ 符合MCP协议 -与Claude Desktop和其他MCP客户端配合使用
  • ✅ 简单设置 -只需配置并重新启动您的AI助手
  • ✅ 安全 -对敏感数据使用环境变量

快速开始

1.安装依赖项

pip install -r requirements.txt

2.设置您的GitHub令牌

  1. 首选 GitHub设置>代币
  2. 使用生成新令牌 “回购” 权限
  3. 复制令牌

3.创建环境文件

创建一个 .env 文件与位于同一目录中 simple_mcp_server.py:

# .env file
GITHUB_TOKEN=your_actual_github_token_here

⚠️ 重要提示: 永远不要承诺你的 .env 文件到Git!它包含敏感信息。

4.配置克劳德桌面

  1. 打开: ~/Library/Application Support/Claude/config.json
  2. 将内容替换为:
{
  "darkMode": "dark",
  "scale": 0,
  "mcpServers": {
    "github-repo-creator": {
      "command": "python3",
      "args": ["/path/to/your/simple_mcp_server.py"],
      "env": {}
    }
  }
}

注: 无需设置 GITHUB_TOKEN 在配置中,它是从 .env 文件。

5.重新启动克劳德桌面

  • 退出并重新打开Claude Desktop

6.测试一下!

问克劳德:

  • “你们有什么工具?”
  • “创建一个名为‘我的测试仓库’的仓库”
  • “删除名为“我的测试仓库”的仓库”

可用工具

create_github_repository

创建一个新的GitHub存储库。

参数:

  • name (必填):存储库名称
  • private (可选):将其设为私有(默认值:false)
  • description (可选):存储库描述
  • auto_init (可选):使用README进行初始化(默认值:true)

delete_github_repository

删除现有的GitHub存储库。

参数:

  • name (必填):要删除的存储库名称

文件

  • simple_mcp_server.py -MCP服务器实现
  • requirements.txt -Python依赖关系
  • claude_config_example.json -Claude桌面配置示例
  • .env.example -示例环境文件(复制到 .env 并添加您的令牌)
  • README.md -此文件

安全说明

  • ⚠️ 永远不要承诺你的 .env 文件到Git
  • ⚠️ 永远不要将真正的GitHub令牌提交到Git
  • ⚠️ 存储库删除是永久性的
  • ✅ 对敏感数据使用环境变量
  • ✅ 定期轮换您的代币
  • ✅ 添加 .env 到你的 .gitignore 文件

环境变量

服务器使用这些环境变量:

  • GITHUB_TOKEN -您的GitHub个人访问令牌(必填)

故障排除

“未找到GITHUB_TOKEN”错误

  • 确保您创建了 .env 文件
  • 检查一下 GITHUB_TOKEN=your_token 是在 .env 文件
  • 确保 .env 文件与位于同一目录中 simple_mcp_server.py

“未找到存储库”错误

  • 检查存储库名称是否正确(区分大小写)
  • 确保您的令牌具有正确的权限
  • 验证存储库是否存在于您的帐户中

MCP服务器未加载

  • 检查配置中的文件路径
  • 确保脚本可执行: chmod +x simple_mcp_server.py
  • 配置更改后重新启动Claude Desktop

示例用法

配置后,您可以询问Claude:

  • “创建一个名为“秘密项目”的私有存储库,描述为“我的秘密项目””
  • “创建一个名为“开源工具”的公共存储库”
  • “删除名为‘旧测试仓库’的仓库”
  • “你们有什么工具?”

许可证

许可证

MIT许可证-随意使用和修改!


mcp集成服务器

MCP服务器集成了GitHub仓库、谷歌日历和Gmail。通过JSON-RPC创建/管理仓库、日历事件和电子邮件。