Content
# korean-engineering-mcp
**All Fields of Korean Engineering**'s **construction standards (KDS/KCS)**, **legislative/executive/administrative rules**, and optional **local technical documents**. Search and create evidence packages, and generate **copy-paste-ready HTML engineering reports** only when users request or agree to the response.
Compatible with MCP-compatible clients like Claude, Hermes, OpenClaw, Antigravity, and VS Code/Copilot/Cline/Cursor.
## v1.4 Core Improvements
- **All-field routing**: Automatically categorize and search across various fields, including roads, railroads, urban planning, rivers, ports, airports, architecture, structures, terrain, bridges, tunnels, and more.
- **Field-specific search planning**: Provide KDS/KCS code series, law names, and administrative rule/institutional hints for targeted searches.
- **Search blind spot indication**: Highlight areas with limited or scattered KCSC standards, suggesting additional confirmation of the latest institutional standards.
- **Field-specific coverage matrix**: Categorize KCSC, laws, and local reference materials by `configured`, `indexed`, `partial`, and `unavailable` status.
- **All-field local documents**: Search `.md`, `.markdown`, and `.txt` files within a limited depth, file count, and size in the `REFERENCE_DIR`.
- **Optional identical content HTML**: Generate HTML reports only when users request or agree to the response, ensuring offline-compatible, single-file HTML with A4 printing and PDF support.
- **Secure document generation**: Render Markdown with raw HTML disabled, restrict file names and output paths, and record the SHA-256 of the rendered engineering Markdown in HTML metadata.
- **Offline equation rendering**: Convert TeX equations ($...$ and $$...$$) to MathML for browser-friendly, print-ready, and PDF-compatible rendering.
- **Skill synchronization**: Update client skills separately from MCP code updates, ensuring the latest HTML opt-in policy.
## Tool List
### Engineering Domain Investigation
- `list_engineering_domains` — List supported domains, aliases, KDS/KCS code series, and search scopes.
- `classify_engineering_domain` — Classify questions into domains and generate law/administrative rule/KDS·KCS search plans.
- `grounded_engineering_research` — Retrieve compact evidence packages for answers.
- `comprehensive_research` — Simultaneous search and summary of laws and construction standards.
### KDS/KCS
- `search_standards` — Search KDS/KCS and optional institutional standards with keyword and domain weighting.
- `get_standard_detail` — Retrieve specific KDS/KCS standard text.
- `list_standard_categories` — Display categories and domains for standards.
### Legislative
- `search_laws` / `get_law_detail`
- `search_admin_rules` / `get_admin_rule_detail`
- `search_interpretations`
### Local Reference Documents
- `search_reference_documents` — Search `REFERENCE_DIR` for Markdown/TXT documents across all domains.
- `search_design_manual` — Legacy search for design manual files.
### HTML Documents
- `render_engineering_answer_html` — Generate HTML reports from user-confirmed Markdown answers.
## AI Tool Installation
Share the following URL with Claude, Hermes, OpenClaw, or other AI tools:
```text
https://github.com/sonmeggy/korean-engineering-mcp
```
Agents will install MCP and Skill layers by reading `AGENT_INSTALL.md`.
## Prerequisites
Required API keys:
- KCSC API key: https://www.kcsc.re.kr
- Legislative API key: https://open.law.go.kr
```bash
cp .env.example .env
# Fill in actual KCSC_API_KEY and LAW_API_KEY in .env
```
Recommended variables:
```dotenv
KCSC_API_KEY=...
LAW_API_KEY=...
# Optional: local Markdown/TXT reference root
REFERENCE_DIR=/absolute/path/to/engineering/references
# Optional: HTML output directory
ENGINEERING_OUTPUT_DIR=/absolute/path/to/engineering/outputs
ENGINEERING_TIMEZONE=Asia/Seoul
```
## Generic MCP JSON
```json
{
"mcpServers": {
"korean-engineering-mcp": {
"command": "npx",
"args": ["-y", "github:sonmeggy/korean-engineering-mcp"],
"env": {
"KCSC_API_KEY": "${KCSC_API_KEY}",
"LAW_API_KEY": "${LAW_API_KEY}",
"REFERENCE_DIR": "${REFERENCE_DIR}",
"ENGINEERING_OUTPUT_DIR": "${ENGINEERING_OUTPUT_DIR}",
"ENGINEERING_TIMEZONE": "Asia/Seoul"
}
}
}
}
```
## Claude Code
```bash
claude mcp add korean-engineering-mcp \
-e KCSC_API_KEY="$KCSC_API_KEY" \
-e LAW_API_KEY="$LAW_API_KEY" \
-e REFERENCE_DIR="$REFERENCE_DIR" \
-e ENGINEERING_OUTPUT_DIR="$ENGINEERING_OUTPUT_DIR" \
-- npx -y github:sonmeggy/korean-engineering-mcp
```
## Hermes Skill + MCP
```bash
./install/install-hermes.sh
```
## Recommended Usage Flow
### 1. Grounded Engineering Answer
```text
Review airport runway safety zone installation standards and relevant laws.
First, classify the domain and confirm evidence with grounded_engineering_research.
```
### 2. Optional Chat Response + Identical Content HTML
```text
Shall I generate an HTML report with the same content?
```
## License
MIT
