Gooseworks MCP
Gooseworks MCP
Un servidor Express que expone herramientas a través del transporte HTTP Streamable del Model Context Protocol (MCP), incluyendo un conjunto de herramientas de GitHub.
El endpoint MCP es:
http://localhost:4000/mcpCada solicitud debe incluir el token de portador configurado mediante MCP_AUTH_TOKEN.
Requisitos
Node.js
v25.2.1pnpm
11.5.3Docker Engine y Docker Compose v2 para despliegue en contenedores
Un token de acceso personal de GitHub con los permisos requeridos por las herramientas que planeas usar
Related MCP server: GitHub MCP Agent Server
Configuración
El servidor carga variables desde un archivo local .env o del entorno del proceso:
Variable | Requerida | Por defecto | Descripción |
| No |
| Puerto en el que escucha el servidor HTTP |
| Sí | Ninguno | Token de acceso personal de GitHub usado por Octokit |
| Sí | Ninguno | Token de portador requerido para cada solicitud MCP |
Crea un archivo de entorno local a partir de la plantilla:
cp .env.template .envEdita .env y reemplaza ambos valores de token de marcador de posición. Usa un valor largo y generado aleatoriamente para MCP_AUTH_TOKEN, y otorga al token de GitHub solo los permisos necesarios para este servidor. Nunca hagas commit de .env ni pegues ninguno de los tokens en un issue público, registro o imagen.
Ejecutar Localmente
Instala las dependencias:
pnpm installCrea y configura
.envcomo se describió anteriormente.Inicia el servidor:
pnpm startEsto ejecuta el mismo punto de entrada que
pnpm exec tsx src/index.ts.
Para desarrollo con reinicio automático después de cambios en el código fuente, usa:
pnpm devPara verificar el proyecto TypeScript sin generar archivos:
pnpm typecheckEl servidor está listo cuando la consola informa que está activo en http://localhost:<PORT>/mcp. Configura tu cliente MCP para usar esa URL y enviar:
Authorization: Bearer <MCP_AUTH_TOKEN>Desplegar con Docker Compose
Instala Docker Engine con Docker Compose v2 en el host.
Clona este repositorio y entra en su directorio:
git clone <repository-url> cd gooseworks-mcpCrea el archivo de entorno de despliegue:
cp .env.template .envEstablece
GITHUB_TOKENy unMCP_AUTH_TOKENfuerte y privado en.env. EstablecePORTsi el servicio debe escuchar en un puerto diferente del host/contenedor. Se usa el mismo valor para ambos lados del mapeo de puertos de Compose.Construye e inicia el servicio en segundo plano:
docker compose up --build -dSigue los registros del servicio o detenlo cuando sea necesario:
docker compose logs -f gooseworks-mcp docker compose down
La configuración de Compose pasa las tres variables soportadas al contenedor y falla temprano si falta alguno de los tokens requeridos. Para un despliegue público, coloca el servicio detrás de un proxy inverso HTTPS y mantén el puerto 4000 o tu PORT elegido privado cuando sea posible. Los clientes MCP deben usar la URL HTTPS /mcp del proxy y el token de portador configurado.
Herramientas Disponibles
El servidor registra las siguientes herramientas:
GitHub
Lectura del perfil autenticado
Listado de repositorios, ramas y commits
Búsqueda de código
Lectura de contenido de archivos
Creación de issues
Creación de pull requests
Licencia
Este proyecto está licenciado bajo la Licencia MIT. Es libre de usar, bifurcar, modificar y redistribuir para cualquier propósito, sujeto a los términos de la licencia.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
GitHub Copilot MCP: code, repo, PR, workflow tools for AI assistants.
An MCP server that gives your AI access to the source code and docs of all public github repos
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol (MCP) application for automated GitHub PR analysis and issue management.…
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceModel Context Protocol server that enables interaction with GitHub repositories, issues, pull requests, and search functionality through natural language.1-
- AlicenseBqualityCmaintenanceMCP server that exposes GitHub operations as tools for AI agents, enabling code search, issue management, and PR review.1236 PyPIMIT
- AlicenseBqualityDmaintenanceMCP (Model Context Protocol) server for GitHub API integration. This server provides comprehensive tools for interacting with GitHub repositories, issues, pull requests, branches, and code search through a unified interface.157 npmMIT
- FlicenseNot gradedqualityAmaintenanceA GitHub MCP server that wraps the gh CLI to expose GitHub operations like issues, pull requests, branches, labels, repositories, CI actions, and Projects V2 as tools for MCP clients.-