Atomno labs

Контрибьюция в open-source MCP

Как помочь развитию MCP-серверов Atomno Labs: bug reports, feature requests, pull requests, новые MCP под российские API.

Обновлено:

7 публичных MCP-серверов семьи atomno-mcp-* распространяются под лицензией MIT. Это значит:

  • Можно форкать.
  • Можно использовать в коммерческих проектах.
  • Можно отправлять PR в наш upstream.
  • Можно делать вендор-форки и продавать (но мы будем благодарны если останется ссылка на upstream).

Как помочь

1. Bug reports (самое полезное)

Если столкнулись с ошибкой — заведите issue:

github.com/atomno-labs/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

В discussions:

github.com/atomno-labs/mcp-<name>/discussions/new?category=ideas

Опишите:

  • Какую задачу решаете.
  • Какого тула / поля / параметра не хватает.
  • Готовы ли сами сделать PR (если да — мы поможем с архитектурой).

3. Pull requests

PR welcome. Перед отправкой:

  1. Issue должен быть — обсудите изменение перед началом работы.
  2. Тесты — добавьте на новую функциональность (pytest, respx для мокинга httpx).
  3. pre-commit — установите хуки (pre-commit install).
  4. Документация — обновите 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 (например, под Контур, СБИС, Интегрум, СПАРК) — открывайте issue в meta-репо:

github.com/atomno-labs/mcp-discussions/issues

Опишите:

  • Какой 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 / discussions конкретного репо.
  • Telegram-канал @atomno_pulse.
  • Email: labs@atomno-labs.ru.

Спасибо за интерес!