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