mcp-zakupki

atomno-mcp-zakupki

政府采购 MCP 服务：在 zakupki.gov.ru 搜索招标、查询采购方和供应商历史记录、查阅 ОКПД2 目录。44-ФЗ、223-ФЗ 和 615-ПП 法规——直接在 Cursor、Claude 和任何 MCP 客户端中使用。

面向 AI Agent 的俄罗斯公共采购搜索工具。

在本地安装，在 Cursor / Claude Desktop / Cline 的配置中填写服务器信息—— 然后在一个提示词中提出请求：“展示今天最新的莫斯科招标，ОКПД2 为 62.0，НМЦК ≤ 5 млн ₽。” 服务会访问选定的数据源，规范化响应， 并返回可供 LLM 使用的结构化数据。

为什么需要它

痛点	目前的做法	使用 atomno-mcp-zakupki
每天早上花 30–60 分钟手动筛查 ЕИС，或每年支付 16–67 K ₽ 使用 Контур / Seldon	Excel 汇总表 + email 通知	在 Cursor 中调用一次 MCP → LLM 自动筛选、解释和比较
使用 ftp.zakupki.gov.ru 的 Python 脚本从 2025 年 1 月起失效	通过商业 API 寻找替代方案	ЕИС 官方网站：搜索、XML 卡片、组织卡片
AI Agent 无法自行读取招标信息	复制粘贴到聊天中	get_tender(reg_number) 以 JSON 返回完整卡片

包含的内容（开放客户端）

工具	功能
search_tenders	在 zakupki.gov.ru 官方网站搜索采购。无需密钥。
get_tender	根据注册编号获取采购卡片（官方 XML 打印表单）。
lookup_okpd2	根据文本搜索 ОКПД2 / КТРУ 代码（本地目录，无需联网）。
get_customer_history	根据 ИНН 获取采购方卡片及其在不诚信供应商登记册中的状态。网站不计算采购金额汇总。
get_supplier_stats	供应商汇总信息。没有 ЕИС 机器交换令牌时无法访问——工具会返回拒绝访问，而不是零值。

默认数据源为 ЕИС 官方网站。已禁用付费中介服务。 没有机器交换令牌时，无法获取采购金额汇总和供应商统计信息。

快速开始

1. 安装

# Через uvx (рекомендуется — без установки в систему):
uvx atomno-mcp-zakupki --help

# Через pipx:
pipx install atomno-mcp-zakupki
atomno-mcp-zakupki --version

# В виртуальное окружение проекта:
pip install atomno-mcp-zakupki

可选的官方 ЕИС 令牌扩展（需要 Минфин 证书）：

pip install "atomno-mcp-zakupki[eis-official]"

2. 配置

搜索和采购卡片功能无需密钥——数据源为 zakupki.gov.ru。 付费中介服务和 ЕИС SOAP 令牌均非必需。

变量	说明	获取方式
MCP_ZAKUPKI_DAMIA_KEY	DaMIA API-Закупки API 密钥	https://damia.ru/apizakupki（免费“Старт”套餐，每月约 100 次请求）
MCP_ZAKUPKI_GOSPLAN_KEY	ГосПлан API v2 API 密钥	https://wiki.gosplan.info（无需注册的沙盒：fz44test.gosplan.info）
MCP_ZAKUPKI_NAVODKI_KEY	navodki.ru API 密钥	https://navodki.ru
MCP_ZAKUPKI_EIS_TOKEN	ЕИС 令牌（通过 pmd/auth/welcome 获取）	https://zakupki.gov.ru/pmd/auth/welcome + Минфин 证书
MCP_ZAKUPKI_API_KEY	Pro hosted — get_customer_history / get_supplier_stats 和未来 AI 工具的必需项	https://atomno-mcp.ru/pricing#zakupki-pro
MCP_ZAKUPKI_LOG_LEVEL	DEBUG / INFO / WARNING / ERROR / CRITICAL	默认值为 INFO
MCP_ZAKUPKI_CACHE_DB	SQLite 缓存路径	用户数据目录（%LOCALAPPDATA%/atomno/ 或 ~/.local/share/atomno/）
MCP_ZAKUPKI_PROVIDERS	数据源链	默认值为 eis_public
MCP_ZAKUPKI_RPS	每分钟请求数限制	默认值为 30

3. 连接到 Cursor

打开 ~/.cursor/mcp.json（或 Cursor → Settings → Model Context Protocol）并添加：

{
  "mcpServers": {
    "zakupki": {
      "command": "uvx",
      "args": ["atomno-mcp-zakupki"],
      "env": {
        "MCP_ZAKUPKI_LOG_LEVEL": "INFO"
      }
    }
  }
}

4. 连接到 Claude Desktop

%APPDATA%\Claude\claude_desktop_config.json（Windows）或 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

{
  "mcpServers": {
    "zakupki": {
      "command": "uvx",
      "args": ["atomno-mcp-zakupki"]
    }
  }
}

