# minreestr-mcp

[![CI](https://github.com/velvetway/minreestr-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/velvetway/minreestr-mcp/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](pyproject.toml)

MCP (Model Context Protocol) сервер для поиска по каталогу российского ПО [каталогпо.рф](https://xn--80aajzhsbhw.xn--p1ai/). Позволяет Claude Code и любому MCP-клиенту искать отечественные аналоги зарубежного софта, смотреть производителей, находить ПО для импортозамещения — прямо из диалога.

> English version below.

## Что это

Каталог содержит **26 000+ продуктов** российских разработчиков: ОС, СУБД, SIEM, антивирусы, СКЗИ, EDR, системы резервного копирования и многое другое. Описания часто содержат информацию о сертификатах **ФСТЭК/ФСБ**, совместимости с **Astra Linux / РЕД ОС**, соответствии **152-ФЗ / 187-ФЗ**.

MCP-сервер даёт три инструмента:

| Tool | Назначение |
|---|---|
| `search_russian_software` | Полнотекстовый поиск по названию и описанию |
| `list_russian_manufacturers` | Список производителей с количеством продуктов |
| `get_featured_russian_software` | Топ-продукты с главной каталога |

## Установка

```bash
pip install minreestr-mcp
```

Или из исходников:

```bash
git clone https://github.com/velvetway/minreestr-mcp
cd minreestr-mcp
pip install -e .
```

## Использование с Claude Code

Добавьте в `~/.claude/settings.json` (или `.mcp.json` в корне проекта):

```json
{
  "mcpServers": {
    "minreestr": {
      "command": "minreestr-mcp"
    }
  }
}
```

После перезапуска Claude Code три инструмента станут доступны. Примеры запросов:

- «Найди российский антивирус для Linux»
- «Какие есть отечественные SIEM-системы с сертификатом ФСТЭК?»
- «Покажи 10 топовых производителей ПО из реестра Минцифры»
- «Есть ли замена Veeam среди российского ПО?»

## Использование с Claude Desktop

В `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):

```json
{
  "mcpServers": {
    "minreestr": {
      "command": "minreestr-mcp"
    }
  }
}
```

## Пример ответа

Запрос: `search_russian_software("antivirus linux", limit=2)`

```
Found 2 product(s) for 'antivirus linux':

• [10856] Антивирус «VR Protect» для Linux
  https://каталогпо.рф/product/10856
  «VR Protect» — российское антивирусное решение, разработанное специально для
  операционных систем семейства Linux... включая сертификацию ФСТЭК. Продукт
  совместим с отечественными платформами, такими как Astra Linux и «Ред ОС»...
```

## API источника

Сервер использует **неофициальный публичный API** каталогпо.рф, обнаруженный реверс-инжинирингом JS-бандла сайта:

- `GET /api/products/search?query=X&limit=N`
- `GET /api/manufacturers?page=N&limit=N`
- `GET /images/main-product.json`

**Предупреждение:** API не документирован. Владелец сайта может его изменить без предупреждения. В таком случае откроется issue и будет выпущена новая версия.

Данные принадлежат каталогпо.рф и их источникам (реестр Минцифры, вендоры). MCP-сервер — только обёртка над публичным HTTP, не хранит и не модифицирует данные.

## Разработка

```bash
git clone https://github.com/velvetway/minreestr-mcp
cd minreestr-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest            # тесты с моками через respx
ruff check .      # линтер
```

## Связанные проекты

- [velvetway/bdu-fstec-mcp](https://github.com/velvetway/bdu-fstec-mcp) — MCP для БДУ ФСТЭК (86 000+ российских уязвимостей). Используйте его для поиска уязвимостей, а этот — для поиска ПО / импортозамещения.
- [velvetway/bdu-fstec-mirror](https://github.com/velvetway/bdu-fstec-mirror) — публичное зеркало БДУ ФСТЭК, с которым работает bdu-fstec-mcp.

## Лицензия

MIT. См. [LICENSE](LICENSE).

---

## English

MCP (Model Context Protocol) server for searching the Russian software catalog at [каталогпо.рф](https://xn--80aajzhsbhw.xn--p1ai/) from Claude Code / Claude Desktop / any MCP client.

**Use case:** cybersecurity / compliance teams in Russian organizations looking for domestic alternatives to foreign software (import substitution), verifying ФСТЭК/ФСБ certification, discovering vendors in the Минцифры registry.

### Tools

- **`search_russian_software(query, limit=10)`** — full-text search
- **`list_russian_manufacturers(page=1, limit=20)`** — paginated list of vendors
- **`get_featured_russian_software()`** — homepage highlights

### Installation

```bash
pip install minreestr-mcp
```

### Claude Code / Claude Desktop integration

```json
{
  "mcpServers": {
    "minreestr": {
      "command": "minreestr-mcp"
    }
  }
}
```

### Data source

Uses the **unofficial public API** of каталогпо.рф (discovered by reverse-engineering the site's JS bundle). No authentication required. Not affiliated with the site owners.

### Related projects

- [velvetway/bdu-fstec-mcp](https://github.com/velvetway/bdu-fstec-mcp) — MCP server for БДУ ФСТЭК (Russian vulnerability database, 86k+ records). Use this for vulnerability lookups; use `minreestr-mcp` for vendor/product search.
- [velvetway/bdu-fstec-mirror](https://github.com/velvetway/bdu-fstec-mirror) — public mirror of the БДУ data consumed by that MCP.

### License

MIT.