Gooseworks MCP

一个通过模型上下文协议（MCP）流式 HTTP 传输暴露工具的 Express 服务器，包含一组 GitHub 工具。

MCP 端点地址为：

http://localhost:4000/mcp

每个请求都必须包含由 MCP_AUTH_TOKEN 配置的 bearer token。

环境要求

• Node.js v25.2.1

• pnpm 11.5.3

• 用于容器部署的 Docker Engine 和 Docker Compose v2

• 一个 GitHub 个人访问令牌，需具备你计划使用的工具所需的权限

Related MCP server: GitHub MCP Agent Server

配置

服务器从本地 .env 文件或进程环境加载变量：

从模板创建本地环境文件：

cp .env.template .env

编辑 .env 并替换两个占位符 token 值。为 MCP_AUTH_TOKEN 使用一个长且随机生成的值，并为 GitHub token 仅授予此服务器所需的权限。切勿提交 .env 或将任一 token 粘贴到公共 issue、日志或图片中。

本地运行

1. 安装依赖：

   pnpm install

2. 按上述说明创建并配置 .env。

3. 启动服务器：

   pnpm start

   这会运行与 pnpm exec tsx src/index.ts 相同的入口点。

开发时如需在源码更改后自动重启，可使用：

pnpm dev

如需检查 TypeScript 项目而不生成文件，执行：

pnpm typecheck

当控制台报告服务器已在 http://localhost:<PORT>/mcp 上激活时，服务即就绪。配置你的 MCP 客户端使用该 URL，并发送：

Authorization: Bearer <MCP_AUTH_TOKEN>

使用 Docker Compose 部署

1. 在主机上安装带有 Docker Compose v2 的 Docker Engine。

2. 克隆此仓库并进入其目录：

   git clone <repository-url>
   cd gooseworks-mcp

3. 创建部署环境文件：

   cp .env.template .env

4. 在 .env 中设置 GITHUB_TOKEN 和一个强且私密的 MCP_AUTH_TOKEN。如果服务应在不同的主机/容器端口上监听，则设置 PORT。该值在 Compose 端口映射的两侧保持一致。

5. 在后台构建并启动服务：

   docker compose up --build -d

6. 查看服务日志，或在需要时停止服务：

   docker compose logs -f gooseworks-mcp
   docker compose down

Compose 配置将三个支持的变量传入容器，若任一必需 token 缺失则提前失败。对于公开部署，应将服务置于 HTTPS 反向代理之后，并尽可能保持端口 4000 或你选择的 PORT 私有。MCP 客户端应使用代理的 HTTPS /mcp URL 和配置的 bearer token。

可用工具

服务器注册了以下工具：

GitHub

• 读取已认证用户的信息

• 列出仓库、分支和提交

• 搜索代码

• 读取文件内容

• 创建 Issue

• 创建 Pull Request

许可证

本项目基于 MIT 许可证 授权。你可以出于任何目的自由使用、复刻、修改和重新分发，但需遵守许可证条款。