UNESCO UIS Education Statistics MCP

UNESCO UIS 教育統計 MCP サーバー

🇧🇷 ポルトガル語で読む

公開済みでホスト型、出典情報を重視した、MCP 対応の UNESCO Institute for Statistics（UIS） 統計サーバーです。教育、科学・研究開発、文化、コミュニケーションに関する統計を提供します。インストール不要、アカウント不要、API キー不要です。MCP クライアントからホスト済みエンドポイントに接続して、国・地域・年別の就学者数、修了者数、学校に通っていない子ども、識字率、教育支出、研究者数、研究開発支出について質問できます。Cloudflare Workers 上で Streamable HTTP を使用して動作し、公式の UIS Data API と通信します。

独立したプロジェクトです。 UIS の公開 Data API を利用する、非公式のコミュニティ開発クライアントです。UNESCO または UNESCO Institute for Statistics とは提携しておらず、承認も受けていません。 データの著作権は引き続き © UNESCO-UIS に帰属し、CC BY-SA 4.0 のもとで提供されています。データライセンスと帰属表示をご覧ください。

すべての応答には出典情報ブロック（ソース URL、データの基になった UIS のデータリリース、実際の取得タイムスタンプ、ライセンス、UIS の引用）が含まれます。監査証跡付きの正確な数値を提供し、学習データから推測した数値は返しません。

🇧🇷 ポルトガル語でのご案内。 UNESCO Institute for Statistics の統計（国・地域・年別の就学者数、修了者数、学校に通っていない子ども、識字率、教育支出、研究開発）を提供する、リモートのホスト型 MCP サーバーです（インストール不要、アカウント不要、キー不要）。Claude、ChatGPT、その他の MCP クライアントから直接利用でき、すべての応答に出典情報と引用が含まれます：ポルトガル語版 README。

回答できる質問

自然な言葉で、MCP クライアント内から質問できます。アシスタントがツールとフィルターを選びます。

• 「学校に通っていない子どもを追跡する UNESCO の指標はどれですか？」（uis_search_indicators）
• 「2015年以降、ブラジル、ペルー、コロンビアの初等教育修了率はどのように変化しましたか？」（uis_get_data）
• 「GDP に占める政府の教育支出の割合を示す UNESCO の系列はありますか？」 （uis_search_indicators → uis_get_data）
• 「2010年以降、BRICS 諸国の人口100万人あたりの研究者数はいくつですか？」 （uis_search_indicators → uis_get_data）
• 「アルゼンチンとチリの成人識字率を性別ごとに教えてください。」（uis_get_data）
• 「UIS はコートジボワールにどの地理単位コードを使用していますか。また、どの地域別集計がありますか？」 （uis_list_geo_units）

そのうち3つ（就学、識字率、教育支出）は稼働中のサーバーに対して実行されます。ツール呼び出しと返された内容はこちらで確認できます：uis.sidneybissoli.com/examples。

UNESCO の言い回しではなく、ご自身の言葉で質問してください。 UIS の指標はイギリスの統計英語で表現され、カタログは指標名を基に検索されます。そのため、日常的な言い方や米国で使われる言葉では、何も返されないことがありました。公式カタログの5,063件の指標を対象に測定し（2026-09-16）、0.3.0 以降は修正済みです。検索時に入力語をデータソースで使われている表現に展開します（語句内は OR、語句間は AND。検索結果が増える方向にのみ作用します）。さらに、vocabulary_notes で翻訳したことを伝えます。結果がゼロの場合は、次に何を試すべきかを示す hint が表示されます。同じ表が search インデックス（Deep Research）にも使われます。

質問に使う語	変更前のヒット数	UNESCO での表現	ヒット数
enrollment	0	enrolment	387
education spending、budget	0	expenditure	57
teacher wages	0	salary	4
university、college	0	tertiary	448
preschool、kindergarten	0	pre-primary、early childhood	113
elementary	0	primary	886
scientists	0	researchers	11
girls、women	0	female	1,252
kids、teenagers	0	children、adolescents	161, 131
graduation rate	0	completion	342
pupil-teacher ratio	0	pupil-qualified teacher ratio	10
foreign students	249	internationally mobile students	979
primary school completion	0	primary education	114
illiteracy、maths、tvet、phd、stem	0	illiterate、mathematics、vocational、doctoral、science、technology、engineering	268、79、33、24、9

