@vertical-mcp/kolas-mcp

MCP server for Korea's KOLAS (Korean Laboratory Accreditation Scheme) — the national accreditation body under KATS (국가기술표준원) that accredits calibration, testing, inspection, medical-testing, reference-material-production, and proficiency-testing organizations under ISO/IEC 17025, ISO/IEC 17020, ISO 15189, ISO 17034, and ISO/IEC 17043.

한국인정기구(KOLAS) 공개 포털(knab.go.kr)과 공공데이터포털(data.go.kr) 데이터셋을 MCP 서버로 래핑한 패키지. 교정·시험·검사·의료시험·표준물질생산·숙련도시험 인정기관을 Claude·Cursor 등 MCP 호환 클라이언트에서 바로 조회할 수 있다.

Tools

| Tool | Description | |------|-------------| | search_accredited_labs | Search accredited labs by free-text query and category (CALIBRATION / TESTING / INSPECTION / MEDICAL / REFERENCE / PROFICIENCY / ALL). No API key required. | | get_lab_details | Full detail for a single lab by accreditation number (e.g. KT001) — scope of accreditation, history, contact. No API key required. | | get_kolas_statistics | Annual accreditation counts per category (dataset 15054300). Requires KOLAS_SERVICE_KEY from data.go.kr. |

Quick start

1. (Optional) Register for a data.go.kr ServiceKey

The live lab-search tools work without any API key. A key is only required for get_kolas_statistics, which pulls annual aggregate data from data.go.kr.

To enable statistics:

1. Sign up at https://data.go.kr
2. Apply for dataset 15054300 (산업통상자원부_기술표준통계_한국인정기구(KOLAS) 인정현황)
3. Copy the issued ServiceKey into the KOLAS_SERVICE_KEY env var.

2. Install

npx @vertical-mcp/kolas-mcp

Or install globally:

npm install -g @vertical-mcp/kolas-mcp
kolas-mcp

3. Configure your MCP client

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "kolas-mcp": {
      "command": "npx",
      "args": ["-y", "@vertical-mcp/kolas-mcp"],
      "env": {
        "KOLAS_SERVICE_KEY": "your-optional-data.go.kr-key"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "kolas-mcp": {
      "command": "npx",
      "args": ["-y", "@vertical-mcp/kolas-mcp"]
    }
  }
}

Smithery-hosted (coming soon)

When the Smithery hosted deploy is live, register the session-scoped kolasServiceKey via Smithery's config UI — no local env var needed.

Environment variables

| Variable | Required | Description | |----------|----------|-------------| | KOLAS_SERVICE_KEY | Optional | data.go.kr ServiceKey for dataset 15054300 (annual statistics). Not required for live lab search. |

Examples

List Korean calibration labs with "length" in their scope

search_accredited_labs({
  query: "길이",
  category: "CALIBRATION",
  page: 1,
  page_size: 20
})

Look up a single testing lab by accreditation number

get_lab_details({ accreditation_no: "KT001" })

Annual accreditation counts for 2023

get_kolas_statistics({ year: "2023" })

Accreditation-number prefix cheat sheet

| Prefix | Category | Standard | |--------|----------|----------| | KC | Calibration (교정) | ISO/IEC 17025 | | KT | Testing (시험) | ISO/IEC 17025 | | KI | Inspection (검사) | ISO/IEC 17020 | | KM | Medical testing (의료시험) | ISO 15189 | | KR | Reference material producer (표준물질생산) | ISO 17034 | | KP | Proficiency testing provider (숙련도시험) | ISO/IEC 17043 |

The server infers category from this prefix automatically when you pass an accreditation number.

Development

git clone https://github.com/vertical-mcp/kolas-mcp.git
cd kolas-mcp
npm install
npm run build
npm start

Scripts

• npm run dev — watch mode via tsx
• npm run build — compile to dist/
• npm run typecheck — no-emit type check
• npm run clean — remove dist/

Data source caveats

search_accredited_labs and get_lab_details parse HTML from https://www.knab.go.kr. KOLAS may redesign the portal; if selectors break, open an issue. The statistics endpoint is the more stable path — data.go.kr datasets are versioned and backwards-compatible.

Roadmap

• v0.1 — search_accredited_labs, get_lab_details, get_kolas_statistics (this release)
• v0.2 — list_accreditation_fields (scope taxonomy), get_scope_by_field (reverse lookup: which labs cover ISO method X?), calibration-lab search via kasto.or.kr
• v0.3 — APLAC/ILAC MRA cross-reference, neighboring-country accreditation bodies (JAB Japan, CNAS China)

Legal / attribution

• Data sources:
  • KNAB (KATS National Accreditation Body) — public HTML portal
  • data.go.kr dataset 15054300 — Ministry of Trade, Industry and Energy (MOTIE) / KATS
• This package is an unofficial community wrapper. It is not affiliated with or endorsed by KATS, KOLAS, or MOTIE.
• Please respect the source portals' rate limits — scraping is courteous and sparse by default.

License

MIT © 2026 Yongbum Kim