International Classifications MCP

io.github.lbruce-wqv0.5.2更新於 Oct 1, 2026

Deterministic MCP for statistical classifications and survey codelists with provenance.

已驗證Streamable HTTP可網頁執行Data & AnalyticsKnowledge & Memory

概覽

AI 產生的概覽

讓助理查詢、驗證並對應附帶來源資訊的官方國際統計分類與調查代碼表。

功能
以確定性方式提供附版本資訊的官方統計分類，例如 ISIC、CPC、COICOP、HS、SITC、ISCO 和 UN M49，以及整理過的問卷答案代碼表。工具包括 list_classifications、get_classification、list_codelists、recommend_classifications、search_codes、get_code_definition、browse_hierarchy、validate_codes、map_codes 和 export_choice_list。涵蓋範圍會標示為 full、seed、mapping、reference 或 curated，對應關係會保留一對多與定義變更的警告。伺服器內部不執行 LLM 或嵌入服務。
適用情境
適合問卷設計、調查編碼、統計口径調和與可重現分析等需要官方代碼結構與來源資訊的情境。也適合需要驗證代碼、在分類版本之間對應，或為某個調查問題匯出選項清單的工作流程。
執行需求
遠端 streamable HTTP 端點 classifications.impactengines.ai，MCP 端點為 /mcp。未宣告驗證、環境變數或標頭，也不需要本機安裝套件。需要能連線至該端點的網路。
安裝前請注意
此服務僅做查詢與對應，未描述寫入、傳送或刪除動作。分類來源內容仍受各託管機構條款約束，MIT 授權僅涵蓋本軟體。reference 與 curated 類別並非完整代碼表，MICS 答案清單也不能取代 UNICEF 目前問卷或各國客製指引。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 International Classifications MCP，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "international-classifications": {
      "type": "http",
      "url": "https://classifications.impactengines.ai/mcp"
    }
  }
}

README

International Classifications MCP

A free, open-source, deterministic MCP server for discovering, explaining, validating and mapping official international statistical classifications.

It is designed for questionnaire development, survey coding, statistical harmonisation and reproducible analysis. No LLM, embedding service or paid AI runs inside the server. The connected AI client interprets the user's task; this service provides versioned official structures, deterministic retrieval and provenance.

Coverage (v0.5.2)

Production safeguards include first-class typed codelist hierarchy nodes, deterministic routing fixtures for every curated codelist, weekly authoritative-link checks, per-tool request IDs and latency logging, and documented OpenAI directory annotation justifications.

The registry includes full machine-readable structures for ISIC Rev.5, CPC 3.0, COICOP 2018, HS 2022, SITC Rev.4, BEC Rev.5 and UN M49; a complete ISCO-08 code/title hierarchy; the official ISIC Rev.4 to Rev.5 correspondence; operational ICSE-18, ICSaW-18 and ISCED structures; detailed ISCED-F and ICCS structures; and clearly labelled reference-only entries for ICD-11 and ICF.

MICS7 is represented only by curated, question-specific response codelists for matching questionnaire answer categories. MICS modules and analytical indicator definitions are intentionally not exposed as classifications; indicator discovery belongs in a development-indicators service. The response layer does not replace UNICEF's current questionnaires or country customisation guidance and never silently combines MICS rounds.

Version 0.5 adds ICC 1.1, ICATUS 2016, COFOG, COPNI, COPP, UNECE Recommendation 20 units and Recommendation 21 package types; detailed ISCED-F and ICCS titles; expanded ICSE/ICSaW and SDMX cores; and separately versioned DHS-8, Washington Group, JMP WASH, WHO vaccination and FAO WCA questionnaire codelists.

Each curated answer list has a stable codelist_id. Call list_codelists, then pass one identifier to search or export. The server refuses to merge unrelated MICS choices into one questionnaire list.

National census and administrative geography codes are intentionally out of scope because they change frequently and lack one authoritative global registry.

Coverage is explicit in list_classifications: full, seed, mapping, reference, or curated. Reference-only and curated families are never presented as complete code lists.

Tools

  • list_classifications
  • get_classification
  • list_codelists
  • recommend_classifications
  • search_codes
  • get_code_definition
  • browse_hierarchy
  • validate_codes
  • map_codes
  • export_choice_list

Connect

bash
codex mcp add international-classifications --url https://classifications.impactengines.ai/mcp

The root URL provides service status; /mcp is the MCP endpoint.

Local development

bash
python -m pip install -e ".[dev]"python -m international_classifications_mcp.build_registrypytestclassifications-mcp

For HTTP transport:

bash
MCP_TRANSPORT=streamable-http MCP_HOST=0.0.0.0 classifications-mcp

Build philosophy

  • Official custodians remain authoritative.
  • Source files are hashed and registry releases are versioned.
  • Search is programmatic: FTS5, curated concept rules and explicit scoring.
  • Correspondences preserve one-to-many and changed-definition warnings.
  • Detailed occupations, industries, diseases and crimes are normally post-coded, not dumped into respondent-facing questionnaires.
  • Source content remains subject to its custodian's terms; the MIT licence covers this software, not third-party classification content.

See source audit and agent test prompts.

Documentation

來源：README.md，提交 1ebac59

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.5.2最新Oct 1, 2026