i2crm-mcp 0.1.2__tar.gz

i2crm_mcp-0.1.2/.gitignore

@@ -0,0 +1,29 @@
+__pycache__/
+*.pyc
+.venv/
+
+# Локальные заметки и приватные инструкции агентам: адреса стендов, токены, ТЗ.
+# Строки оставлены, чтобы копия, положенная в репозиторий «на минутку», не уехала
+# в коммит — а из коммита в публичный снимок релиза.
+CLAUDE.local.md
+*.local.md
+NOTES.md
+
+# Артефакты сборки и вывод CI-задания install.
+dist/
+build/
+*.egg-info/
+before.txt
+after.txt
+where.txt
+
+# Настройка сервера, если её случайно создали в рабочей копии: там пользовательский
+# токен i2crm.
+.i2crm-mcp.json
+
+# IDE
+.idea/
+.vscode/
+
+# macOS
+.DS_Store

i2crm_mcp-0.1.2/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Изменения
+
+Формат: SemVer. Minor — новые инструменты, patch — исправления, major — изменение
+ответа или аргументов существующего инструмента так, что ломается рабочий промпт агента.
+
+## 0.1.2 - 2026-09-10
+
+### Изменено
+
+- Публикация в PyPI: `pip install i2crm-mcp` без адреса реестра.
+- Метаданные пакета: ссылки на сайт и AI-документацию, классификаторы Python 3.12 и 3.13.
+- README: убраны ссылки, которые вне репозитория ведут в 404, и абзац про закрытый реестр.
+
+## 0.1.1 - 2026-09-10
+
+### Добавлено
+
+- Лицензия
+
+## 0.1.0 — 2026-09-03
+
+### Добавлено
+
+- Транспорт MCP на стандартной библиотеке: JSON-RPC 2.0 по строкам, методы `initialize`,
+  `tools/list`, `tools/call`, `ping`; согласование версии протокола.
+- Разбор конверта публичного API: успех — `error: false`, отказы разбираются по
+  `data.validation` и `data.status` в типизированные исключения.
+- Настройки: `I2CRM_BASE_URL` и `I2CRM_TOKEN` либо профиль пользователя по соглашению ОС;
+  команды `i2crm-mcp setup`, `where`, `version`.
+- Клиент API: подстановка пользовательского токена и ключа канала, разбор конверта,
+  повтор только чтений — потерянный ответ на отправку не значит, что сообщение не ушло.
+- Загрузка клиентской спеки с хоста и кеш на 10 минут; поиск пути в том виде, в каком его
+  присылает агент, и раскрытие `$ref` с защитой от циклов.
+- Инструменты знания: `i2crm_playbook`, `i2crm_endpoints`, `i2crm_endpoint_get`,
+  `i2crm_schema_get`. Ответ, не влезающий в потолок, сворачивает вложенные схемы до имён
+  и говорит об этом, а не урезается молча.
+- Команда `i2crm-mcp check`: спека читается без токена, поэтому «не тот адрес» и «не тот
+  токен» различимы. Ключи каналов в выводе — маской.
+- Инструменты действий: `i2crm_diagnose`, `i2crm_sources`, `i2crm_targets`,
+  `i2crm_target_create`, `i2crm_target_update`, `i2crm_target_validate`,
+  `i2crm_reply_sources`, `i2crm_send`. Ключ исходящего канала подставляется по номеру
+  канала, а при единственном канале — молча; разрушающих операций нет намеренно.
+- Разрежение запросов: у API своего лимита нет, поэтому паузу держит сам пакет, и
+  отправки разрежены сильнее чтений.
+- Команда `i2crm-mcp listen`: локальный приёмник вебхуков — печатает входящие сообщения,
+  правки и статусы доставки и называет канал по подписи вебхука. Отвечает JSON, а не
+  пустым 200: тело ответа разбирается, и на не-JSON доставка повторяется.

i2crm_mcp-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ИП Слесарев Евгений Владимирович
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