カタログに質問の語がなく、データソースの語があると測定された組み合わせのみを含めています。件数とともに src/uis/vocabulary.ts に記載されています。UIS が公開していない用語は対象外で、検索結果は引き続きゼロになります。存在しないデータに別名を付けると、データソースにないものを約束してしまうためです。dropout、tuition、unemployment、labor はその例です（労働統計は姉妹サーバーの ilo-mcp-server が扱っています。現在 labor に一致するのは、「collaboration」を含む62件の名称です）。

他の選択肢との比較

UIS データをすでに扱っている人には、優れたツールが揃っています。このサーバーはそのどれも置き換えません。データ利用の流れの中で別の役割を担います。質問が出された時点で、アシスタント内から、出典、データ公開版、ライセンスを添えて回答します。バージョンの測定日は2026-10-02です。

ツール	内容	選ぶとよい場合
uis-mcp-server（このサーバー）	ホスト済みのリモート MCP サーバーで、インストールは不要です。約5,060件のUIS指標を対象とする5つのツールを備え、回答ごとに出典情報ブロックを提供します	アシスタント（Claude、ChatGPT、Cursor、Claude Code）で質問し、回答を監査可能にする必要がある場合
uisapi 0.1.1（R、CRAN）	UIS Data APIのコミュニティ製Rクライアント（UIS職員によるものではありません）。一括ダウンロード用ファイルも一覧表示します	Rを使っていて、分析用にUISの時系列データをデータフレームで取得したい場合
unesco-reader 3.1.1（Python、PyPI）	UIS Data APIのコミュニティ製Pythonクライアント	パイプラインでPythonを使っている場合
global-education-mcp 0.4.0（MCP、Python）	別のMCPサーバーです。UIS Data APIとOECDのEducation at a Glance APIを利用します	1つのローカルサーバーでUISとOECDの教育データを並べて見たい場合
unesco-mcp（MCP、Python、PyPI）	UIS APIを利用する別のMCPサーバーです。uvxでローカル実行でき、カタログはSQLiteにキャッシュされ、ランキングおよび比較ツールを備えています（2026-10-13に確認）	分析ツールが組み込まれたローカルサーバーを使いたい場合
UNESCO UIS Statistics Scraper（Apify actor）	同じData APIを利用するコミュニティ製actorです。Apifyの汎用MCPサーバーのツールとして公開されています。Apifyアカウントが必要で、結果ごとに課金されます（プランにより1行あたりUS$ 0.002–0.004、2026-10-13）。出力にはデータのリリース情報はなく、ソースURLのみが含まれます	すでにApifyのパイプラインを運用していて、UISの行データをApifyのデータセットに取り込みたい場合
WDI / wbstats（R）、wbgapi（Python）	世界銀行のクライアントです。WDIはUISの教育関連時系列データを多数、遅れて再公開しています	UISの教育関連時系列データを世界銀行の指標と並べて見たい場合
UIS Bulk Data Download Service	UISが提供する、データリリースごとのCSVファイル（SDGおよびOPRI）です	回答ではなく、データセット全体が必要な場合
UIS Data API	このサーバーが呼び出すデータソースそのものです。キーは不要です	独自のクライアントを構築し、完全に制御したい場合

SDMXについて： UISは現在、SDMXを提供していません。従来のSDMX APIは2020-06-23にサポート終了となり（UIS自身の2026年2月のデータリリースノートに記載）、エンドポイントは現在404を返します。現在もUNESCOソースを一覧に載せている汎用SDMXクライアント（例：sdmx1）は、その利用できなくなったURLを参照しており、DBnomicsにあるUNESCOデータのコピーは2020年頃のスナップショットのままです。労働統計のSDMXについては、ILOSTAT SDMX APIを利用する姉妹サーバーilo-mcp-serverをご覧ください。

