loc8n Geographic Data

io.github.gener8v-thomas由 GitHub 帳號 gener8v-thomas 發布v0.1.3更新於 Oct 24, 2026

U.S. demographics, housing, mortgage, migration, and employment data via loc8n API

已驗證SSE可網頁執行位置與生活資料與分析

概覽

AI 產生的概覽

透過 loc8n API 向助理提供美國地理、人口、住宅、房貸、遷移與就業資料的 MCP 伺服器。

可以做什麼
查詢郵遞區號詳情，依城市或半徑搜尋郵遞區號，計算兩地距離，並依名稱搜尋郡、州與都會區；將地址地理編碼為座標與 FIPS 代碼，或反向解析。取得人口統計概況、單一類別、逐年趨勢，以及兩個地區的並排比較。讀取 HUD 公平市場租金及依臥室數分的趨勢。彙整並比較 HMDA 房貸核貸資料與其趨勢。檢視 IRS 遷移流入流出與趨勢，以及 LODES 就業、薪資、通勤流向與比較。讀取各資料集可用年份、目前 API 金鑰層級、權限與速率限制等資源。
適用情境
適合助理需要美國地點與社區資料時使用，例如分析某地人口與收入、比較不同地區、查看租金或房貸活動，或追蹤遷移與通勤模式。
執行需求
可使用託管 SSE 端點，或在本地以 Node.js 執行 npm 套件 @gener8v/mcp-geographic-data。需要 loc8n API 金鑰，透過 LOC8N_API_KEY 環境變數提供，託管服務則使用 Authorization bearer 權杖（或查詢參數）。需要連線至 loc8n API 的網路存取。
安裝前請注意
API 金鑰屬於機密；託管方式允許以 URL 查詢參數傳遞，可能外洩到日誌或共用設定，建議改用 Authorization 標頭。用量會計入你的帳戶，並受訂閱層級與速率限制約束。資料經 loc8n API 來自第三方來源。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 loc8n Geographic Data，將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 SSE。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.gener8v-thomas%2Fmcp-geographic-data/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "loc8n-geographic-data": {
      "type": "sse",
      "url": "https://mcp.loc8n.com/sse",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

@gener8v/mcp-geographic-data

MCP server for the loc8n Geographic Data API. Exposes U.S. demographics, housing, mortgage, migration, employment, and geographic data as tools for any MCP-compatible client (Claude Desktop, Claude Code, Cursor, etc.).

Quick Start

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

Set your API key:

bash
export LOC8N_API_KEY="your-api-key"

Get a key at loc8n.com.

Usage

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Claude Code

Add to your project's .mcp.json:

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

Hosted SSE (no install required)

Connect any MCP-compatible client directly to the hosted server at mcp.loc8n.com. Pass your API key as a query parameter or Authorization header:

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

Or with a Bearer token:

GET https://mcp.loc8n.com/sseAuthorization: Bearer YOUR_API_KEY

Each connection gets an isolated session — your API key is used for all requests and usage is tracked against your account.

Cursor

Add to your Cursor MCP settings:

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

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

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

Self-Hosted SSE

Run the server locally for development or custom deployments:

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

Endpoints:

  • SSE: http://localhost:3100/sse
  • Messages: http://localhost:3100/messages
  • Health: http://localhost:3100/health

Tools (23)

Geographic Lookup

ToolDescription
lookup_zip_codeGet details for a ZIP code (city, county, state, coordinates)
search_zip_codes_by_cityFind ZIP codes for a city/state
find_zip_codes_in_radiusFind ZIP codes within a radius of a point
calculate_zip_code_distanceCalculate distance between two ZIP codes
search_areasSearch counties, states, or metro areas by name

Demographics

ToolDescription
get_demographicsFull demographic profile (population, income, education, etc.)
get_demographics_categorySingle demographic category in detail
get_demographics_trendYear-over-year demographic trends
compare_demographicsSide-by-side comparison of two areas

Housing & Market Data

ToolDescription
get_fair_market_rentHUD Fair Market Rent by bedroom count
get_fmr_trendFair Market Rent trends over time

Mortgage & Lending

ToolDescription
get_mortgage_summaryHMDA mortgage origination summary
get_mortgage_trendsMortgage lending trends over time
compare_mortgageSide-by-side mortgage comparison of two areas

Migration

ToolDescription
get_migration_summaryIRS SOI migration inflows/outflows
get_migration_flowsTop origin/destination flows for an area
get_migration_trendsMigration trends across year pairs

Employment

ToolDescription
get_employmentLODES employment profile (jobs, sectors, wages)
get_employment_trendEmployment trends over time
compare_employmentSide-by-side employment comparison
get_commute_flowsTop commute origins/destinations

Geocoding

ToolDescription
geocode_addressConvert address to coordinates and FIPS codes
reverse_geocodeConvert coordinates to address and area identifiers

Resources (7)

URIDescription
data://demographics/available-yearsAvailable years for ACS demographics data
data://fmr/available-yearsAvailable years for HUD Fair Market Rent data
data://mortgage/available-yearsAvailable years for HMDA mortgage data
data://migration/available-yearsAvailable year pairs for IRS migration data
data://employment/available-yearsAvailable years for LODES employment data
data://tiersSubscription tier definitions and permissions
data://auth/contextCurrent API key tier, permissions, and rate limits

Environment Variables

VariableRequiredDefaultDescription
LOC8N_API_KEYYes—API key for the loc8n Geographic Data API
LOC8N_API_BASE_URLNohttps://api.loc8n.comAPI base URL

CLI Options

mcp-geographic-data [options]
  --transport <stdio|sse>  Transport protocol (default: stdio)  --port <number>          Port for SSE transport (default: 3100)  --help, -h               Show help

License

MIT

來源：README.md，提交 80f2687

工具

0
該伺服器需要 API 金鑰等憑證，因此 SourceWeft 無法在沒有憑證的情況下讀取其工具，也未收錄。

版本歷史

1
  1. v0.1.3最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。