GitHub MCP Server - Local Docker Setup

GitHub MCP 服务 - 本地 Docker 设置

本仓库提供了一种简单的方式，可通过 Docker Compose 在本地运行 GitHub MCP Server，并通过端口 3000 进行 HTTP 访问。

什么是 GitHub MCP Server？

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

功能

• 轻松设置：只需运行 docker-compose up 即可启动服务
• HTTP 访问：通过端口 3000 上的 HTTP 访问 MCP 服务
• 可配置：支持 GitHub MCP Server 的所有配置选项
• 自动重启：容器发生故障时会自动重启

快速开始

先决条件

• 已安装并运行 Docker
• 已安装 Docker Compose
• 一个 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 上提供。

配置

环境变量

变量	描述	默认值
GITHUB_PERSONAL_ACCESS_TOKEN	你的 GitHub 个人访问令牌	必填
GITHUB_TOOLSETS	要启用的工具集列表，以逗号分隔	all
GITHUB_DYNAMIC_TOOLSETS	启用动态工具集发现（0 或 1）	0
PORT	HTTP 服务端口	3000

可用工具集

• repos - 仓库相关工具（文件操作、分支、提交）
• issues - Issue 相关工具（创建、读取、更新、评论）
• users - 与 GitHub 用户相关的所有功能
• pull_requests - 拉取请求操作（创建、合并、审查）
• code_security - 代码扫描警报和安全功能
• experiments - 实验性功能（不保证稳定）

如需启用特定工具集，请在 .env 文件中设置 GITHUB_TOOLSETS=repos,issues,pull_requests。

使用方法

检查服务状态

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 令牌
• 服务默认运行在 localhost 上，请相应配置防火墙规则

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目采用 MIT 许可证授权，许可证详情请参阅原始 GitHub MCP Server。

相关项目

• GitHub MCP Server - 原始 GitHub MCP Server
• 模型上下文协议 - 进一步了解 MCP