このサーバーを使わないでください： 回答ではなくデータセット全体が必要な場合（一括ファイルが適切です）、質問の対象がUISの公表する教育、科学、文化、コミュニケーション統計ではない場合（労働統計ならILO、国民経済計算ならIMF／世界銀行）、またはマイクロデータが必要な場合です。UISが公表しているのは集計データであり、このサーバーも同様です。

姉妹サーバー： 他の公的データソース向けに、同じ設計と出典情報ブロックを備えています。 ILOSTAT（ILOの労働統計）、 IBGE（ブラジルの統計）、 BCB（ブラジル中央銀行）、 Senado（ブラジル上院のオープンデータ）、 SIH/SUS（ブラジルの入院データ）、 医療用語（ICD-11、ICD-10、LOINC、RxNorm、ATC、MeSH）。

利用方法（ホスト型 — セットアップ不要）

任意の MCP クライアントで、Streamable HTTP エンドポイントを指定してください。

https://uis.sidneybissoli.com/mcp

Claude Desktop / Claude Code、およびネイティブのリモートサポートに対応したその他のクライアント：

{
  "mcpServers": {
    "unesco-uis": {
      "url": "https://uis.sidneybissoli.com/mcp"
    }
  }
}

コマンドとして MCP サーバーを起動するクライアントでは、 mcp-remote ブリッジを使用してください。

{
  "mcpServers": {
    "unesco-uis": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://uis.sidneybissoli.com/mcp"]
    }
  }
}

uis-mcp-server.sidneybissoli.workers.dev ホスト名も、セカンダリとして提供されています。

ChatGPT（Deep Research）

ChatGPT の Deep Research（および会社のナレッジ、Responses API 経由のリサーチワークフロー）で使用できるのは、search と fetch のみを公開する MCP サーバーです。このサーバーは uis_* ツールに加えて、これらのツールを公開しています。ホスト型エンドポイントをコネクターに指定してください。キーは不要です。

https://uis.sidneybissoli.com/mcp

search は、クエリを UIS の全カタログ（約 5,060 件の指標 — 教育、科学／研究開発、文化、人口統計上のコンテキスト）と照合して順位付けし、{ id, title, url }（ind:<code>、例：ind:ROFST.1.CP）を返します。fetch は、指標を読みやすい Markdown として返します。内容は、名称、テーマ、Data Browser のグループとフレームワーク、利用可能な年、データサンプル（ブラジルと SDG の世界集計、直近 5 年分。固定したリリースを使用する Data API 呼び出し 1 回分）、および uis_get_data を使ったクエリ方法です。また、ChatGPT が引用に使用する公開 UIS Data Browser ページを url として返します （https://databrowser.uis.unesco.org/view#indicatorPaths=<framework>%3A0%3A<code>）。search／fetch のテキストチャネルは、Deep Research の仕様に沿った JSON（フッターなし）です。出典情報は structuredContent と _meta で渡されます。ChatGPT の開発者モード（Settings → Security and login → Developer mode）では、任意のツールを呼び出せます。データには、引き続き uis_* ツールを使用してください。

ローカルで実行（stdio）

クエリをサードパーティーホスト経由にしたくない場合は、同じサーバーをローカルの stdio プロセスとして実行し、公式 UIS Data API に直接接続できます。ツールは同じ 5 種類、リソースは同じ 3 種類で、制限と出典情報ブロックも同じです。Cloudflare を介しません。2 つのランタイムのインターフェースは設計上同一です（CI で確認します：node scripts/dump-surface.mjs --stdio）。

インストールは不要です。パッケージは npm で入手できます（uis-mcp-server、Node ≥ 22）。

{
  "mcpServers": {
    "unesco-uis": {
      "command": "npx",
      "args": ["-y", "uis-mcp-server"]
    }
  }
}

