kcsc-design-mcp

MCP-сервер для мгновенного получения оригинальных текстов национальных строительных норм (KDS, KCS и др.) прямо в окне ИИ-чата.

Сервер напрямую подключается к OpenAPI Национального центра строительных норм (KCSC). Достаточно указать свой ключ авторизации — и инструмент работает в любой среде, поддерживающей MCP: Claude Desktop, Claude Code, Cursor и т. д.

"KDS 14 31 10 의 압축부재 폭두께비 표 보여줘"
→ 표 4.2-2 를 마크다운 표 그대로 인용

⚠️ Чего этот инструмент не делает

Он не заменяет расчёт конструкции.

• Формулы и символы (λr, Fcr и т. п.) приходят из KCSC в виде изображений, поэтому в текстовом виде их нет. Инструмент помечает такие места как 〔그림 N〕 и не выдумывает формулы.

• Если нужна формула — получите её через kcsc_formula в виде картинки как есть. Это настоящая формула из настоящего стандарта. Если считать, не глядя на изображение, то формула взята не из оригинала, а из памяти ИИ. Она может оказаться верной, а может — ошибочной, и по одному выводу это не отличить. → В этом случае проверьте цитирование через kcsc_audit и укажите этот факт.

• Создаваемые Excel-файлы — это пустые шаблоны. Расчётные формулы в них не закладываются: в исходном документе формула является изображением, поэтому её содержимое знать, а подставлять неизвестную формулу — это авария.

• Прилагаемое дерево решений — не проверенная проектная документация. Это лишь порядок рассмотрения и обосновывающие статьи. В местах, где KDS не задаёт значение, стоит значение, выбранное организацией, выпустившей это дерево. Его нужно адаптировать под регламент своей организации, и ответственность за это решение несёт проектировщик, его использующий.

• Окончательное решение принимает проектировщик. Ошибка всего в одной нагрузке моста может привести к несчастному случаю с людьми.

Related MCP server: KJH Law MCP

Установка

Сначала понадобится ключ авторизации — запросите OpenAPI в Национальном центре строительных норм на сайте https://kcsc.k.re.re/god.

Clade Desktop / Claude Code

В файл claude_desktop_config.json (или .mcp.json) добавьте один блок, приведённый ниже, целиком.

{
  "mcpServers": {
    "kcsc": {
      "command": "uvx",
      "args": ["kcsc-design-mcp"],
      "env": { "KCSC_API_KEY": "발급받은_키" }
    }
  }
}

Если уvx нет, сначала установите uv. Отдельная процедура установки не требуется.

Расположение файла настройки — Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json; Claude Code: .mcp.json в корне проекта. После перезапуска приложения будут доступны 14 инструментов.

Запуск прямо из исходного кода

pip install -e .
KCSC_API_KEY=발급받은_키 python -m kcsc_mcp

Инструменты

Оригинальные тексты нормативных документов

Помощь проектированию — дерево решений

Код принимается в форматах KDS 14 31 10, 14 31 10, 143110. kcsc_grep и kcsc_version принимают несколько кодов через запятую — grep читает весь документ целиком, поэтому максимум 10 за раз.

kcsc_formula — формулы как изображения без обработки

Формулы в исходниках — это GIF-изображения. У них нет ни alt, ни MathML, поэтому в текстовой форме они не существуют. К ключу они не привязаны — ключ даёт только право обращения.

При этом сами изображения чёткие. Поэтому этот инструмент возвращает картинки в исходном виде.

kcsc_formula('KDS 14 31 10', '4.2.3')

→ 텍스트 1개 + 이미지 17개
  〔그림 2〕  Pn = Fcr·Ag                    (4.2-1)
  〔그림 6〕  Fcr = [0.658^(Fy/Fe)]·Fy       (4.2-2)
  〔그림 9〕  Fcr = 0.877·Fe                 (4.2-3)
  〔그림 11〕 Fe = π²E/(KL/r)²               (4.2-4)

Номера совпадают с 〔그림 N〕 в тексте, полученном через kcsc_read. Можно читать сплошной текст и открывать только те формулы, которые нужны.

Стоимость почти нулевая — примерно 27~216 vision-токенл за раздел. Но в одном разделе жет бывает и 71 изображение; по умолчанию передаётся не больше 40, можно ограничитель через max_images.

※ Чтение изображения — тоже распознавание, поэтому нижние индексы могут быть прочитаны неточно. Однако проектировщик видит то же изображение и может сверяться; а вот формула, восстановленная по памяти памяти, не имеет даже объекта для сверки.

kcsc_audit — машинная проверка цитат в расчётах

Это инструмент, который не запрещает считать, но делает результат проверяемым. В ответ вставляете весь расчёт — инструмент извлекает из него номера норм, статей, формул и таблиц и проверяет каждый пункт.

## 인용 검증 — 6건 중 6건 확인 · 0건 실패