i2crm_mcp-0.1.2/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.5
+Name: i2crm-mcp
+Version: 0.1.2
+Summary: MCP-сервер для публичного API i2crm: отправка и приём сообщений в мессенджерах из ИИ-агента
+Project-URL: Homepage, https://i2crm.ru
+Project-URL: Documentation, https://app.i2crm.ru/api_v1/for-ai
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == 'dev'
+Requires-Dist: ruff==0.16.3; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Provides-Extra: lint
+Requires-Dist: ruff==0.16.3; extra == 'lint'
+Description-Content-Type: text/markdown
+
+# i2crm-mcp
+
+MCP-сервер для публичного API i2crm: отправка и приём сообщений в мессенджерах из
+ИИ-агента — Claude Code, Cursor, VS Code и других совместимых. Разработчик ставит пакет,
+задаёт адрес и токен, подключает сервер к агенту — и собирает интеграцию, спрашивая
+контракт словами, а не вычитывая спеку целиком.
+
+| | |
+|---|---|
+| Версия | 0.1.2 |
+| Требуется | Python 3.11+ |
+| Зависимости | **нет ни одной**, только стандартная библиотека |
+| Транспорт | stdio, сервер работает локально у разработчика |
+| Инструментов | 12 — контракт API и действия в аккаунте |
+
+---
+
+## Состояние
+
+Путь интеграции проходится целиком: агент спрашивает порядок шагов и контракт, смотрит
+каналы, заводит исходящий канал с callback-URL, отправляет текстовое сообщение — и
+`i2crm-mcp listen` показывает, что пришло обратно.
+
+---
+
+## Установка
+
+Пакет лежит в реестре пакетов проекта. Своё окружение — чтобы путь к интерпретатору был
+известен: он понадобится агенту.
+
+```bash
+python -m venv ~/.venvs/i2crm-mcp
+source ~/.venvs/i2crm-mcp/bin/activate      # Windows: %USERPROFILE%\.venvs\i2crm-mcp\Scripts\activate
+pip install i2crm-mcp
+```
+
+`--index-url` подменяет PyPI целиком, и это безопасно ровно потому, что зависимостей у
+пакета нет: резолвить в чужом индексе нечего.
+
+Дальше — адрес и токен i2crm:
+
+```bash
+i2crm-mcp setup     # спросит адрес и токен, сохранит в профиль пользователя
+i2crm-mcp check     # проверит связь: спека читается, токен принят, каналы видны
+i2crm-mcp where     # покажет, откуда взяты настройки, и маску токена
+i2crm-mcp listen    # примет вебхуки и напечатает входящие и статусы доставки
+```
+
+---
+
+## Подключение к агенту
+
+Пример для Claude Code; у Cursor, Windsurf и VS Code свои файлы конфигурации, но поле
+команды в них то же:
+
+```bash
+claude mcp add --scope user i2crm -- ~/.venvs/i2crm-mcp/bin/python -m i2crm_mcp.server
+```
+
+Интерпретатор указывается полным путём — тем, куда поставлен пакет. Агент запускает сервер
+не из вашего шелла: ни `PATH`, ни активированное окружение до него не доходят, и короткое
+`python` найдёт не то.
+
+Настройки сервер берёт из профиля, созданного командой `setup`. Без профиля адрес и токен
+задаются блоком `env` в конфиге агента — `I2CRM_BASE_URL` и `I2CRM_TOKEN`.
+
+---
+
+## Инструменты
+
+**Знание о контракте.** Токен не нужен: спека публична. Нужен только адрес — контракт
+берётся у той установки i2crm, к которой подключён разработчик, и не копируется в пакет.
+
+| Инструмент | Назначение |
+|---|---|
+| `i2crm_playbook` | Порядок интеграции: что делает человек, что агент, чем проверяется |
+| `i2crm_endpoints` | Вся поверхность API за пару килобайт: метод, путь, нужный токен, назначение |
+| `i2crm_endpoint_get` | Контракт одного метода: параметры, тело с раскрытыми схемами, ответы, примеры |
+| `i2crm_schema_get` | Схема по имени — по ней пишется тело запроса и приёмник вебхуков |
+
+**Действия в аккаунте.** Токенов у API два, но агент держит только номер канала: ключ
+исходящего канала инструменты подставляют сами, а при единственном канале берут его молча.
+
+| Инструмент | Назначение |
+|---|---|
+| `i2crm_diagnose` | Проверка подключения: адрес, токен маской, спека, оба списка каналов |
+| `i2crm_sources` | Входящие каналы: какие мессенджеры подключены и от какого аккаунта отвечать |
+| `i2crm_targets` | Исходящие каналы: номер, тип, активность, ключ |
+| `i2crm_target_create` | Создать исходящий канал с callback-URL и получить его ключ |
+| `i2crm_target_update` | Переставить callback-URL, переименовать, включить или выключить |
+| `i2crm_target_validate` | Канал жив и ключ принимается |
+| `i2crm_reply_sources` | Через что этот канал может отвечать: `domain`, `type`, `source`, шаблоны |
+| `i2crm_send` | Отправить текстовое сообщение клиенту |
+
+Спросите агента обычными словами:
+
+> проверь подключение к i2crm и покажи, через какие каналы можно ответить
+
+Ответ, который не влезает в потолок, не урезается молча: вложенные схемы сворачиваются до
+имён, и агенту сказано, чем их раскрыть.
+
+---
+
+## Приём вебхуков
+
+Отправку видно по ответу инструмента, а дошло ли сообщение — только по вебхуку. Принять
+его локально можно, не написав обработчика:
+
+```bash
+i2crm-mcp listen --port 3000     # --raw печатает payload целиком, --once ждёт одно событие
+```
+
+Приёмник слушает только этот компьютер, поэтому наружу его выводит туннель:
+
+```bash
+cloudflared tunnel --url http://localhost:3000
+```
+
+Полученный адрес ставится каналу с путём — `https://ваш-туннель/i2crm` — иначе i2crm его
+не примет: требуется https и непустой путь. Дальше в терминале видно входящие сообщения,
+правки и статусы доставки, а по подписи вебхука названо, какому каналу он адресован.
+
+Два требования i2crm, которые приёмник закрывает сам и о которых стоит знать, когда
+обработчик пишется в своём коде: **ответ обязан быть JSON**, а не просто 200, — тело
+ответа разбирается, и на не-JSON доставка считается неудачной и повторяется; правка ранее
+отправленного сообщения приходит методом `PATCH` на тот же адрес.
+
+Приёмник отладочный: он никого не проверяет, ничего не хранит и не годится на роль
+рабочего обработчика.
+
+---
+
+## Границы
+
+- **Разрушающих операций нет вообще** — ни удаления канала, ни удаления сообщений. Агент
+  не может снести рабочий канал, даже если его попросить.
+- **Подключение мессенджеров не автоматизируется**: QR и вход по коду интерактивны, это
+  делает человек в личном кабинете. Инструменты только показывают состояние.
+- **Переписка не читается**: клиентская спека скрывает эту часть API, набор инструментов
+  повторяет её границу, а не расширяет.
+- **Запросы разрежаются на нашей стороне**: своего лимита у API нет, и агент в цикле —
+  единственное, что может выжечь аккаунт отправками.
+- **Токен не светится**: в профиле с правами только владельцу, в выводе — маской, в
+  stdout — ничего кроме протокола. Ключи каналов инструменты агенту показывают: без них
+  он не напишет код, который ходит в API сам. В терминале (`check`) они маской.
+
+---
+
+## Настройки
+
+Адрес и токен берутся из двух мест, окружение перебивает профиль:
+
+| Что | Переменная | Профиль |
+|---|---|---|
+| Адрес i2crm | `I2CRM_BASE_URL` | пишется командой `setup` |
+| Токен пользователя | `I2CRM_TOKEN` | там же |
+
+Профиль лежит по соглашению ОС — `%APPDATA%\i2crm-mcp\config.json` на Windows,
+`~/.config/i2crm-mcp/config.json` на macOS и Linux — и читается только владельцем.
+Переопределяется переменной `I2CRM_MCP_CONFIG`.
+
+Адреса по умолчанию нет намеренно: каждая установка i2crm отвечает на своём хосте, и
+угаданный адрес — это токен, отправленный туда, куда сегодня резолвится это имя. Адрес и
+токен показаны в личном кабинете, на странице настройки API.
+
+---
+
+## Разработка
+
+Свой протокол MCP на стандартной библиотеке (`protocol.py`), 249 тестов без обращений к
+сети, ruff и сборка пакета — на каждый коммит.
+
+Разработка ведётся в приватном репозитории i2crm; порядок правки и выпуска описан там же,
+в `CONTRIBUTING.md`.

