GitHub MCP服务器-本地Docker设置
此存储库提供了一种运行 在本地使用Docker Compose，在端口3000上使用HTTP访问。
什么是GitHub MCP服务器？
GitHub MCP服务器是一个 模型上下文协议（MCP） 服务器，提供与GitHub API的无缝集成，为开发人员和工具提供高级自动化和交互功能。
特性
- 轻松设置：快跑
docker-compose up启动服务器 - HTTP访问控制模块：通过端口3000上的HTTP访问MCP服务器
- 可配置的：支持所有GitHub MCP服务器配置选项
- 自动重启：容器在故障时自动重新启动
快速开始
先决条件
- 码头工人 已安装并正在运行
- 安装
- A.
设置
- 克隆此存储库：
git clone https://github.com/shesadri/github-mcp-server-local.git
cd github-mcp-server-local- 创建环境文件：
cp .env.example .env- 配置您的GitHub令牌：
编辑 .env 归档并替换 your_github_token_here 使用您实际的GitHub个人访问令牌。
- 启动服务器：
docker-compose up -d- 访问服务器：
服务器将在以下时间可用 http://localhost:3000
配置
环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
GITHUB_PERSONAL_ACCESS_TOKEN | 您的GitHub个人访问令牌 | 必需 |
GITHUB_TOOLSETS | 以逗号分隔的要启用的工具集列表 | all |
GITHUB_DYNAMIC_TOOLSETS | 启用动态工具集发现（0或1） | 0 |
PORT | HTTP服务器端口 | 3000 |
可用工具集
repos-与存储库相关的工具（文件操作、分支、提交）issues-与问题相关的工具（创建、阅读、更新、评论）users-与GitHub用户相关的任何内容pull_requests-拉取请求操作（创建、合并、审核）code_security-代码扫描警报和安全功能experiments-实验特征（不稳定）
要启用特定的工具集，请设置 GITHUB_TOOLSETS=repos,issues,pull_requests 在你的 .env 文件。
用法
检查服务器状态
curl http://localhost:3000/health发出MCP请求
服务器通过HTTP POST接受MCP协议请求：
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}'Docker命令
启动服务
docker-compose up -d停止服务
docker-compose down查看日志
docker-compose logs -f重建并重新启动
docker-compose down
docker-compose build --no-cache
docker-compose up -d故障排除
检查容器是否正在运行
docker-compose ps查看容器日志
docker-compose logs github-mcp-server
docker-compose logs mcp-http-proxy重置所有内容
docker-compose down -v
docker-compose up -d安全说明
- 确保您的GitHub个人访问令牌安全
- 仅授予用例所需的最小权限
- 考虑将GitHub App令牌用于生产部署
- 默认情况下，服务器在本地主机上运行-适当配置防火墙规则
贡献
欢迎投稿！请随时提交拉取请求。
许可证
此项目根据MIT许可证获得许可-请参阅原始 有关许可证的详细信息。
相关项目
- -原始GitHub MCP服务器
- 模型上下文协议 -了解有关MCP的更多信息