または、ソースから実行します。

git clone https://github.com/SidneyBissoli/uis-mcp-server
cd uis-mcp-server
npm install
npm run build
node dist/cli.js   # serves MCP over stdio (Ctrl+C to stop)

ホスト型サーバーとの違いは、いずれも Cloudflare バインディングがないことによるものです。

• 現在のデータリリース（/versions/default）はプロセスのメモリに保持されます。セッションごとに一度解決され、セッションをまたいでは保持されません。
• 指標カタログと地理単位は、最初の検索時に公式エンドポイント（/definitions/indicators、/definitions/geounits — ホスト型カタログのシード元と同じもの）からダウンロードされます（約 1 秒）。このダウンロードの実際の retrieved_at が出典情報として報告されます。
• インメモリカタログは UIS Data Browser の定義（約 6.7 MB）をダウンロードしないため、fetch が引用する URL は Data Browser のホームページにフォールバックし、search インデックスのキーワードにはグループ名が含まれません。Deep Research はグループ名を持つホスト型サーバーに接続します。
• 使用状況の指標、レート制限、認証はありません。

ログは stderr に出力されます。stdout には JSON-RPC ストリームのみが出力されます。リポジトリの Dockerfile はこのランタイムをビルドします（Glama レジストリで使用）。

ツール

ツール	機能	ソース
uis_search_indicators	約5,060件の指標（4つのテーマ）を、データの利用可否とともにキーワード検索します。ユーザーの用語をUNESCOの用語に置き換え、その旨をvocabulary_notesで伝えます。offsetによるページネーションに対応しています	ローカルカタログ（上流への呼び出しなし）
uis_list_geo_units	462件の国・地域コード（NATIONAL/REGIONAL）を一覧表示します。offsetによるページネーションに対応しています	ローカルカタログ（上流への呼び出しなし）
uis_get_data	指標、地理単位、年ごとのレコードを取得します。脚注は任意です	クエリごとにData APIを1回呼び出します（固定リリース）
search	ChatGPT Deep Researchの仕様に対応します。クエリを全カタログに照らしてランク付けし、{ id, title, url }（ind:<code>）を返します	ローカルカタログから構築されたメモリ内インデックス（24時間）
fetch	ChatGPT Deep Researchの仕様に対応します。1つの指標を読みやすいMarkdown（カタログ項目＋データサンプル）として返し、公開Data Browserページをurlに設定します	ローカルカタログ＋Data APIの呼び出し1回（サンプル）

一般的な流れ：uis_search_indicatorsで指標コードを検索 → uis_list_geo_unitsで国・地域コードを確認 → 年フィルターを指定してuis_get_dataを呼び出します。