i2crm_mcp-0.1.2/README.md

@@ -0,0 +1,174 @@
+# i2crm-mcp
+
+MCP-сервер для публичного API i2crm: отправка и приём сообщений в мессенджерах из
+ИИ-агента — Claude Code, Cursor, VS Code и других совместимых. Разработчик ставит пакет,
+задаёт адрес и токен, подключает сервер к агенту — и собирает интеграцию, спрашивая
+контракт словами, а не вычитывая спеку целиком.
+
+| | |
+|---|---|
+| Версия | 0.1.2 |
+| Требуется | Python 3.11+ |
+| Зависимости | **нет ни одной**, только стандартная библиотека |
+| Транспорт | stdio, сервер работает локально у разработчика |
+| Инструментов | 12 — контракт API и действия в аккаунте |
+
+---
+
+## Состояние
+
+Путь интеграции проходится целиком: агент спрашивает порядок шагов и контракт, смотрит
+каналы, заводит исходящий канал с callback-URL, отправляет текстовое сообщение — и
+`i2crm-mcp listen` показывает, что пришло обратно.
+
+---
+
+## Установка
+
+Пакет лежит в реестре пакетов проекта. Своё окружение — чтобы путь к интерпретатору был
+известен: он понадобится агенту.
+
+```bash
+python -m venv ~/.venvs/i2crm-mcp
+source ~/.venvs/i2crm-mcp/bin/activate      # Windows: %USERPROFILE%\.venvs\i2crm-mcp\Scripts\activate
+pip install i2crm-mcp
+```
+
+`--index-url` подменяет PyPI целиком, и это безопасно ровно потому, что зависимостей у
+пакета нет: резолвить в чужом индексе нечего.
+
+Дальше — адрес и токен i2crm:
+
+```bash
+i2crm-mcp setup     # спросит адрес и токен, сохранит в профиль пользователя
+i2crm-mcp check     # проверит связь: спека читается, токен принят, каналы видны
+i2crm-mcp where     # покажет, откуда взяты настройки, и маску токена
+i2crm-mcp listen    # примет вебхуки и напечатает входящие и статусы доставки
+```
+
+---
+
+## Подключение к агенту
+
+Пример для Claude Code; у Cursor, Windsurf и VS Code свои файлы конфигурации, но поле
+команды в них то же:
+
+```bash
+claude mcp add --scope user i2crm -- ~/.venvs/i2crm-mcp/bin/python -m i2crm_mcp.server
+```
+
+Интерпретатор указывается полным путём — тем, куда поставлен пакет. Агент запускает сервер
+не из вашего шелла: ни `PATH`, ни активированное окружение до него не доходят, и короткое
+`python` найдёт не то.
+
+Настройки сервер берёт из профиля, созданного командой `setup`. Без профиля адрес и токен
+задаются блоком `env` в конфиге агента — `I2CRM_BASE_URL` и `I2CRM_TOKEN`.
+
+---
+
+## Инструменты
+
+**Знание о контракте.** Токен не нужен: спека публична. Нужен только адрес — контракт
+берётся у той установки i2crm, к которой подключён разработчик, и не копируется в пакет.
+
+| Инструмент | Назначение |
+|---|---|
+| `i2crm_playbook` | Порядок интеграции: что делает человек, что агент, чем проверяется |
+| `i2crm_endpoints` | Вся поверхность API за пару килобайт: метод, путь, нужный токен, назначение |
+| `i2crm_endpoint_get` | Контракт одного метода: параметры, тело с раскрытыми схемами, ответы, примеры |
+| `i2crm_schema_get` | Схема по имени — по ней пишется тело запроса и приёмник вебхуков |
+
+**Действия в аккаунте.** Токенов у API два, но агент держит только номер канала: ключ
+исходящего канала инструменты подставляют сами, а при единственном канале берут его молча.
+
+| Инструмент | Назначение |
+|---|---|
+| `i2crm_diagnose` | Проверка подключения: адрес, токен маской, спека, оба списка каналов |
+| `i2crm_sources` | Входящие каналы: какие мессенджеры подключены и от какого аккаунта отвечать |
+| `i2crm_targets` | Исходящие каналы: номер, тип, активность, ключ |
+| `i2crm_target_create` | Создать исходящий канал с callback-URL и получить его ключ |
+| `i2crm_target_update` | Переставить callback-URL, переименовать, включить или выключить |
+| `i2crm_target_validate` | Канал жив и ключ принимается |
+| `i2crm_reply_sources` | Через что этот канал может отвечать: `domain`, `type`, `source`, шаблоны |
+| `i2crm_send` | Отправить текстовое сообщение клиенту |
+
+Спросите агента обычными словами:
+
+> проверь подключение к i2crm и покажи, через какие каналы можно ответить
+
+Ответ, который не влезает в потолок, не урезается молча: вложенные схемы сворачиваются до
+имён, и агенту сказано, чем их раскрыть.
+
+---
+
+## Приём вебхуков
+
+Отправку видно по ответу инструмента, а дошло ли сообщение — только по вебхуку. Принять
+его локально можно, не написав обработчика:
+
+```bash
+i2crm-mcp listen --port 3000     # --raw печатает payload целиком, --once ждёт одно событие
+```
+
+Приёмник слушает только этот компьютер, поэтому наружу его выводит туннель:
+
+```bash
+cloudflared tunnel --url http://localhost:3000
+```
+
+Полученный адрес ставится каналу с путём — `https://ваш-туннель/i2crm` — иначе i2crm его
+не примет: требуется https и непустой путь. Дальше в терминале видно входящие сообщения,
+правки и статусы доставки, а по подписи вебхука названо, какому каналу он адресован.
+
+Два требования i2crm, которые приёмник закрывает сам и о которых стоит знать, когда
+обработчик пишется в своём коде: **ответ обязан быть JSON**, а не просто 200, — тело
+ответа разбирается, и на не-JSON доставка считается неудачной и повторяется; правка ранее
+отправленного сообщения приходит методом `PATCH` на тот же адрес.
+
+Приёмник отладочный: он никого не проверяет, ничего не хранит и не годится на роль
+рабочего обработчика.
+
+---
+
+## Границы
+
+- **Разрушающих операций нет вообще** — ни удаления канала, ни удаления сообщений. Агент
+  не может снести рабочий канал, даже если его попросить.
+- **Подключение мессенджеров не автоматизируется**: QR и вход по коду интерактивны, это
+  делает человек в личном кабинете. Инструменты только показывают состояние.
+- **Переписка не читается**: клиентская спека скрывает эту часть API, набор инструментов
+  повторяет её границу, а не расширяет.
+- **Запросы разрежаются на нашей стороне**: своего лимита у API нет, и агент в цикле —
+  единственное, что может выжечь аккаунт отправками.
+- **Токен не светится**: в профиле с правами только владельцу, в выводе — маской, в
+  stdout — ничего кроме протокола. Ключи каналов инструменты агенту показывают: без них
+  он не напишет код, который ходит в API сам. В терминале (`check`) они маской.
+
+---
+
+## Настройки
+
+Адрес и токен берутся из двух мест, окружение перебивает профиль:
+
+| Что | Переменная | Профиль |
+|---|---|---|
+| Адрес i2crm | `I2CRM_BASE_URL` | пишется командой `setup` |
+| Токен пользователя | `I2CRM_TOKEN` | там же |
+
+Профиль лежит по соглашению ОС — `%APPDATA%\i2crm-mcp\config.json` на Windows,
+`~/.config/i2crm-mcp/config.json` на macOS и Linux — и читается только владельцем.
+Переопределяется переменной `I2CRM_MCP_CONFIG`.
+
+Адреса по умолчанию нет намеренно: каждая установка i2crm отвечает на своём хосте, и
+угаданный адрес — это токен, отправленный туда, куда сегодня резолвится это имя. Адрес и
+токен показаны в личном кабинете, на странице настройки API.
+
+---
+
+## Разработка
+
+Свой протокол MCP на стандартной библиотеке (`protocol.py`), 249 тестов без обращений к
+сети, ruff и сборка пакета — на каждый коммит.
+
+Разработка ведётся в приватном репозитории i2crm; порядок правки и выпуска описан там же,
+в `CONTRIBUTING.md`.

