Gooseworks MCP

Express-сервер, который предоставляет инструменты через транспорт Streamable HTTP протокола Model Context Protocol (MCP), включая набор инструментов для GitHub.

Конечная точка MCP:

http://localhost:4000/mcp

Каждый запрос должен включать bearer-токен, заданный в MCP_AUTH_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 и замените оба значения токенов-заполнителей. Используйте длинное случайно сгенерированное значение для MCP_AUTH_TOKEN, а токену GitHub предоставьте только разрешения, необходимые этому серверу. Никогда не коммитьте .env и не вставляйте ни один из токенов в публичные 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 Engine с Docker Compose v2 на хост.

2. Клонируйте этот репозиторий и перейдите в его каталог:

   git clone <repository-url>
   cd gooseworks-mcp

3. Создайте файл окружения для развертывания:

   cp .env.template .env

4. Установите GITHUB_TOKEN и надежный, приватный MCP_AUTH_TOKEN в .env. Установите PORT, если сервис должен слушать на другом порту хоста/контейнера. Одно и то же значение используется для обеих сторон проброса портов в Compose.

5. Соберите и запустите сервис в фоне:

   docker compose up --build -d

6. Следите за логами сервиса или остановите его при необходимости:

   docker compose logs -f gooseworks-mcp
   docker compose down

Конфигурация Compose передает три поддерживаемые переменные в контейнер и завершается с ошибкой на раннем этапе, если отсутствует хотя бы один из обязательных токенов. Для публичного развертывания разместите сервис за обратным прокси с HTTPS и по возможности держите порт 4000 или выбранный PORT закрытым. MCP-клиенты должны использовать HTTPS URL /mcp прокси и настроенный bearer-токен.

Доступные инструменты

Сервер регистрирует следующие инструменты:

GitHub

• Чтение профиля аутентифицированного пользователя

• Список репозиториев, веток и коммитов

• Поиск кода

• Чтение содержимого файлов

• Создание задач (issues)

• Создание pull request'ов

Лицензия

Этот проект лицензирован по лицензии MIT. Он может свободно использоваться, форкаться, изменяться и распространяться для любых целей при соблюдении условий лицензии.