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 分

    请在仓库或注册中心条目中声明许可证。