GitFlic MCP Worker

Публичный репозиторий проекта GitFlic MCP для Cloudflare Workers. Задуман как MCP-коннектор к GitFlic REST API через Streamable HTTP.

Статус публикации: неполная.

Важно: на текущий момент в этой публичной репе отсутствует src/index.ts — основной исходный код Worker. Также не опубликован package-lock.json. Поэтому репозиторий пока нельзя считать готовым к сборке или деплою. Не запускай инструкции ниже как готовый способ развернуть работающий сервер, пока исходник и lock-файл не будут добавлены и проверены.

Как устроено развёртывание

Этот репозиторий предназначен для публикации исходного кода и инструкций, а не для предоставления общего публичного MCP-сервиса. После восстановления полного исходного кода каждый пользователь должен будет развернуть собственный экземпляр Worker в своём аккаунте Cloudflare и подключить свой GitFlic API token.

У каждого пользователя будет собственный URL Worker и собственный MCP access token. В репозитории намеренно не публикуются адреса чьих-либо развёрнутых экземпляров.

Related MCP server: github-mcp-gateway

Документация

• Инструкция для ИИ-агентов

• Настройка собственного MCP-сервера и подключение клиентов

• Индекс инструментов

• Модель безопасности

Возможности и ограничения

В прежнем исходном архиве проекта заявлялось 98 MCP-инструментов. Но пока исходник src/index.ts не опубликован в этом репозитории, проверить актуальный состав инструментов непосредственно по публичному коду невозможно. См. индекс инструментов как справочный документ, а не как подтверждение работоспособности текущего репозитория.

В документации исходного проекта были указаны следующие ограничения; их необходимо повторно сверить с опубликованной реализацией после восстановления исходника:

• Для отправки коммитов может требоваться Git transport (HTTPS/SSH), а не REST API.

• Бинарные CI/CD-артефакты могут быть представлены только метаданными и операциями управления.

• Значения CI/CD variables, секретов, API-токенов и deployment tokens не должны извлекаться.

• Загрузка project attachment описывалась как отдельная от Git-репозитория операция с лимитом 10 MB.

• gitflic_unlink_issue_attachment описывалась как операция, способная удалить исходный загруженный файл.

Эти пункты не заменяют проверку реализации и документации GitFlic API.

Текущий состав репозитория

• README.md — описание проекта и текущего статуса публикации.

• wrangler.jsonc — конфигурация Cloudflare Worker.

• package.json — метаданные и команды проекта; зависимости требуют сверки с исходным архивом.

• tsconfig.json — настройки TypeScript.

• .env.example — имена переменных без секретных значений.

• AGENTS.md — правила работы ИИ-агентов.

• SECURITY.md — рекомендации по секретам.

• docs/ — инструкции и справочный индекс инструментов.

Безопасность и личные экземпляры

Каждый пользователь должен разворачивать свой Worker и задавать собственные секреты:

• GITFLIC_TOKEN — личный токен GitFlic API владельца экземпляра.

• MCP_ACCESS_TOKEN — отдельный случайный токен для доступа к MCP endpoint этого экземпляра.

Не используй чужой Worker и не передавай свои токены владельцам сторонних экземпляров. Не помещай реальные значения в код, GitHub, issues, логи или чат. Подробности — в SECURITY.md.

Лицензия

Проект распространяется по лицензии MIT. Разрешено свободно использовать код практически для любых целей, включая личные и коммерческие проекты, изменять его, копировать, распространять, включать в другие проекты и продавать производные продукты. Указывать автора в интерфейсе или запрашивать разрешение не требуется. Единственное основное условие MIT: сохранять текст лицензии и уведомление об авторских правах в копиях или существенных частях проекта. Программа предоставляется «как есть», без гарантий.