fsnb-mcp

MCP-сервер для офлайн-доступа к нормам ФСНБ-2022 (ГЭСН) через SQLite + FTS5. Данные — из официального набора открытых данных ФГИС ЦС; сервер только читает локальную базу, в сеть не ходит.

Быстрый старт

npm install && npm run build && npm run build:sample

Подключение к MCP-клиенту:

{
  "mcpServers": {
    "fsnb-mcp": {
      "command": "node",
      "args": ["/path/to/fsnb-mcp/dist/index.js"],
      "env": {
        "FSNB_DB": "/path/to/fsnb-mcp/samples/sample.sqlite"
      }
    }
  }
}

Переменные окружения:

• FSNB_DB — прямой путь к sqlite (приоритет)
• FSNB_DATA_DIR — каталог данных (по умолчанию ~/.fsnb-mcp/data, файл fsnb.sqlite)

Инструменты (5)

Инструмент	Назначение
fsnb_rate_get	Норма по коду (gesn:01-01-001-01 или 01-01-001-01)
fsnb_search	Полнотекстовый поиск (FTS5, кириллица)
fsnb_rate_composition	Состав ресурсов: труд, машины, материалы (нормы расхода)
fsnb_validate_code	Проверка существования кода
fsnb_meta	Метаданные, manifest, правовая основа

Данные и атрибуция

Нормативные данные получены из официального набора открытых данных ФГИС ЦС «ФСНБ-2022» (Минстрой России): https://fgiscs.minstroyrf.ru/opendata/7707082071-fsnb

Условие использования данных: использование, включая коммерческое, разрешено при условии ссылки на первоисточник (портал ФГИС ЦС, ссылка выше).

Правовая опора для ПО: письмо Минстроя России от 08.02.2021 №4350-ИТ/09 — законодательство не содержит запретов на разработку программного обеспечения для автоматизации сметной документации на основе нормативов ФРСН/ФГИС ЦС.

В репозитории — только образец samples/sample.sqlite (10 реальных норм). Полная база собирается локально скриптом scripts/ingest/fgiscs-xml.mjs.

Разработка

npm install
npm run build
npm test
npm run build:sample

Требования: Node.js ≥ 22 (node:sqlite + FTS5).

License

MIT (код). Данные ФСНБ лицензируются отдельно — см. раздел «Данные и атрибуция».

---

English (short)

MCP server for offline read-only access to Russian construction normative rates (FSNB-2022 / GESN) via SQLite + FTS5. Data from official FGISC open data (Minstroy portal); attribution required. Legal basis for software use: Minstroy letter №4350-ИТ/09 (2021-02-08). Code: MIT.

npm install && npm run build && npm run build:sample

Set FSNB_DB to your sqlite path. Five tools: fsnb_rate_get, fsnb_search, fsnb_rate_composition, fsnb_validate_code, fsnb_meta.