| 종류 | 기준 | 인용 | 확인 |
| 조항 | KDS 143110 | 4.3.2.1.1.4 | ✅ 강축 휨을 받는 기타 H형강…  ⚠️수식이미지 |
| 식   | KDS 143110 | 4.3-11      | ✅ 4.3.2.1.1.4 절에 있음 |
| 표   | KDS 143105 | 표 3.4-1    | ✅ 3.4.1 절에 있음 |

★4.3.2.1.1.4 절의 식은 원문이 이미지입니다. 도구가 읽지 못했습니다.
  → 이 계산에 쓰인 식·계수는 원문에서 온 것이 아니라 모델이 채운 것입니다.

Зачем это нужно — это произошло в реальной практике. В ответе по поводу прочности на изгиб нерегулярной H-баллона использовался пункт KDS 14 13 10 4.3.2.1.1.4, получилось φMn=83.8 kN·m, и при перепроверке оказалось верным всё. Но в тексте того раздела формул не дан не было ни одной. Точная запись формул и коэффициентов взята не из чтения нормы, а из памяти ИИ.

В этот раз оказалось правильно. Проблема в том, можно ли определить “верно или неверно” только по тексту вывода — невозможно.

Проверить невозможно (это обязательно нужно читать вместе)

• правильность содержания формулы — нельзя, потому что в оригинале она изображение

• положено ли данное статья для данного элемента / данного условия — это область суждения

• правильность расчёта ограничения

Подтвердить можно только факт: «такой номер реально существует в этом месте». Если считывать из результата больше, чем это, — инструмент начнёт создавать новую ложную уверенность.

Деревья решений — все 35 в комплекте

Логика проектирования не зашита в код: один YAML = один элемент конструкции, и лежит он во внешнем каталоге.

