AI导哈

人口普查数据API服务

提供美国人口普查局数据的API服务，包括人口统计、收入、住房等信息。

  • by shawndrake2
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 shawndrake2/mcp-census

使用说明

人口普查API MCP服务器

访问美国人口普查局的数据，包括人口统计、人口、收入、住房等。

可用数据

  • 美国社区调查（ACS） -详细的人口和社会经济数据
    • 1年估算(acs/acs1)-人口超过65000的地区
    • 5年估算(acs/acs5)-所有地区，对小人口来说更可靠
  • 十年一次的人口普查 (dec/pl)-每10年统计一次官方人口
  • 经济普查 -工商统计
  • 人口估计 -两次人口普查之间的年度人口估计数

设置

  1. 获取免费API密钥，网址：https://api.census.gov/data/key_signup.html
  2. 添加到MCP配置中：
{
  "census": {
    "command": "node",
    "args": ["/path/to/census-api/dist/index.js"],
    "env": {
      "CENSUS_API_KEY": "your-api-key"
    }
  }
}

工具

query

获取人口普查数据，完全控制变量和地理位置。

参数 必填 说明
年份 是 数据年份（例如“2022”）
数据集 是 数据集路径（例如，“acs/acs1”、“acs/acf5”、“dec/pl”）
变量 是 逗号分隔的变量代码（例如，“NAME，B19013_001E”）
forClause Yes 要获取的地理位置（例如，“状态：“，”县：“，”状态：06“）
inClause 否 嵌套查询的父地理位置（例如，在获取县时为“state:06”）

例子： 获得所有州的家庭收入中位数

year: "2022"
dataset: "acs/acs5"
variables: "NAME,B19013_001E"
forClause: "state:*"

list_datasets

列出给定年份的可用人口普查数据集。

参数 必填 说明
年份 是 列出数据集的年份

list_variables

在数据集中搜索变量。有助于找到正确的变量代码。

参数 必填 说明
年份 是 数据年份
数据集 是 数据集路径
search 否 要筛选的关键字（例如，“收入”、“人口”）
limit 否 最大结果（默认值50）

例子： 查找与收入相关的变量

year: "2022"
dataset: "acs/acs5"
search: "income"

list_geographies

列出数据集的可用地理级别。

参数 必填 说明
年份 是 数据年份
数据集 是 数据集路径

get_fips

获取州、县或其他地区的FIPS代码。

参数 必填 说明
年份 是 数据年份
数据集 是 数据集路径
地理 是 级别（例如，“州”、“县”）
inClause 否 父地理筛选器

例子： 获取加利福尼亚州的所有县FIPS代码

year: "2022"
dataset: "acs/acs5"
geography: "county"
inClause: "state:06"

常用变量

变量 描述
B01003_001E 总人口
B19013_001E 家庭收入中位数
B25077_001E 房屋价值中位数
B23025_005E 失业人口
B15003_022E 学士学位持有者
B25064_001E 总租金中位数

速率限制

  • API密钥没有严格的速率限制
  • 无密钥：500个请求/天

文档

  • API文件：https://www.census.gov/data/developers/guidance.html
  • 变量搜索：https://api.census.gov/data.html

相关 MCP