civic-library-mcp

civic-library-mcp

AI エージェントが米国の行政・不動産データ（ジオコーディング、国勢調査区、オポチュニティ・ゾーン、ACS の人口統計、FEMA の洪水区域）に、すっきりとトークン効率よくアクセスできる MCP サーバーです。データはすべて、無料の連邦政府オープンデータから取得しています。

スクレイピングも、主要ツールで有料キーも、プロプライエタリなデータベースも不要です。U.S. Census Bureau、U.S. Treasury CDFI Fund、FEMA の公式データを、適切に説明された少数のツールで利用できるようにしています。多くのデータ MCP がコンテキストウィンドウに詰め込む膨大なペイロードではなく、コンパクトな JSON を返します。

プロップテック、不動産、フィンテック、シビックテック、GIS、住宅調査に取り組む開発者が、AI エージェントとともに使えるように設計されています。

---

ツール

ツール	機能	API キー
geocode_address	米国の住所 → 緯度・経度、州、郡、2020 年国勢調査区の GEOID	不要
lookup_census_tract	緯度・経度 → その地点を含む 2020 年国勢調査区（郡・州を含む）	不要
check_opportunity_zone	この住所／地点／国勢調査区は、指定された適格オポチュニティ・ゾーンに該当しますか？	不要
get_tract_demographics	国勢調査区の ACS 5 年指標（所得、人口、住宅価格、貧困率など）	無料の Census キー
check_flood_zone	緯度・経度 → FEMA の洪水ハザード区域、および特別洪水危険区域に該当するかどうか	不要

5 つのツールのうち 4 つは、設定なしで使えます。無料の Census API キーが必要なのは get_tract_demographics のみです（下記参照）。

---

インストール

Claude Desktop／Cursor／任意の MCP クライアント

MCP 設定に追加します（例：claude_desktop_config.json）。

{
  "mcpServers": {
    "civic-library": {
      "command": "npx",
      "args": ["-y", "civic-library-mcp"],
      "env": {
        "CENSUS_API_KEY": "your-free-census-key-optional"
      }
    }
  }
}

Claude Code

claude mcp add civic-library -- npx -y civic-library-mcp

CENSUS_API_KEY の行は省略可能です。省略しても、5 つのツールのうち 4 つは引き続き使えます。

Census API キー（人口統計データのみ）

get_tract_demographics は、無料のキーが必要な U.S. Census ACS Data API を呼び出します。https://api.census.gov/data/key_signup.html で約 30 秒で取得し、サーバーの環境変数 CENSUS_API_KEY に設定してください。

---

使用例

物件がオポチュニティ・ゾーンに該当するかを確認する：

// check_opportunity_zone({ "address": "900 Camp St, New Orleans, LA 70130" })
{
  "is_opportunity_zone": true,
  "tract_geoid_2010": "22071013400",
  "designation_type": "Low-Income Community",
  "round": "1.0",
  "authority": "Tax Cuts and Jobs Act of 2017 (26 U.S.C. § 1400Z-1)",
  "resolved_from": "address",
  "source": "U.S. Treasury CDFI Fund (designated 2018-12-14)"
}

座標の洪水リスク：

// check_flood_zone({ "latitude": 29.9511, "longitude": -90.0715 })
{
  "flood_zone": "X",
  "zone_subtype": "0.2 PCT ANNUAL CHANCE FLOOD HAZARD",
  "in_special_flood_hazard_area": false,
  "zone_description": "Moderate-to-minimal risk (outside the 1% annual-chance floodplain).",
  "source": "FEMA National Flood Hazard Layer"
}

国勢調査区の人口統計（キーが必要）：

// get_tract_demographics({ "tract_geoid": "22071013400",
//   "fields": ["population", "median_household_income", "poverty_rate"] })
{
  "tract_geoid": "22071013400",
  "tract_name": "Census Tract 134, Orleans Parish, Louisiana",
  "acs_dataset": "ACS 5-Year 2023",
  "population": 2276,
  "median_household_income": 41250,
  "poverty_rate": 0.231
}

---

正確性に関する注意：オポチュニティ・ゾーンは 2010 年の国勢調査区を使用します

オポチュニティ・ゾーンの指定は2010 年の国勢調査区境界に基づいていますが、Census の標準ジオコーダーが返すのは2020 年の国勢調査区です。また、国勢調査区の GEOID は 2 つの時点の間で変更されています。2020 年の GEOID を OZ リストと照合する単純な検索では、境界が変更された場所の近くで、誤った結果が気づかれないまま返されます。

check_opportunity_zone はこの点に正しく対処します。照合の前に住所／座標を2010 年の国勢調査区に再解決します（同じ住所でも、geocode_address では GEOID …980000、check_opportunity_zone では …006202 が返されることを確認できます）。tract_geoid を直接渡した場合は、2010 年の GEOID として扱われます。

---

データソースとライセンス

データ	ソース	備考
ジオコーディングと国勢調査区	U.S. Census Bureau Geocoder	パブリックドメイン
オポチュニティ・ゾーン	U.S. Treasury CDFI Fund	第 1 回（2018 年）の指定。8,764 区を同梱
人口統計	U.S. Census ACS 5-Year	パブリックドメイン。無料のキーが必要
洪水区域	FEMA National Flood Hazard Layer	パブリックドメイン

基となるデータはすべて、米国連邦政府のオープンデータ（パブリックドメイン）です。このソフトウェアは MIT ライセンスです。

同梱のオポチュニティ・ゾーンリストは npm run build:oz で再生成できます。

---

ロードマップ

• OZ 2.0 — One Big Beautiful Bill Act（2025）に基づく指定。最終決定・公開後に対応します。
• ACS のフィールド拡充 — 学歴、人種・民族、住宅の所有形態、通勤。
• 郡ごとの地籍情報／CAD の照会 — 自動アクセスが情報源の利用規約で許可されている場合に限り、郡ごとに追加します。
• Census の place および ZIP の地理区分、FEMA の基準洪水標高。

---

免責事項

このツールは、情報提供を目的として政府の公開データを提示します。法律、金融、税務、保険、投資に関する助言ではありません。 Opportunity Zone、洪水区域、人口統計に関する判定は、取引で利用する前に公式な記録の情報源で確認してください。データは保証なしの「現状有姿」で提供されます。

貢献

Issue と PR を歓迎します。特に、連邦政府のオープンデータソースや ACS フィールドの追加を歓迎します。レスポンスは簡潔に保ち（トークンコストは機能の一部です）、すべてのデータポイントに情報源を明記してください。

ライセンス

MIT © 2026 Adrian Cisneros