すべてのレスポンスには、ポートフォリオの来歴ブロック （@sbissoli/mcp-provenance、provenance_modeパラメーターでconcise／detailedを指定）と、以下の3つのチャネルが含まれます。 structuredContent、名前空間付きの_meta（com.sidneybissoli.uis/*）、テキストのフッターです。 1.1.0以降、このブロックには呼び出し元の診断情報であるretrievalが含まれます。これは、Data APIへのリクエスト数、試行回数、克服した異常、回答がunstableかどうかを、ポートフォリオ共通のフェッチ機能 （@sbissoli/mcp-upstream）で測定したものです。回答がUISにアクセスしていない場合（カタログまたはキャッシュ済みリリース）はnullです。

リソース

3つのリソース（静的、text/markdown、上流への呼び出しなし）があり、クライアントはツールを呼び出す前にコンテキストに添付できます。これにより、ほとんどのセッションで発生する「どの指標、どのコードか」を調べる呼び出しを省けます。

URI	内容
uis://guide	ツールのワークフロー、コード規則（指標コードの系統と接尾辞、ISO alpha-3地理単位、テーマ）、制限事項、報告ルール
uis://reference/key-indicators	トピック別の検証済み指標コード（修了、未就学、就学、識字、学習到達度、教育支出、SDG 9.5の研究開発費、SDG 11.4の遺産支出、人口）
uis://reference/provenance	すべての来歴フィールドの意味とUISの引用方法。CC BY-SAのShareAlikeが二次利用時に求める事項も含みます

動作と制限

• すべてのデータクエリでリリースを固定します。 uis_get_data は明示的な version= を送信します。これは /versions/default から解決され、24 時間キャッシュされます。再現性があり、上流側のキャッシュも再利用します。リリースは data_vintage（例：20260507-91260335 (published 2026-05-08)）です。UIS が新しいリリースを公開すると、データクエリは 24 時間以内にそのリリースへ移行します。
• 1 回の応答につき最大 5,000 件、1 回の呼び出しにつき最大 25 指標です。 上限を超える場合、サーバーは実際の件数を含む説明付きエラーを返します。出典情報の保証に反するため、完全なデータに見せかけて黙って切り捨てることはありません。UIS 独自の上限である 100,000 件を超える場合は、上流側の説明付き HTTP 400 がそのまま返されます。
• 指標カタログは UIS リリースのスナップショットであり、UIS が新しいリリースを公開したときに手動で更新します（年に 2～3 回）。実際の retrieved_at は uis_search_indicators の出典情報に記録されるため、データの経過期間を常に確認できます（served_from_cache: true）。
• retrieved_at は常に UIS から実際に抽出した時刻であり、ビルド時刻や応答時刻ではありません。異なる時点で抽出した複数の部分を結合する回答（uis_get_data：最大 24 時間キャッシュされた現行リリースと、今回取得したデータ。fetch：カタログの行も含む）の場合は、それらのうち最も古い時刻になります。field_sources には各部分の時刻とキャッシュフラグが個別に記録されます（1.5.1 以降）。
• 通知には脚注の種類、規模、修飾情報が件数とともに記載されます。各脚注の全文は行に保持されます（include_footnotes: true）。
• すべての上流呼び出しにはタイムアウトと再試行ポリシーがあります（1.1.0 以降。2026-09-27 にライブ API で計測：リリース 1.1 秒、小規模クエリ 0.8 秒、指標 5 件全体で 2.9 秒／3.5 MB、100k 上限の 400 は 0.9 秒）。1 試行あたり 35 秒です。これは正当なケースでの最長時間の 10 倍であり、UIS の前段にある AWS API Gateway の 29 秒も上回ります。5xx、429（Retry-After に従います）、ネットワークエラーの場合は最大 3 回試行し、呼び出し全体の上限は 45 秒です。タイムアウト、HTTP 504、説明付きの 400 および 404 は再試行されません。処理の内容は出典情報の retrieval フィールドに記録されます。タイムアウトやネットワーク障害は、生の例外ではなく読みやすいエラーになります。
• derived は常に false です。サーバーは値を変換しません。
• 言語：英語、タイムゾーン：UTC（UIS のデータは英語で公開されています）。

レジストリから確認できるサーフェスフィンガープリント

各リリースは、MCP Registry のエントリーで、そのバージョンが提供するサーフェス（initialize、ツール、リソース、プロンプト）の sha256 と、認証情報なしで応答するメソッドを公開します。バージョンを上げずにサーフェスを変更すると、ビルドは失敗します。レジストリのフィンガープリントを使って、クライアント側でも同じ内容を確認できます。正規形式と手順については、@sbissoli/mcp-surface の SPEC.md を参照してください。自分で確認するには（Node 18 以降、依存関係不要）：

curl -sO https://raw.githubusercontent.com/SidneyBissoli/mcp-br-commons/main/packages/mcp-surface/exemplos/verify.mjs
node verify.mjs io.github.SidneyBissoli/uis-mcp-server

データライセンスと帰属表示

• UIS データ：CC BY-SA 4.0（Data API に適用される UIS Data Browser の利用規約。ライセンス確認日：2026-08-04）。
• すべての応答に UIS の帰属表示を含めます（citation フィールド）。完全な URL と抽出日も記載されます： Source: UNESCO Institute for Statistics (UIS), <URL>, date of extraction <date>.
• ShareAlike：これらのデータを基に再配布するものには、CC BY-SA 4.0 ライセンスを適用する必要があります。詳細は uis://reference/provenance リソースに記載されています。
• UNESCO のロゴは使用しておらず、UNESCO による推奨を示唆するものでもありません。そのため、サーバー名は unesco-mcp-server ではなく uis-mcp-server です。ILOSTAT データ（CC BY 4.0）は別のサーバーで提供されるため、2 つのライセンスが同じ応答に含まれることはありません。

セルフホスティング／開発

以下の内容はすべて、ご自身のインスタンスを実行する場合にのみ必要です。公開サーバーの利用には必要ありません。

npm install
npm run typecheck && npm test   # offline suite (tools, framework, vocabulary, in-memory catalogue, eval fixtures)
npm run dev                     # http://localhost:8787/mcp (Worker)
npm run build                   # stdio runtime → dist/cli.js (what ships to npm)
node scripts/dump-surface.mjs --stdio   # offline smoke of the build: initialize → tools/resources/prompts

# Catalogue seed (D1) — required before first use:
node scripts/seed-uis-catalog.mjs
npx wrangler d1 execute uis-catalog --local  --file=scripts/seed-uis-catalog.sql
npx wrangler d1 execute uis-catalog --remote --file=scripts/seed-uis-catalog.sql

npm run deploy
node scripts/smoke-mcp.mjs      # smoke test against production (initialize → tools/list == /status → uis_* → search/fetch → errors)

運用担当者向けの注意事項：

• カタログの更新は、UIS のデータリリースごとに手動で行います（cron はありません）。本番環境でのスモークテストでは現在の Data API リリースが表示されます。シードのリリースと異なる場合は、上記の 3 つのコマンドを実行して再シードしてください。データクエリは自動的にデフォルトのリリースに従うため、古くなる可能性があるのはカタログのみで、その経過期間はプロベナンスに表示されます。
• UIS Data API は Node の fetch をそのまま受け付けます（ILO ゲートウェイとは異なり、ヘッダーの回避策は不要です）。
• オプションの Bearer 認証（wrangler secret put API_KEY）。IP ごとのトークンバケット方式のレート制限があります。

評価

@sbissoli/mcp-evals：evals/fixtures/queries.ts に 22 個のフィクスチャがあり、npm test でオフライン検証されます。実際のモデルを使った実行（npm run eval）では Anthropic API を使用し、ANTHROPIC_API_KEY が必要です（設定されていない場合は、手順を表示して終了します）。2026-08-07 の実行結果：top-1 100%（20/20） — evals/results/。

エンドツーエンド：evals/e2e/evaluation.xml に、検証可能な単一の回答を持つ複雑な質問が 10 件あります。回答は本番環境と照合して手動で検証しています（evals/e2e/validacao-respostas.md）。2026-08-07 の実行結果（Sonnet）：10/10 — evals/results/2026-08-07-e2e.md。

エンドポイント

ルート	用途
/	ランディングページ（サービスの概要と連絡先 — 公開）
/health	稼働状態
/status	バージョン、ツールの数と名前、現在のデプロイ情報（README のバッジに使用）
/metrics	使用状況の集計（MCP エンドポイントのみ。IP アドレスやクエリの内容は含みません）
/.well-known/mcp/server-card.json	ディレクトリスキャナー向けの MCP サーバーカード（ライブの initialize と lists から生成 — 公開）
/mcp	MCP Streamable HTTP

セキュリティ

Snyk Agent Scan（2026-08-07、search と fetch の追加前）：合格 — レポートは security/ にあります。

ライセンス

コード：MIT。データ：UIS、CC BY-SA 4.0（上記の「データライセンスと帰属表示」を参照）。

プライバシー

ホストサービスのプライバシーポリシー：PRIVACY.md。

連絡先

Sidney da Silva Pereira Bissoli — [email protected]。このサービスは UNESCO の推奨を受けていません。