Metadata-Version: 2.4
Name: business-mcp-ru
Version: 0.1.0
Summary: Пять MCP-серверов для российских деловых сервисов: hh.ru, VK, Диадок, СБИС, Честный знак
Author: Ilya Utov
License-Expression: MIT
Project-URL: Homepage, https://business-mcp-ru.aifrontier.tech/
Project-URL: Repository, https://github.com/ilyautov/business-mcp-ru
Project-URL: Issues, https://github.com/ilyautov/business-mcp-ru/issues
Keywords: mcp,model-context-protocol,russia,hh,vk,diadoc,sbis,chestny-znak,claude
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: hh-mcp-ru<1,>=0.1
Requires-Dist: vk-mcp-ru<1,>=0.1
Requires-Dist: diadoc-mcp-ru<1,>=0.1
Requires-Dist: sbis-mcp-ru<1,>=0.1
Requires-Dist: chestny-znak-mcp-ru<1,>=0.1
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pyyaml<7,>=6.0; extra == "dev"
Dynamic: license-file

# business-mcp-ru

Пять MCP-серверов для российских деловых сервисов. Каждый живёт своим
репозиторием и ставится отдельно; здесь общий вход, страницы и список.

[![PyPI](https://img.shields.io/pypi/v/business-mcp-ru?label=pypi&color=B5491F)](https://pypi.org/project/business-mcp-ru/)
[![CI](https://github.com/ilyautov/business-mcp-ru/actions/workflows/ci.yml/badge.svg)](https://github.com/ilyautov/business-mcp-ru/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Методов](https://img.shields.io/badge/%D0%BC%D0%B5%D1%82%D0%BE%D0%B4%D0%BE%D0%B2-698-2D7D4F)](#business-mcp-ru)
[![Сайт](https://img.shields.io/badge/%D1%81%D0%B0%D0%B9%D1%82-business--mcp--ru-9A3E1A)](https://business-mcp-ru.aifrontier.tech/)
[![Звёзды](https://img.shields.io/github/stars/ilyautov/business-mcp-ru?style=flat&label=%D0%B7%D0%B2%D1%91%D0%B7%D0%B4%D1%8B&color=B5491F&logo=github&logoColor=white)](https://github.com/ilyautov/business-mcp-ru/stargazers)

| репозиторий | сервис | методов | спрос/мес | страница |
|---|---|---|---|---|
| [chestny-znak-mcp-ru](https://github.com/ilyautov/chestny-znak-mcp-ru) | API Честного знака (ГИС МТ) | 33 | 1 976 | [chestny-znak-api](https://business-mcp-ru.aifrontier.tech/chestny-znak-api.html) |
| [diadoc-mcp-ru](https://github.com/ilyautov/diadoc-mcp-ru) | API Диадока (Контур) | 114 | 1 740 | [diadoc-api](https://business-mcp-ru.aifrontier.tech/diadoc-api.html) |
| [vk-mcp-ru](https://github.com/ilyautov/vk-mcp-ru) | VK API | 373 | 1 344 | [vk-api](https://business-mcp-ru.aifrontier.tech/vk-api.html) |
| [hh-mcp-ru](https://github.com/ilyautov/hh-mcp-ru) | API hh.ru | 133 | 911 | [hh-api](https://business-mcp-ru.aifrontier.tech/hh-api.html) |
| [sbis-mcp-ru](https://github.com/ilyautov/sbis-mcp-ru) | API СБИС (Saby) | 45 | 877 | [sbis-api](https://business-mcp-ru.aifrontier.tech/sbis-api.html) |
| [marketplaces-mcp-ru](https://github.com/ilyautov/marketplaces-mcp-ru) | Wildberries, Ozon, Яндекс Маркет, Авито | 1 022 | 6 503 | [marketplaces-mcp-ru.aifrontier.tech](https://marketplaces-mcp-ru.aifrontier.tech/) |

Всего 698 методов в пяти серверах отсюда, плюс 1 022 в маркетплейсах.

Последняя строка это отдельный проект: он старше, ставится одним пакетом сразу
на четыре площадки, и спрос в его строке это сумма по ним. Здесь же каждый
сервис ставится сам по себе.

## Поставить один

```bash
uvx hh-mcp-ru          # или vk-mcp-ru, diadoc-mcp-ru, sbis-mcp-ru, chestny-znak-mcp-ru
```

## Поставить все пять

```bash
pip install business-mcp-ru
```

Этот пакет не содержит кода: он тянет пять серверов как зависимости, чтобы не
перечислять их по одному.

## Как устроено

Сервер это каталог методов (`endpoints.yaml`) плюс тонкий `server.py` на 66
строк. Всё остальное в общем ядре [schema-mcp-core](https://github.com/ilyautov/schema-mcp-core):
HTTP-клиент с авторизацией и повтором на 429, классы доступа, хранилище ключей,
`doctor`. Поэтому правка безопасности чинит сразу пять серверов, а не один.

Агент не получает сотню функций: он ищет метод словами (`*_search_methods`),
читает описание с параметрами (`*_describe_method`) и вызывает
(`*_call_method`). Перед записью спрашивает.

## Ключи

Живут на машине пользователя, в `~/.ru-mcp/cabinets.json` с правами 600. Наружу
не уходят: у каждого сервера белый список доменов, и заголовок авторизации не
покидает домен сервиса даже при вызове произвольного пути.

## Спрос

Цифры в таблице это Яндекс Вордстат, Россия, месяц до 08.09.2026, запрос вида
«<сервис> api». Ниши выбирались по двум условиям сразу: спрос от 800 в месяц и
отсутствие поддерживаемого MCP-сервера на GitHub. Замер и метод:
`Projects/nishi-mcp-skills-2026-09-11`.

## Страницы

`docs/` собирается скриптом из тех же каталогов, которые исполняют серверы:

```bash
python3 scripts/build_pages.py           # пересобрать
python3 scripts/build_pages.py --check   # сверить, для CI
```

Каталоги берутся из соседних папок репозиториев, а если их нет, из
установленных пакетов.

MIT. Автор [Илья Утов](https://github.com/ilyautov).
