使用说明
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令牌
- 首选 GitHub设置>代币
- 使用生成新令牌 “回购” 权限
- 复制令牌
3.创建环境文件
创建一个 .env 文件与位于同一目录中 simple_mcp_server.py:
# .env file
GITHUB_TOKEN=your_actual_github_token_here
⚠️ 重要提示: 永远不要承诺你的 .env 文件到Git!它包含敏感信息。
4.配置克劳德桌面
- 打开:
~/Library/Application Support/Claude/config.json - 将内容替换为:
{
"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创建/管理仓库、日历事件和电子邮件。
