Skip to main content
Glama
pid-ref

pid-ref

by meloman112

pid-symbols-reference

Справочник условных обозначений для P&ID и технологических схем: ISO 10628-2, ISA 5.1, ГОСТ 21.208, ГОСТ 2.780, 2.782, 2.784, 2.785, 2.788–2.795, DIN 2429. 838 символов. У каждого есть SVG, название RU/EN, стандарт, назначение, где ставить, типичные ошибки и похожие символы. Есть типовые узлы по ГОСТ: обвязка регулирующего клапана, насосная установка с резервом, контур уровня. В них каждый элемент кликабелен и открывает свою карточку. Ещё есть расшифровка тегов приборов по буквам (PDIT-101, TIC, LSHH) по ГОСТ 21.208 и ISA 5.1.

Что есть:

  • Веб (без LLM): поиск, фильтры по стандарту и категории, карточка символа, скачивание SVG, правка описаний.

  • Редактор схем (/editor): символы ГОСТ перетаскиваются на лист, трубопроводы и линии связи прилипают к точкам подключения, исполнительный механизм сам садится на клапан, тег прибора сразу расшифровывается. Схемы хранятся на сервере, выгружаются в SVG, PNG и DXF (AutoCAD, Компас, nanoCAD; 1 единица листа = 0,25 мм).

  • MCP-сервер: подключается к Gemini CLI, Claude Code или любому MCP-клиенту, чтобы LLM искала символы в справочнике.

Запуск

docker compose up -d

Настройки — в файле .env рядом с compose.yaml:

EDIT_PASSWORD=придумайте-пароль   # без него всё только на чтение: ни правки описаний, ни сохранения схем
WEB_PORT=8790                     # если 8080 занят
MCP_PORT=8791                     # если 8081 занят

База лежит в data/pid.db и подключена в контейнеры как volume, поэтому правки из веба сохраняются на диске.

Related MCP server: bsdd-mcp

Подключение MCP

Gemini CLI, файл ~/.gemini/settings.json:

{"mcpServers": {"pid-ref": {"httpUrl": "http://<хост>:8081/mcp"}}}

Claude Code, файл .mcp.json:

{"mcpServers": {"pid-ref": {"type": "http", "url": "http://<хост>:8081/mcp"}}}

Инструменты:

  • search_symbols(query, standard, category, limit) — поиск символов;

  • get_symbol(symbol_id) — полная карточка символа;

  • get_assemblies() — типовые узлы: описание, на что обратить внимание, состав;

  • decode_tag(tag) — расшифровка тега прибора по буквам.

MCP только читает базу.

Читать справочник и схемы может любой в сети. Правка описаний и сохранение схем — только после входа по паролю EDIT_PASSWORD. Пароль передаётся по HTTP открытым текстом, поэтому порт держите в локальной сети.

Без Docker

python -m venv .venv && .venv/bin/pip install -r requirements.txt
EDIT_PASSWORD=... .venv/bin/python web.py 8080
.venv/bin/python mcp_server.py 8081   # без порта запускается по stdio

Сборка данных

data/pid.db уже собрана. Скрипты ниже нужны только для пересборки, повторный запуск ничего не ломает.

scripts/harvest_iso.py                 # ISO 10628-2: SVG с Wikimedia Commons
scripts/harvest_din.py                 # приводы DIN 2429 с Commons
scripts/harvest_kuphaldt.py liii.pdf   # ISA 5.1 из книги Kuphaldt (ссылка на PDF в скрипте)
scripts/gen_symbols.py                 # ГОСТ 21.208 и 2.785 по рисункам стандартов
scripts/gen_gost_2_784.py              # ГОСТ 2.784
scripts/gen_gost_2_788.py … 2_795.py   # ГОСТ 2.788–2.795: оборудование химических производств
scripts/gen_gost_2_782.py              # насосы ГОСТ 2.782 и фильтр ГОСТ 2.780 для узлов
scripts/gen_assemblies.py              # типовые узлы из символов базы → svg/assemblies, таблицы assemblies
scripts/load_letters.py                # буквенные коды ГОСТ 21.208 и ISA 5.1
scripts/enrich.py export|apply         # описания: work/todo_*.json → LLM → work/done_*.json → база

Что покрыто, откуда взято и что неточно, описано в catalog/inventory.md.

Лицензии

  • Код: MIT, см. LICENSE.

  • Рисунки ISO 10628-2 и DIN 2429 взяты с Wikimedia Commons под лицензией CC BY-SA 4.0 или Public Domain. Автор и ссылка на источник есть в карточке каждого символа.

  • Рисунки ISA 5.1 вырезаны из книги T. R. Kuphaldt «Lessons In Industrial Instrumentation», лицензия CC BY 4.0.

  • Рисунки ГОСТ нарисованы заново по таблицам стандартов. Тексты стандартов в репозиторий не входят.

  • Шрифт Golos Text — SIL Open Font License.

  • Описания сгенерированы LLM и со стандартами не сверялись. Перед использованием в проекте проверьте их по стандарту.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Provides read-only access to the buildingSMART Data Dictionary (bSDD), enabling AI assistants to search and retrieve construction classifications, classes, properties, and relations through natural language.
      12
      4 npm
      MIT
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI agents to automate AutoCAD drafting, drawing understanding, and quantity takeoffs either through a live COM connection on Windows or headlessly via ezdxf on any platform. It covers P&ID, mechanical, and architectural workflows with ISO/ANSI standards — symbols, dimensions, layers, frames, title blocks, parts lists, schedules, and validation of drawings made by others.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI agents to create, edit, read back, and validate engineering drawings — including P&ID sheets, mechanical parts, and architectural plans — against ISO standards such as GD&T, dimension tolerances, title blocks, and takeoffs. Runs either live through AutoCAD COM on Windows or headlessly through ezdxf anywhere, with selectable tool packs and a search-based discovery mode to keep the advertised tool surface small.
      -