loc8n Geographic Data

@gener8v/mcp-geographic-data

loc8n Geographic Data API 用の MCP サーバーです。米国の人口統計、住宅、住宅ローン、人口移動、雇用、地理データを、MCP 互換のあらゆるクライアント（Claude Desktop、Claude Code、Cursor など）で使えるツールとして提供します。

クイックスタート

npm install -g @gener8v/mcp-geographic-data

API キーを設定します。

export LOC8N_API_KEY="your-api-key"

loc8n.com でキーを取得してください。

使い方

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "geographic-data": {
      "command": "mcp-geographic-data",
      "env": {
        "LOC8N_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

プロジェクトの .mcp.json に追加します。

{
  "mcpServers": {
    "geographic-data": {
      "command": "mcp-geographic-data",
      "env": {
        "LOC8N_API_KEY": "your-api-key"
      }
    }
  }
}

ホスト型 SSE（インストール不要）

MCP 互換クライアントを、ホスト型サーバー mcp.loc8n.com に直接接続します。API キーはクエリパラメーターまたは Authorization ヘッダーとして渡します。

SSE endpoint: https://mcp.loc8n.com/sse?apiKey=YOUR_API_KEY

または、Bearer トークンを使用します。

GET https://mcp.loc8n.com/sse
Authorization: Bearer YOUR_API_KEY

接続ごとに分離されたセッションが作成されます。すべてのリクエストで API キーが使用され、利用状況はアカウントに対して記録されます。

Cursor

Cursor の MCP 設定に追加します。

{
  "mcpServers": {
    "geographic-data": {
      "url": "https://mcp.loc8n.com/sse?apiKey=YOUR_API_KEY"
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "geographic-data": {
      "serverUrl": "https://mcp.loc8n.com/sse?apiKey=YOUR_API_KEY"
    }
  }
}

セルフホスト型 SSE

開発またはカスタムデプロイ用に、サーバーをローカルで実行します。

mcp-geographic-data --transport sse --port 3100

エンドポイント：

• SSE：http://localhost:3100/sse
• メッセージ：http://localhost:3100/messages
• ヘルスチェック：http://localhost:3100/health

ツール（23）

地理情報の検索

ツール	説明
lookup_zip_code	ZIP コードの詳細（市、郡、州、座標）を取得します
search_zip_codes_by_city	市／州から ZIP コードを検索します
find_zip_codes_in_radius	指定した地点から一定範囲内の ZIP コードを検索します
calculate_zip_code_distance	2 つの ZIP コード間の距離を計算します
search_areas	名前から郡、州、または都市圏を検索します

人口統計

ツール	説明
get_demographics	人口、所得、教育などの人口統計プロファイル全体を取得します
get_demographics_category	人口統計の単一カテゴリの詳細を取得します
get_demographics_trend	年ごとの人口統計の推移を取得します
compare_demographics	2 つの地域を並べて比較します

住宅・市場データ

ツール	説明
get_fair_market_rent	寝室数別の HUD 公正市場家賃を取得します
get_fmr_trend	公正市場家賃の経時的な推移を取得します

住宅ローン・融資

ツール	説明
get_mortgage_summary	HMDA 住宅ローン組成の概要を取得します
get_mortgage_trends	住宅ローン融資の経時的な推移を取得します
compare_mortgage	2 つの地域の住宅ローンを並べて比較します

人口移動

ツール	説明
get_migration_summary	IRS SOI の人口移動の流入・流出概要を取得します
get_migration_flows	地域の主な移動元・移動先の流れを取得します
get_migration_trends	年の組み合わせごとの人口移動の推移を取得します

雇用

ツール	説明
get_employment	LODES の雇用プロファイル（雇用数、業種、賃金）を取得します
get_employment_trend	雇用の経時的な推移を取得します
compare_employment	2 つの地域の雇用を並べて比較します
get_commute_flows	主な通勤元・通勤先を取得します

ジオコーディング

ツール	説明
geocode_address	住所を座標と FIPS コードに変換します
reverse_geocode	座標を住所と地域識別子に変換します

リソース（7）

URI	説明
data://demographics/available-years	ACS 人口統計データで利用可能な年
data://fmr/available-years	HUD 公正市場家賃データで利用可能な年
data://mortgage/available-years	HMDA 住宅ローンデータで利用可能な年
data://migration/available-years	IRS 人口移動データで利用可能な年の組み合わせ
data://employment/available-years	LODES 雇用データで利用可能な年
data://tiers	サブスクリプション階層の定義と権限
data://auth/context	現在の API キーの階層、権限、レート制限

環境変数

変数	必須	デフォルト	説明
LOC8N_API_KEY	はい	—	loc8n Geographic Data API の API キー
LOC8N_API_BASE_URL	いいえ	https://api.loc8n.com	API のベース URL

CLI オプション

mcp-geographic-data [options]

  --transport <stdio|sse>  Transport protocol (default: stdio)
  --port <number>          Port for SSE transport (default: 3100)
  --help, -h               Show help

ライセンス

MIT