i2crm_mcp-0.1.2/pyproject.toml

@@ -0,0 +1,73 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+# Имя в PyPI — `i2crm-mcp`: его набирает клиент в `uvx` и `pip install`. Репозиторий
+# называется `i2crm-mcp-py`, потому что суффикс различает реализации, а не продукты.
+name = "i2crm-mcp"
+# Версия берётся из src/i2crm_mcp/__init__.py — иначе пакет, тег и ответ сервера в
+# рукопожатии разъезжаются.
+dynamic = ["version"]
+description = "MCP-сервер для публичного API i2crm: отправка и приём сообщений в мессенджерах из ИИ-агента"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+
+# Зависимостей нет ни одной, только стандартная библиотека: пакет ставит внешний
+# разработчик одной командой, и каждая движущаяся часть в ней — вопрос в поддержку.
+# Протокол stdio реализован в `i2crm_mcp/protocol.py`.
+dependencies = []
+
+classifiers = [
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+
+# Единственные ссылки, которые видит человек на странице пакета: репозиторий приватный,
+# и вести на него значит вести на форму входа. Адреса ниже открываются без авторизации.
+[project.urls]
+Homepage = "https://i2crm.ru"
+Documentation = "https://app.i2crm.ru/api_v1/for-ai"
+
+[project.scripts]
+i2crm-mcp = "i2crm_mcp.cli:main"
+
+# Инструменты разработчика — через extras: `pip install .` по-прежнему не тянет ничего,
+# и это проверяет CI. Версия ruff записана здесь одним местом, оттуда же её ставит CI.
+#
+# Таблица идёт после всех простых ключей `[project]`: в TOML она забирает себе все
+# последующие, и `classifiers` после неё ломает сборку метаданных.
+[project.optional-dependencies]
+lint = ["ruff==0.16.3"]
+dev = ["i2crm-mcp[lint]", "build>=1.0", "twine>=5.0"]
+
+[tool.hatch.version]
+path = "src/i2crm_mcp/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/i2crm_mcp"]
+
+# Белый список: это дерево видит внешний мир — и как пакет в PyPI, и как публичный
+# снимок релиза. Внутренние документы (`CONTRIBUTING.md`, `.gitlab-ci.yml`) в него не
+# входят намеренно.
+[tool.hatch.build.targets.sdist]
+include = [
+    "src",
+    "tests",
+    "scripts",
+    "docs",
+    "README.md",
+    "CHANGELOG.md",
+    "pyproject.toml",
+]
+
+[tool.ruff]
+line-length = 110
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]

