Перейти к основному содержанию

Как внести вклад в 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. Перед отправкой:

  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 (например, под Контур, СБИС, Интегрум, СПАРК) — напишите на 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-репозиторий. Используйте соответствующий проект, чтобы описание ошибки или изменение относилось к нужному пакету.

Стоит ли проверять новый инструмент на боевой оплате или записи?

Не начинайте с изменяющих действий. Согласуйте назначение и права инструмента; для действий записи и платежей нужно отдельное разрешение, а пример ошибки не требует реальной операции.

Просмотр кода

Копируется исходный текст. Переносы меняют только отображение.

Текст

Поиск по сайту

Введите хотя бы два символа.

Tab — переход по ссылкам · Esc — закрыть