International Classifications MCP

International Classifications MCP

公式の国際統計分類を検索、説明、検証、対応付けするための、無料で使えるオープンソースの決定論的な MCP サーバーです。

質問票の作成、調査のコーディング、統計の調和、再現可能な分析を目的として設計されています。サーバー内では LLM、埋め込みサービス、有料 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 を呼び出し、1つの識別子を検索またはエクスポートに渡してください。サーバーは、関連のない MICS の選択肢を1つの質問票リストに統合することを拒否します。

国勢調査や行政区画の国別コードは、頻繁に変更され、権威ある世界共通のレジストリが存在しないため、意図的に対象外としています。

対応範囲は 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、厳選された概念ルール、明示的なスコアリングを使用します。
• 対応表では、定義の変更に関する警告と、1対多の対応関係を保持します。
• 詳細な職業、産業、疾病、犯罪のコードは、通常、回答者向けの質問票にそのまま記載せず、回答後にコーディングします。
• ソースコンテンツには引き続き管理機関の利用規約が適用されます。MIT ライセンスの対象はこのソフトウェアであり、サードパーティの分類コンテンツではありません。

ソース監査とエージェントテスト用プロンプトをご覧ください。

ドキュメント

• アーキテクチャ
• ソースと対応範囲の監査
• デプロイ
• 本番運用
• OpenAI ディレクトリへの登録根拠
• コントリビューションとセキュリティポリシー