GitHub MCP服务器本地Docker部署

GitHub MCP服务器-本地Docker设置

此存储库提供了一种运行 GitHub MCP服务器 在本地使用Docker Compose，在端口3000上使用HTTP访问。

什么是GitHub MCP服务器？

GitHub MCP服务器是一个 模型上下文协议（MCP） 服务器，提供与GitHub API的无缝集成，为开发人员和工具提供高级自动化和交互功能。

特性

• 轻松设置：快跑 docker-compose up 启动服务器
• HTTP访问控制模块：通过端口3000上的HTTP访问MCP服务器
• 可配置的：支持所有GitHub MCP服务器配置选项
• 自动重启：容器在故障时自动重新启动

快速开始

先决条件

• 码头工人 已安装并正在运行
• Docker Compose 安装
• A. GitHub个人访问令牌

设置

1. 克隆此存储库：

   复制

   git clone https://github.com/shesadri/github-mcp-server-local.git
   cd github-mcp-server-local
   

2. 创建环境文件：

   复制

   cp .env.example .env
   

3. 配置您的GitHub令牌： 编辑 .env 归档并替换 your_github_token_here 使用您实际的GitHub个人访问令牌。

4. 启动服务器：

   复制

   docker-compose up -d
   

5. 访问服务器： 服务器将在以下时间可用 http://localhost: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服务器 有关许可证的详细信息。

相关项目

• GitHub MCP服务器 -原始GitHub MCP服务器
• 模型上下文协议 -了解有关MCP的更多信息