Как внести вклад в MCP с открытым кодом
Как помочь развитию MCP-серверов Atomno MCP: сообщения об ошибках, предложения по функциям, pull-запросы, новые MCP под российские API.
Обновлено:
7 публичных MCP-серверов семьи atomno-mcp-* распространяются под лицензией MIT. Это значит:
- Можно форкать.
- Можно использовать в коммерческих проектах.
- Можно отправлять PR в наш upstream.
- Можно делать вендор-форки и продавать (но мы будем благодарны если останется ссылка на upstream).
Как помочь
1. Bug reports (самое полезное)
Если столкнулись с ошибкой — заведите issue:
github.com/atomno-mcp/mcp-<name>/issues/new
Чек-лист хорошего bug report’а:
- Версия MCP (вывод
uvx atomno-mcp-<name> --version). - AI-IDE и версия (Cursor 0.48, Claude Desktop 0.7.5, и т.д.).
- ОС: macOS / Windows / Linux + версия.
- Что делали: какой prompt, какой тул вызывали.
- Что ожидали: ожидаемый ответ.
- Что получили: actual ответ + лог ошибки (с
--log-level DEBUG).
Без этих данных issue будет долго лежать в очереди — мы не сможем воспроизвести.
2. Feature requests
Тоже через issue того же репозитория. Раздел обсуждений на GitHub выключен, отдельной ссылки на него нет:
github.com/atomno-mcp/mcp-<name>/issues/new
Опишите:
- Какую задачу решаете.
- Какого тула / поля / параметра не хватает.
- Готовы ли сами сделать PR (если да — мы поможем с архитектурой).
3. Pull requests
PR welcome. Перед отправкой:
- Issue должен быть — обсудите изменение перед началом работы.
- Тесты — добавьте на новую функциональность (
pytest,respxдля мокинга httpx). pre-commit— установите хуки (pre-commit install).- Документация — обновите docstring у нового тула, README если нужно.
Структура репо стандартная для всех MCP семьи:
mcp-<name>/
├── apps/mcp-<name>-client/ # open-source часть (PyPI)
│ ├── src/mcp_<name>/
│ │ ├── server.py # FastMCP entrypoint, argparse
│ │ ├── tools.py # async tool functions
│ │ ├── client.py # httpx wrapper
│ │ ├── schemas.py # Pydantic models
│ │ └── errors.py
│ ├── tests/
│ ├── pyproject.toml
│ └── README.md
├── apps/mcp-<name>-server/ # private hosted backend (для open-core)
└── glama.json # для Glama listing
Конвенции — в PRODUCTS/ATOMNO/AGENTS.md §2 (если работаете в нашем
монорепо). Для внешних контрибьюторов — следуйте паттерну существующего кода.
4. Перевод документации
Документация наших MCP сейчас на русском (целевая аудитория). Английский tagline есть, но полноценной EN-доки — нет. PR с переводом приветствуется.
5. Новый MCP под российский API
Если хотите чтобы мы добавили MCP под какой-то российский API (например, под Контур, СБИС,
Интегрум, СПАРК) — напишите на mcp@atomno.com.
Опишите:
- Какой API.
- Зачем нужен MCP (use-cases).
- Готовы ли стать pilot-клиентом.
Если использование — массовое, мы добавим в roadmap. Если нишевое — можем сделать на заказ за
плату (sales@atomno.com).
Что НЕ принимается в PR
- Cosmetic-изменения без функциональности (форматирование, переименование без причины).
- Новые тулы без обсуждения в issue.
- Зависимости без верхней границы версии (
<X+1.0.0обязательно). - Hardcoded токены / endpoints в коде (только через env-vars).
- Слом backward-compat без deprecation-периода.
Code of Conduct
Стандартный — будьте уважительны. Не флейм, не оскорбления, не политика.
Лицензионные нюансы
- MIT для всех 7 публичных клиентов.
- Hosted backend для open-core (
mcp-fns-check-server,mcp-egrul-server, и т.д.) — proprietary, не публикуется на GitHub. - Если в коммерческом проекте используете
atomno-mcp-*— никаких отчислений, ссылок не требуется (но мы будем рады если упомянёте).
Вопросы
- GitHub issues конкретного репозитория.
- Email:
mcp@atomno.com.
Спасибо за интерес!
Частые вопросы
Что приложить к сообщению об ошибке MCP?
Укажите версию пакета, приложение и его версию, ОС, вызванный инструмент, ожидаемый и фактический результат. Добавьте сообщение ошибки и необходимые логи, предварительно удалив ключи и другие секреты.
С чего начать предложение нового инструмента?
Сначала опишите задачу в issue репозитория и обсудите изменение. Для pull request инструкция просит тесты новой функциональности, проверку pre-commit и обновление документации.
Нужен ли доступ к моему ключу для разбора ошибки?
Не передавайте действующий ключ в issue или публичные логи. Оставьте название переменной, версию клиента и обезличенную ошибку: секретные значения для воспроизведения на сайте публиковать не нужно.
Как предложить интеграцию с новой системой?
Опишите задачу, нужные данные или действия и наличие документации API. Вопрос о новом инструменте можно обсудить в репозитории, а заказную интеграцию — через указанные на сайте контакты.
Как передать пример ответа, если в нём есть данные человека?
Оставьте только необходимое для воспроизведения и обезличьте посторонние сведения. Ключи и токены удалите полностью; личные данные не нужны просто для демонстрации формата ошибки.
Куда направить исправление открытого клиента?
На странице выбранного MCP есть ссылка на его GitHub-репозиторий. Используйте соответствующий проект, чтобы описание ошибки или изменение относилось к нужному пакету.
Стоит ли проверять новый инструмент на боевой оплате или записи?
Не начинайте с изменяющих действий. Согласуйте назначение и права инструмента; для действий записи и платежей нужно отдельное разрешение, а пример ошибки не требует реальной операции.
