International Classifications MCP

国际分类 MCP

一款免费、开源、确定性的 MCP 服务，用于发现、说明、验证和映射官方国际统计分类。

它专为问卷开发、调查编码、统计协调和可复现分析而设计。服务内部不运行大模型、嵌入服务或付费 AI。连接的 AI 客户端负责理解用户任务；本服务提供有版本记录的官方结构、确定性检索和来源追溯。

覆盖范围（v0.5.2）

生产保障措施包括一流的类型化代码表层级节点、针对每个精选代码表的确定性路由测试用例、每周权威链接检查、每个工具的请求 ID 和延迟日志记录，以及有文档记录的 OpenAI 目录注释依据。

注册表包含 ISIC Rev.5、CPC 3.0、COICOP 2018、HS 2022、SITC Rev.4、BEC Rev.5 和 UN M49 的完整机器可读结构；完整的 ISCO-08 编码／标题层级；官方 ISIC Rev.4 到 Rev.5 对照关系；可操作的 ICSE-18、ICSaW-18 和 ISCED 结构；详细的 ISCED-F 和 ICCS 结构；以及明确标注为仅供参考的 ICD-11 和 ICF 条目。

MICS7 仅以精选的、针对特定问题的回答代码表形式呈现，用于匹配问卷答案类别。MICS 模块和分析指标定义不会作为分类开放；指标发现应由开发指标服务负责。回答层不会取代 UNICEF 当前的问卷或国家定制指南，也绝不会在未明确说明的情况下合并不同轮次的 MICS。

0.5 版新增 ICC 1.1、ICATUS 2016、COFOG、COPNI、COPP、UNECE Recommendation 20 度量单位和 Recommendation 21 包装类型；详细的 ISCED-F 和 ICCS 标题；扩展的 ICSE／ICSaW 和 SDMX 核心；以及分别进行版本管理的 DHS-8、Washington Group、JMP WASH、WHO 疫苗接种和 FAO WCA 问卷代码表。

每个精选答案列表都有稳定的 codelist_id。调用 list_codelists，然后将一个标识符传给搜索或导出工具。服务会拒绝将不相关的 MICS 选项合并到同一问卷列表中。

国家人口普查和行政区划代码不在覆盖范围内，因为它们变化频繁，且没有唯一权威的全球注册表。

list_classifications 会明确标示覆盖范围：full、seed、mapping、reference 或 curated。仅供参考和精选的分类系列绝不会被呈现为完整代码列表。

工具

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

连接

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

根 URL 提供服务状态；/mcp 是 MCP 端点。

本地开发

python -m pip install -e ".[dev]"
python -m international_classifications_mcp.build_registry
pytest
classifications-mcp

使用 HTTP 传输：

MCP_TRANSPORT=streamable-http MCP_HOST=0.0.0.0 classifications-mcp

构建理念

• 官方主管机构始终是权威来源。
• 源文件会进行哈希处理，注册表发行版会进行版本管理。
• 搜索通过程序实现：FTS5、精选概念规则和明确的评分机制。
• 对照关系会保留一对多映射以及定义变更警告。
• 详细的职业、行业、疾病和犯罪分类通常应在事后编码，而不是直接放入面向受访者的问卷。
• 源内容仍受其主管机构条款约束；MIT 许可涵盖本软件，不涵盖第三方分类内容。

请参阅来源审计和 Agent 测试提示词。

文档

• 架构
• 来源和覆盖范围审计
• 部署
• 生产运维
• OpenAI 目录提交依据
• 贡献指南和安全政策