# 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. В репозитории намеренно не публикуются адреса чьих-либо развёрнутых экземпляров.

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

- [Инструкция для ИИ-агентов](AGENTS.md)
- [Настройка собственного MCP-сервера и подключение клиентов](docs/CLIENT_SETUP.md)
- [Индекс инструментов](docs/TOOL_INDEX.md)
- [Модель безопасности](SECURITY.md)

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

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

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

- Для отправки коммитов может требоваться 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](SECURITY.md).

## Лицензия

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