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	计算两个 ZIP 邮政编码之间的距离
search_areas	按名称搜索县、州或都市区

人口统计

工具	描述
get_demographics	完整的人口统计资料（人口、收入、教育等）
get_demographics_category	单个人口统计类别的详细信息
get_demographics_trend	逐年人口统计趋势
compare_demographics	并排比较两个地区的人口统计数据

住房与市场数据

工具	描述
get_fair_market_rent	HUD 按卧室数量划分的公平市场租金
get_fmr_trend	公平市场租金随时间的变化趋势

抵押贷款与放贷

工具	描述
get_mortgage_summary	HMDA 抵押贷款发放概况
get_mortgage_trends	抵押贷款放贷趋势
compare_mortgage	并排比较两个地区的抵押贷款情况

迁移

工具	描述
get_migration_summary	IRS SOI 迁入/迁出概况
get_migration_flows	某个地区的主要迁入来源/迁出目的地
get_migration_trends	各年份区间的迁移趋势

就业

工具	描述
get_employment	LODES 就业资料（职位、行业、工资）
get_employment_trend	就业趋势
compare_employment	并排比较就业情况
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 地理数据 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