Census (ACS by ZIP)

census-mcp

エージェント内で、ZIPコードごとの米国国勢調査データを参照できます。 MCP サーバーです。LLM が任意の ZIP コードについて、所得、人口統計、住宅、教育の情報を検索できます。 Anthropic 公式の mcp Python SDK を基盤に構築されています。

すべてのツールは読み取り専用です。データは米国国勢調査局の American Community Survey（ACS） 5 年分のリリースです。一度だけ一括ダウンロードしてローカルストアに保存し、その後はオフラインで提供します。 一度限りのダウンロードには無料の Census API キーが必要です。

ステータス：公開済み（v0.1.2）— uvx mcpwright-census（PyPI）で利用でき、公式 MCP Registry には io.github.mcpwright/census-mcp として登録されています。以下の 8 つのツールはすべて稼働中で、単体テスト済みです。ACS 5 年分の最新リリース（執筆時点では vint​​age 2024。サーバーが最新のものを自動検出します）を使ったエンドツーエンドの検証も完了しています。mcpwright スイートの一部です。

ツール

ツール	説明
lookup_zip(zip_code)	ZIP コードが Census ZCTA に対応していることを確認し、名称、総人口、ACS のビンテージを返します。
get_income(zip_code)	世帯収入の中央値、一人当たり所得、総世帯数、および年収 20 万ドル以上の世帯の割合を返します。
get_demographics(zip_code)	総人口と年齢の中央値を返します。
get_housing(zip_code)	住宅価格の中央値、家賃総額の中央値、居住中の住宅戸数、および持ち家率を返します。
get_education(zip_code)	25 歳以上の成人のうち、学士号以上を取得している人の割合と、大学院または専門職学位を取得している人の割合を返します。
compare_zips(zips, metric)	複数の ZIP コードを 1 つの指標（所得、年齢、住宅価格、学歴など）で順位付けし、値の高い順に返します。
get_acs_variable(zip_code, variable)	代替手段として、保存されている任意の ACS 変数の生の値をコードまたはわかりやすい名称で返します。
find_zips(place, state=None)	逆引き：都市、町、CDP に含まれる ZIP コードを、それぞれの土地のうち該当する地域に含まれる割合で順位付けして返します。

ZIP は ZCTA（ZIP Code Tabulation Area）とほぼ同じです。大半は一致しますが、約 2% の ZIP コード（私書箱専用／非住宅用）には ZCTA がなく、エラーが返されます。ACS の数値はすべて 5 年分の推定値です。

find_zips は地域から ZIP コードを探す逆方向の検索です。概算値です。ZCTA は地域の境界内に完全には収まらないため、1 つの ZIP コードが複数の地域にまたがることも、その逆もあります。各結果の coverage_pct を確認し、同じ名前の地域（例：MA 州と OH 州の Cambridge）を区別するには state を指定してください。この機能は、公開されている 2020 Census ZCTA-to-Place relationship file を基盤としています（2020 年の地理データ。API キーは不要です）。

インストール

Python 3.12 以降と無料の Census API キーが必要です （CENSUS_API_KEY を設定してください）。PyPI パッケージ名は mcpwright-census です。コマンド、サーバー、ツールの名称はいずれも「census」です。

export CENSUS_API_KEY=your-free-key
uvx mcpwright-census setup     # one-time: bulk-download the ACS dataset into a local store

Claude Code

claude mcp add census -e CENSUS_API_KEY=your-free-key -- uvx mcpwright-census

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "census": {
      "command": "uvx",
      "args": ["mcpwright-census"],
      "env": { "CENSUS_API_KEY": "your-free-key" }
    }
  }
}

初回実行時に、ACS データセット全体（約 33,000 ZCTA）が OS のキャッシュディレクトリ内のローカル SQLite ストアにダウンロードされます。そのため、以降の検索はすぐに完了し、オフラインでも利用できます。事前に mcpwright-census setup を実行するか、初回使用時にサーバーが遅延ダウンロードするのに任せてください。新しい ACS ビンテージが公開されたら、mcpwright-census refresh で再取得できます。CENSUS_MCP_STORE でストアの保存先を変更できます。

開発

git clone https://github.com/mcpwright/census-mcp && cd census-mcp
uv sync
uv run pytest -v                                     # tests (mocked Census + seeded SQLite)
uv run ruff check src/ && uv run ruff format --check src/   # lint + format
uv run mypy                                          # type checking
uv run mcp dev src/census_mcp/server.py              # poke the tools in the MCP Inspector

ロードマップ

• lookup_zip — ZIP コードの検証、名称と人口
• get_income — 所得の指標と年収 20 万ドル以上の世帯の割合
• get_demographics — 人口と年齢の中央値 (年齢区分は今後追加予定)
• get_housing — 住宅価格の中央値、家賃、持ち家率
• get_education — 学士号以上の割合、大学院学位の割合
• compare_zips — 複数の ZIP コードを 1 つの指標で順位付け
• get_acs_variable — 保存されている任意の ACS 変数の生の値（代替手段）
• find_zips — 逆引き：地域から ZIP コードを検索し、土地のカバー率で順位付け
• get_demographics の年齢区分（18 歳未満／18～34 歳／35～64 歳／65 歳以上）
• PyPI（mcpwright-census）と公式 MCP Registry で公開

プライバシー

census-mcp はすべてお使いのマシン上で動作し、個人データを収集、保存、送信することはありません。アカウント、トラッキング、テレメトリーもありません。外部へのリクエストは、公開データをダウンロードするために**米国国勢調査局（U.S. Census Bureau）**へ送信するもののみです。ACS データセットには api.census.gov（ご自身の CENSUS_API_KEY を使用）、find_zips で使われる地名検索ファイルには www2.census.gov（キー不要）を利用します。キーは環境から読み込まれ、ログに記録されたり、ほかの場所へ送信されたりすることはありません。これらのダウンロードは setup／refresh の実行時（または初回使用時に遅延実行）に行われます。その後の検索はローカルストアから提供され、ネットワーク通信は発生しません。ダウンロードしたデータは OS のキャッシュディレクトリに保存されます（公開されている参照データのみ）。いつでも削除できます。

ポリシー全文：https://mcpwright.com/privacy

質問とフィードバック

• 質問、アイデア、「X はできますか？」 → ディスカッション
• バグや具体的な機能リクエスト → イシュー

コントリビューションを歓迎します。

---

mcpwright の一部 · Devender Gollapally が開発