5. Подключение к Cline / Goose / Kiro

Любой MCP-клиент: запустите atomno-mcp-zakupki (по умолчанию stdio транспорт) и пропишите в его конфиге команду запуска.

Для HTTP-режима:

atomno-mcp-zakupki --transport http --host 127.0.0.1 --port 8765

Примеры

Утренний мониторинг тендеров

[Cursor]: Покажи свежие тендеры за сегодня по ОКПД2 62.0 в УрФО
          с НМЦК 500K-3M ₽, СМП-only.

→ search_tenders(
    okpd2_codes=["62.01", "62.02", "62.09"],
    regions=["66", "74", "59", "45", "72", "86", "89"],
    price_min_rub=500000, price_max_rub=3000000,
    smp_only=True,
    publish_date_from="2026-04-26",
    status=["applications_open"]
  )
← 7 тендеров найдено за 412 мс.

Карточка тендера

[Cursor]: Расскажи подробно про реестровый номер 0173100007426000018.

→ get_tender(reg_number="0173100007426000018", include_documents=True)
← Все поля: заказчик, НМЦК, документация (PDF), сроки, площадка...

Анализ заказчика (Pro)

[Cursor]: Кто такой ИНН 7449023800? Покажи историю закупок за 2 года.

→ get_customer_history(inn="7449023800", period_from="2024-01-01")
← Требуется MCP_ZAKUPKI_API_KEY (hosted Pro).

Подбор кода ОКПД2

[Cursor]: Какой ОКПД2 у разработки веб-портала?

→ lookup_okpd2(query="разработка веб-портала", limit=5)
← [{"code":"62.01.11.000","name":"Услуги по проектированию ИС","match":0.94}, ...]

CLI

atomno-mcp-zakupki --help
atomno-mcp-zakupki --version
atomno-mcp-zakupki --check-config
atomno-mcp-zakupki --log-level DEBUG
atomno-mcp-zakupki --transport http --host 127.0.0.1 --port 8765
atomno-mcp-zakupki --transport sse --port 9000

Полный список опций — в atomno-mcp-zakupki --help.

Источники данных

Источник	Что отдаёт	Когда используется
ЕИС, официальный сайт	Поиск, XML-карточка, карточка организации, реестр недобросовестных	По умолчанию, без ключа
SOAP ЕИС (int.zakupki.gov.ru)	Машинная выгрузка	Только с токеном после регистрации на портале
DaMIA / ГосПлан / navodki	Коммерческие API	Только если явно заданы в MCP_ZAKUPKI_PROVIDERS и есть ключ

Цепочка по умолчанию: MCP_ZAKUPKI_PROVIDERS=eis_public. Если источник не ответил, тулза вернёт типизированную ошибку provider_unavailable или not_implemented — не пустой список.

Архитектура (вкратце)

AI-клиент (Cursor / Claude / Cline) ──MCP──▶ atomno-mcp-zakupki
                                              │
                                              ├──▶ lookup_okpd2 (offline)
                                              ├──▶ Self-hosted API (search/get)
                                              └──▶ hosted Pro (api.atomno-mcp.ru) — production

Все провайдеры реализуют общий BaseProvider-интерфейс. Ответы нормализуются в Pydantic-модели Tender, Customer, Document, OrgHistorySummary.

Разработка

git clone https://github.com/atomno-mcp/mcp-zakupki.git
cd mcp-zakupki

python -m venv .venv
source .venv/bin/activate            # Linux/macOS
# .venv\Scripts\activate              # Windows

pip install -e ".[dev]"
pytest -v --cov=src/mcp_zakupki
ruff check src tests

Disclaimer

• Сервис не аффилирован с Министерством финансов РФ, ФАС, оператором ЕИС или конкретными ЭТП.
• Данные берём с официального сайта ЕИС (zakupki.gov.ru) по обычным публичным адресам, с официальными корневыми сертификатами Минцифры.
• Машинный обмен SOAP требует токен и регистрацию на портале — без этого сводка объёмов и статистика поставщика недоступны.
• Используйте на свой риск. Решения о подаче заявок на тендеры — на ответственности пользователя.

Лицензия

MIT © 2026 Atomno.

Семья MCP-серверов atomno

atomno-mcp-zakupki — пятый сервер семьи atomno-mcp-*:

• atomno-mcp-cbr-rates — курсы ЦБ РФ
• atomno-mcp-egrul — реквизиты юр.лиц из ЕГРЮЛ
• atomno-mcp-fns-check — налоговая благонадёжность
• atomno-mcp-fssp — задолженности и исп. производства (готовится)
• atomno-mcp-zakupki — вы здесь
• atomno-mcp-rosreestr — недвижимость, кадастр (готовится)
• atomno-mcp-sudact — судебная практика (готовится)

Подключите все вместе — и получите полное B2G-досье по тендеру за один промпт.