mcpField
C
Census

Census

リモート
pipeworx.io法務・行政05 日前に更新
リポジトリ公式サイト

Census について

Census は、米国国勢調査局の人口、住宅、経済、地理データを複数の地理レベルで照会する MCP サーバーです。一般的な公開データセットは API キーなしで利用できます。

主な機能

  1. 01国勢調査と ACS データの照会
  2. 02人口・住宅指標の取得
  3. 03経済センサスデータへのアクセス
  4. 04複数の地理レベルへの対応
  5. 05公開データをキーなしで利用

活用シーン

  1. 01郡や市町村間の人口比較
  2. 02国勢調査区別の住宅特性の調査
  3. 03地理識別子と境界の検索
  4. 04地域ごとの産業活動の分析

MCP 対応

Pipeworx ゲートウェイ経由、またはローカル stdio の単独 MCP サーバーとして、米国国勢調査局データへのアクセスツールを提供します。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://gateway.pipeworx.io/census/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

詳細

国勢調査 — 米国国勢調査局

米国国勢調査局の公式データです。10年ごとの国勢調査、American Community Survey(ACS)、経済センサス、人口推計、住宅特性、地理的境界を収録しています。全国、州、郡、自治体、国勢調査区、ブロックグループ、ZCTA レベルに対応しています。公開データセットは無料で、キーは不要です。

Pipeworx の一部です。AI エージェントを 1875 以上のライブデータソースにつなぐ MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携、推奨、公開のいずれもされていません。

AI エージェントにとって重要な理由

人口統計、住宅特性、経済活動、地理識別子に関する権威ある情報源が国勢調査データです。エージェントが一人当たりの指標を算出したり、都市圏を比較したり、人口を調べたり、FIPS コードを扱ったりする場合は、ここを利用します。

よくあるフロー:

  • 地域の人口。 州、郡、自治体別の ACS 1 年または 5 年推計。
  • 住宅特性。 住宅価格の中央値、居住状況、住宅戸数、築年数など、すべて ACS に含まれます。
  • 地理 ID の検索。 自治体名 → FIPS コード → 境界形状。
  • 経済センサス は 5 年ごとに実施され、産業別の経済活動を調べられます。

時系列のマクロデータには FRED、労働関連データには BLS を組み合わせてください。

認証

ほとんどの国勢調査 API は無料で、認証も不要です。レート制限は緩やかです(IP あたり約 500 回/日)。より高いレートが必要な場合は、https://api.census.gov/data/key_signup.html でキーを取得し、_apiKey 経由で渡してください。

知っておきたいデータセット

データセット頻度地理レベル
10年ごとの国勢調査(PL、DHC)10年ごとブロックレベル以上
ACS 5年毎年ローリング更新国勢調査区/BG(5年間の平滑化)
ACS 1年毎年人口 6万5,000 人以上の自治体
人口推計プログラム(PEP)毎年郡レベル
経済センサス5年ごと産業 × 地理レベル

現在の人口統計データには、通常 ACS 5 年を使います。1 年データより細かな地理レベルで利用でき、5 年間のローリング平滑化を適用して毎年更新されます。

よくある落とし穴

  • 対象期間と公表年の違い。 ACS 5 年データの 2018~2022 年分は、2023 年に公表されました。混同しないでください。
  • 誤差範囲。 ACS には各推計値の誤差範囲(MOE)が含まれます。小さな地理単位(ブロックグループ、小規模な国勢調査区)では、MOE が推計値を上回ることがあります。必ず MOE もユーザーに提示してください。
  • 地理階層。 州(01)→ 郡(01001)→ 国勢調査区(01001020100)→ ブロックグループ。11 桁の国勢調査区コードは、州(2 桁)+郡(3 桁)+国勢調査区(6 桁)です。
  • 自治体と MSA の違い。 「Denver」は、デンバー市郡を指す場合もあれば、デンバー・オーロラ・レイクウッド大都市統計地域を指す場合もあります(境界も人口も大きく異なります)。用途に応じて明確にしてください。
  • 人口推計は 10 年ごとの国勢調査に遅れます。 国勢調査の間、PEP の推計は外挿され、改訂されます。国勢調査局は出生、死亡、移住のデータとの照合に伴い、過去の PEP も毎年改訂します。

クイックスタート

MCP クライアント(Claude Desktop、Cursor、Windsurf など)に追加します:

{
  "mcpServers": {
    "census": {
      "url": "https://gateway.pipeworx.io/census/mcp"
    }
  }
}
このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/census/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール(ask_pipeworx、 discover_tools、search_within、remember/recall など、ゲートウェイ全体で使える一連のツール)も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールとともに、共有ツールが約 30 個表示されます。接続の initialize レスポンスに正確なスコープが記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図的な仕様であり、偶発的な多重化ではありません。メタツールを使うと、このパックが対応していない質問にも、カタログ全体を対象に処理を振り分ける ask_pipeworx 経由で回答できます。そのため、2 つ目の MCP サーバーを追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加スキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントに接続するのではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx フルゲートウェイに接続して、このパックのツールだけでなく、すべてのパックのツールを直接一覧表示できます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL からも同じゲートウェイと 1875 以上のデータソースにアクセスできます。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合は、HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/census_population \
  -H 'Content-Type: application/json' \
  -d '{"place":"Travis County, TX"}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/census_population を使用します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

スタンドアロン(ゲートウェイアカウント不要)

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です。

{
  "mcpServers": {
    "census": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-census"]
    }
  }
}

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-census

stdin/stdout 経由で MCP 通信を行い、このパックのツールのみを対象に initialize/tools/list/tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。上記のパックエンドポイントとフルゲートウェイのどちらでも利用できます。

ask_pipeworx({ question: "your question about Census data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

ライセンス

MIT

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。