저장소 flows/   결정트리 35개 — LRFD 18 · 한계상태 9 · 허용응력 8 (이음 118개, 끊긴 곳 0)
패키지 동봉     형식 견본 1개 — `검증: 예제` 로 박아 둠. 그대로 쓰라는 게 아님
사용자 폴더     ~/.kcsc-mcp/flows/*.yaml   ← 여기에 두면 도구가 읽는다

Скачайте flows/ и положите в ~/.kcsc-mcp/flows/, либо укажите папку через переменную KCSC_FLOWS_DIR. При совпадении (тип элемента, сечение, метод расчёта) папка пользователя перекрывает приложенный пример.

★Не применяйте полученные деревья как есть. В местах, где KDS не определяет величину, стоят значения, выбранные организацией, выпустившей деревья (предельный оседл L/600, диапазон обхода частот, коэффициент сопряжения элементов 75%/90% и так далее). Какие именно значения такого рода — смотрите в таблице из flows/README.md. Пересчитайте под нормы своей организации.

Дерево — исходный материал для обоснования, а не проверенная проектная документация. Соответствует ли схема действительному производству, машина не проверяет. Проектировщик должен развернуть каждый шаг, просмотреть и оценить сам.

Чтобы создать собственно дерево, возьмите заготовку через design_template, заполните её и прогнать через design_validate.

★ Деревья связаны друг с другом

Расчётная записка не заканчивается одним деревом. Нельзя просто оборвать поток на границе своей области — нужно передать его следующему дереву или следующему стандарту.

분기:
  - {조건: "약축 휨이다",     결과: "약축 조항으로", 다음트리: "휨부재 / 약축 H형강"}
  - {조건: "블록전단 검토",   결과: "연결부 기준",   다음기준: "KDS 14 31 25  4.1.4.3"}

• Если в 다음트림 метод расчёта опущен, он наследуется из текущего дерева — потому что принцип «у другого метода — другое дерево» не должен нарушаться даже в соединениях.

• Если направление указывает на ещё не существующее дерево, инструмент честно говорит «нет». Он не обрывает молча. Список таких отсутствующих — и есть ответ на вопрос «что ещё нужно создать, чтобы закончить расчётную записку».

design_map() выводит эту карту — какое дерево куда ведёт, и какие деревья были названы, но отсутствуют. Среди приложенных 35 деревьев все 118 переходов замкнуты — пропущенных точек 0. Если добавить своё дерево, эта карта подскажет «что ещё нужно создать, чтобы завершить расчёт».

Что ловит design_validate

• пропускка в схема схемы, дубликаты идентификаторов хода

• указание на ход, у которого нет ветвления — дерево обрывается в этом месте

• выдуманные / опечаточные / отменённые номера статей — с помощью API проверяется, существует ли такой раздел или таблица в норме

• несогласованность между методом расчёта и нормативом-основанием — включено ниже

• изменение нормативов после утверждения — сопоставляются 기준 (действующая версия на момент утверждения) и текущая; при изменении появится ❌ (урnowивать первоначальное решение уже нельзя)

Дерево пишет человек, а существование обоснования проверяет машина. Именно насквозь придуманные номера статей — самый опасный случай.

★ Значение по умолчанию — мосты

Архитектурные металлоконструкции (KDS 14 3x) и мосты (KDS 24 xx) — это совершенно отдельные серии норм. Отдельные даже наборы сочетания нагрузок и расчётной нагрузки.

교량   한계상태설계법  KDS 24 14 31 강교   (+ 하중조합 24 12 11 · 설계하중 24 12 21)  ← 도로교
교량   허용응력설계법  KDS 24 14 30 강교   (+ 하중조합 24 12 10 · 설계하중 24 12 20)  ← ★철도교
건축   하중저항계수설계법(LRFD)  KDS 14 31 xx
건축   허용응력설계법(ASD)       KDS 14 30 xx   ← 「하중저항계수설계법 규정이 없는 강구조」의 일반 ASD

По смыслу LRFD тоже является одним из предельных состояний, но по имени нормативного документа это самостоятельная серия. Если их перепутать, мостовику отдадут архитектурный норм.

У KDS 24 «Группа общего метода начисления (допускаемое напряжение)» в исходном текста пункт 1.1 относится к железнодорожным мостам — 24 14 30 “стальные железнодорожные и высокоскоростные мосты”, 24 12 10/24 12 20 “железнодорожные мосты”. В пределах KDS не существует норм на проект автодорожных и пешеходных мостов по пособимым напряжением (для автограж — только предельные состояния). Инструмент фиксирует это в дереве как есть; для пешеходного моста ASD идут так: элементы = KDS 14 30 xx, сочетание загрузок и повышающий коэффициент = 24 12 10 (решение принимает организация). Если значение один заявить «24 14 30 как ASD для автомобильной дороги», не читая оригинала, у такого утверждения не будет обоснования.

Поэтому если область не указана — считается мост.

• design_flow(..., domain='건축') — явно указать построение (архитектура)

• search(..., domain='건축') / domain='전체') — для поиска действует то же правило

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

• Значение по умолчанию изменяется с переменной KCSC_DOMAIN (например, для компании архитектурного профиля — KCSC_DOMAIN=건축)

★ Если метод расчёта разный — дерево другое

Даже при том же типе элемента и том же сечении при смене метода расчёта меняются исходно разные нормы.

한계상태설계법(LRFD)  → KDS 14 31 10  강구조 부재 설계기준 (하중저항계수설계법)
허용응력설계법(ASD)   → KDS 14 30 10  강구조 부재 설계기준(허용응력설계법)

• Если method не указан, в выводе указывается в голове, по дерево какого метода был дан ответ.

• Если подходит несколько дерев — инструмент уточняет, не берет случайно.

• Если запрашивается отсутствующего метода — отвечает, что такого метода нет. Не выдаёт так, будто он есть.

code_type имеет следующие 9 значения: в каталоге KCSC есть не только национальные стандарты (KDS, KCS), но и ведомственные спецификации отраслевых организаций.

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

О проверке TLS

Этот сервер проверяет TLS. В прошлом в некоторых окружениях цепочка TSL-сертификатов KCSC не была в системном корневом хранилище, из-за чего проверка происходила сбоя (на момент проверки 2026-08-05 работает нормально).

Если проверка не проходит, сервер не обходит ее молча, а останавливается и сообщает. Это базовый только читающий публичный API, поэтому риск низкий, но вопрос обхода решает только тот, кто работает с сервером. Чтобы обойти — явно включите переменную KCSC_INSECURE=1.

Что стоит помнить

• Поиск по названию не заходит в текст документа. Например, слово «강관» встречается в тексте десятков нормативов, а в названиях только в пяти. Чтобы искать по тексту — используйте kcsc_grep.

• Формулы не индексируются. Символы λr, Fcr не имеют текстового представления, потому что в оригинале они изображения. kcsc_grep не найдёт их символ — искать нужно по слову (например, «세장판»).

• Коды из шести цифр перекрываются между типами документов. 143110 встречается одновременно в KDS (проектные нормы для металлоконструкций), KCS, SMCS, EXCS, LHCS (везде «изготовлено»). Если тип не указан, сначала читаются национальные нормы (KDS→KCS), но в шапке ответа обязательно сообщается факт выбора и перечислены остальные кандидаты.

• У верхних классификационных узлом нет текста. Такие узлы, как KDS 100000 (общие проектные нормы), являются только навигационными umbrella-записями — отдельных статей не имеют. Инструмент так и сообщает.

• Номера статей могут повторяться внутри документа. В некоторых нормативном (например, в KCS 14 31 10) в приложении номера начинаются с 1. заново, поэтому section="1" может вывести и основной текст, и прилож.

• Пакет не перераспределяет данные. Оригинальный текст норм в пакет не вкладён; полученные документы хранятся только в ~/.kcsc-mcp/cache на компьютере пользователя.

Заметки разработчику

Независимо от того, как API ведёт себя на практике, и обо ошибках, о заряженных при работе, рассказано в docs/KCSC_API.md. Историю верch — в CHANGELOG.md.

Лицензия

Copyright (c) 2026 HydroKorea Co., Ltd.

Контакты

Вопросы, сообщения об ошибках и сообщения об ошибках в номерах статей отправляйте через GitHub Issues. Для ошибок в деревьях используйте форму «Сообщить об ошибку дерева» — тогда не будет пропущено, какое именно шаг и какой пункт относится к проблеме.