i2crm_mcp-0.1.2/scripts/check_no_deps.py

@@ -0,0 +1,78 @@
+"""Проверяет, что установка пакета не тянет ничего кроме него самого.
+
+Две проверки, каждая ловит своё: объявленные зависимости (`Requires-Dist` пуст) и
+фактические (разница `pip list` до и после — только наш пакет; так видно зависимость,
+пришедшую через сборку или зашитую в колесо).
+
+Белого списка «ожидаемых» пакетов нет: проверка, краснеющая на чужом пакете из базового
+образа, учит игнорировать красный пайплайн.
+
+Запуск:
+    pip list --format=freeze > before.txt
+    pip install .
+    pip list --format=freeze > after.txt
+    python scripts/check_no_deps.py before.txt after.txt
+"""
+
+from __future__ import annotations
+
+import sys
+from importlib.metadata import PackageNotFoundError, requires
+from pathlib import Path
+
+PACKAGE = "i2crm-mcp"
+
+
+def normalized(name: str) -> str:
+    """Для pip `i2crm_mcp` и `i2crm-mcp` — один пакет, для `!=` — нет."""
+    return name.strip().lower().replace("_", "-")
+
+
+def installed_names(path: Path) -> set[str]:
+    lines = path.read_text(encoding="utf-8").splitlines()
+    return {normalized(line.split("==")[0]) for line in lines if line.strip()}
+
+
+def check_declared() -> list[str]:
+    """Никаких `Requires-Dist`, кроме условных по extra.
+
+    Обещание — «установка сервера не тянет ничего», а не «в метаданных ничего не
+    упомянуто»: инструменты разработчика из extras обычный `pip install .` не ставит.
+    """
+    try:
+        every = requires(PACKAGE) or []
+    except PackageNotFoundError:
+        sys.exit(f"Пакет {PACKAGE} не установлен — проверять нечего.")
+
+    unconditional = [r for r in every if "extra ==" not in r]
+    optional = len(every) - len(unconditional)
+
+    if unconditional:
+        return [f"пакет объявляет зависимости: {', '.join(unconditional)}"]
+    print(f"объявленных зависимостей нет ({optional} только для extras — они не в счёт)")
+    return []
+
+
+def check_actual(before: Path, after: Path) -> list[str]:
+    added = installed_names(after) - installed_names(before)
+    extra = sorted(added - {normalized(PACKAGE)})
+    if extra:
+        return [f"установка притащила лишнее: {', '.join(extra)}"]
+    print(f"установка добавила ровно один пакет: {normalized(PACKAGE)}")
+    return []
+
+
+def main(argv: list[str]) -> int:
+    problems = check_declared()
+    if len(argv) > 2:
+        problems += check_actual(Path(argv[1]), Path(argv[2]))
+    else:
+        print("списки пакетов до/после не переданы — проверена только декларация")
+
+    if problems:
+        sys.exit("Зависимостей быть не должно.\n  " + "\n  ".join(problems))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main(sys.argv))