# @cyanheads/census-mcp-server 中文文档

规范地址：https://npmcn.com/package/%40cyanheads/census-mcp-server/

版本：0\.7\.2
npm 元数据更新时间：2026-11-04T00:31:43.487Z
中文译文更新时间：2026-11-11T10:06:48.532Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cyanheads/census-mcp-server
原文对照：https://npmcn.com/package/%40cyanheads/census-mcp-server/?lang=original
项目主页：https://github.com/cyanheads/census-mcp-server#readme
源码仓库：https://github.com/cyanheads/census-mcp-server

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1 MB，132 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.0\.0
- 运行依赖：3 个
- 首次发布：2026-05-25T01:45:11.031Z
- 最新版本发布：2026-11-04T00:31:43.343Z
- 近 30 天下载量：2233（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：27（近 12 个月 27 个）

## 中文简介

通过MCP查询美国人口普查局的数据,变量和地理学. (原始内容存档于2012-10-12). STIO or Streamable HTTP.

## 安装

```sh
npm install @cyanheads/census-mcp-server
```

也可以使用：`pnpm add @cyanheads/census-mcp-server`、`yarn add @cyanheads/census-mcp-server`、`bun add @cyanheads/census-mcp-server`

## README

# @cyanheads/census-mcp-服务器

**通过MCP查询美国人口普查局的数据,变量和地理学. (原始内容存档于2012-10-12). STIO or Streamable HTTP.**

8 个工具

[![Version](https://img.shields.io/badge/Version-0.7.2-blue.svg?style=flat-square)](https://npmcn.com/package/%40cyanheads/census-mcp-server/CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](https://npmcn.com/package/%40cyanheads/census-mcp-server/LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/census-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-%5E2.4.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/census-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/census-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-%5E7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.4.4-blueviolet.svg?style=flat-square)](https://bun.sh/)

[![Install in Claude Desktop](https://img.shields.io/badge/Install_in-Claude_Desktop-D97757?style=for-the-badge&logo=anthropic&logoColor=white)](https://github.com/cyanheads/census-mcp-server/releases/latest/download/census-mcp-server.mcpb) [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=census-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjeWFuaGVhZHMvY2Vuc3VzLW1jcC1zZXJ2ZXIiXX0=) [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22census-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40cyanheads%2Fcensus-mcp-server%22%5D%7D)

[![Framework](https://img.shields.io/badge/Built%20on-@cyanheads/mcp--ts--core-67E8F9?style=flat-square)](https://www.npmjs.com/package/@cyanheads/mcp-ts-core)

**公共主机服务器 :** [https://census.caseyjhand.com/mcp (中文(中国大陆) )](https://census.caseyjhand.com/mcp)

* * *

## 概览

美国人口调查局人口,经济和住房数据. 查找数据集和变量,为 FIPS 代码解析地名或地址,以及查询或排列任何一组地理学的估计数.

### 工具

| 工具 | 说明 |
| :-- | :-- |
| `census_list_datasets` | 浏览现有的人口普查局数据集(ACS5和ACS1及其简介,主题和比较表,ACS补充估计和部分人口概况,人口估计,十年,县商业模式,经济普查,Nonemploder Statistics)并使用年限和数据集代码. |
| `census_list_geographies` | 列出由数据集和年份支持的地理学水平,包含父要求和实例FIPS值. |
| `census_search_variables` | 关键词在可变标签和概念组之间搜索,或按可变或表格代码查找. 在ACS上,返回估计和误差比值代码加在一起. |
| `census_get_variable` | 获取一个或多个可变代码的完整元数据——标签,概念,上游类型,宇宙,MOE兄弟——包括数据工具接受的注释和旗帜列. |
| `census_list_predicate_values` | 列出一个过滤维度接受的代码(`EMPSZES`, (中文(简体) ), `LFO`, (中文(简体) ), `POPGROUP`, (中文(简体) ), `NAICS2017`),来自数据集词典或活通配符计数. |
| `census_resolve_geography` | 通过TIGERweb和Census Geocoder将地名(如"King County, WA"),ZIP代码,或街道地址转换为人口普查FIPS标识符. |
| `census_query_data` | 在一个地理上查询一个变量的人口普查数据集,一个以逗号分隔的变量列表,或每个地理级别。 以教育部、人口普查哨值和扣取的业务值返回估计数,解决其已公布的含义,并为业务数据集进行上游过滤. |
| `census_compare_geographies` | 排名和比较多个地理学的变量——一个州的所有县,全国所有的州,或一个取名的集. 排序表输出,具有相同的上游过滤. |

* * *

## 能力参考

### `census_list_datasets` 工具

-   返回数据集代码、名称、描述和可用的年份,并带有可选的关键字过滤器。 包括ACS5和ACS1(数据简介、主题表、比较简介和 `acs/acs1/spp`, (中文(简体) ), `acs/acsse`,"人口估计",2020"十年"档案 (再区划(P.L.94-171), `dec/dhc`, (中文(简体) ), `dec/dp`, (中文(简体) ), `dec/sdhc`, (中文(简体) ), `dec/ddhca`, (中文(简体) ), `dec/ddhcb`, (中文(简体) ), `cbp`, (中文(简体) ), `ecnbasic`,以及 `nonemp`
-   每种描述名称 过滤器 上游数据集 及其公布的地理级别
-   数据集代码(例如, `acs/acs5`)是其他工具需要的东西. 案件被忽略,由两部分组成的代码仅以最后一部分有效(`acs5`, (中文(简体) ), `pl`); 三部分编码,例如 `acs/acs5/profile` 必须全部提供
-   `available_years` 详尽无遗: 其他任何年份的失败 `year_not_available`,命名工作年份

* * *

### `census_list_geographies` 工具

-   每个地理级别和父等级返回一行: `geography_level`,无论是否需要父母, `required_parent_levels`,并举例FIPS值. `totalLevels` 计算每个关卡一次
-   `geography_level` 值是输入到 `census_query_data` 财务报告和审定财务报表 `census_compare_geographies`· ; `year` 默认为最近版本
-   失败者 `dataset_not_found` 或者说 `year_not_available` (命名服务年数)

* * *

### `census_search_variables` 工具

-   横跨标签和概念的全字搜索:每个查询单词必须匹配,否则最接近的匹配会带通知回来. 无论如何,一个变量或表格代码首先返回该变量,或整个表格按代码顺序返回(`B19013` 返回时 `B19013_001E` 接下来 `B19013_001M`(中文(简体) )
-   数据集不公布的代码会收到一个通知,命名持有它的兄弟姐妹数据集(S`S1701` 内 `acs/acs5` 指点 `acs/acs5/subject`)或(或) `census_get_variable` 用于属性列,例如 `B19013_001EA`
-   在ACS数据集上,估计(E后缀)和误差(M后缀)代码重合;比较剖面和其他家族发布无差错. 还按关键词找到上游代码(`naics`)或代码(`NAICS2017` 内 `cbp`(中文(简体) )
-   `limit` 是一个从 1 到 100 的整数( 默认 20 ), 在超出范围时被拒绝而不是被夹住. `offset` 页面完整匹配命令 ; `totalMatches` 在呼叫前计数匹配, `truncated` 表示另一个页面存在,并且 `nextOffset` 说吧 变量.json每个数据集+年份被缓存(默认 TTL 24h)

* * *

### `census_get_variable` 工具

-   按给定的顺序取出一个或多个可变代码(大小写不敏感)并返回标签,概念,上游类型,以及表格的宇宙. 若为 `groups.json` 无法取出,变量没有宇宙就会回来 通知说要重试
-   决定注释和旗帜等列 `B19013_001EA` 财务报告和审定财务报表 `EMP_F`,与 `attribute_of` 命名每个属于和所属的列 `attribute_type` 类型`ANNOTATION`, (中文(简体) ), `FLAG`, (中文(简体) ), `MARGIN_OF_ERROR`) (中文(简体) ). 在ACS数据集上,它也会返回 `estimate_code`编号 :`moe_code` 兄弟姐妹参考文献
-   确认上游维码(`NAICS2017`, (中文(简体) ), `SEX`在数据集中存在; `census_list_predicate_values` 列出它们的值. `dataset` 默认为 `acs/acs5` 财务报告和审定财务报表 `year` 切换到最近版本
-   `variable_not_found` 当代码没有定义时, 命名在找到时公布代码的兄弟姐妹数据集 (`DP03_0062E` 内 `acs/acs5` 指点 `acs/acs5/profile`(中文(简体) )

* * *

### `census_list_predicate_values` 工具

-   列出一个过滤维度接受的代码,在发布列表时从数据集词典中读取,并以其他方式列出. `NAICS*` 财务报告和审定财务报表 `POPGROUP` 清单很长(千个代码 `query`(三); `EMPSZES`, (中文(简体) ), `LFO`, (中文(简体) ), `RCPSZES`, (中文(简体) ), `TAXSTAT`,以及 `TYPOP` 仅限直播
-   对照数据集实际公布的行来检查词典清单并删除未公布的代码; `source` 说明检查结果和通知是否给出了被扣的号码。 字典列表无法在提供的地理级别验证出版物
-   活计数 `geography_level` (默认) `us`并呼应这一范围。 代码因级别而异;仅接受其数据集元数据允许未显示通配符的级别
-   `query` 匹配代码和标签;结果在代码之前排序 `offset`编号 :`limit` 拨号( n)`limit` 1至500,默认为50). `totalCount` 计数所有匹配; `truncated` 表示另一个页面存在,与 `nextOffset` 只有那时 打开 `ecnbasic`, (中文(简体) ), `within_naics` 范围 `TAXSTAT` 财务报告和审定财务报表 `TYPOP` 对一个行业
-   直播路线和字典检查读取了数据端点,所以需要 `CENSUS_API_KEY`: 没有工作键, 仅靠活的维度会失败 `missing_api_key`,而字典列表仍然回答,但不加限制,并附有指定密钥的通知

* * *

### `census_resolve_geography` 工具

-   命名地点(如"金县,WA")通过TIGERweb解决;街道地址通过Census Geocoder解决到道位 `block_group_fips` 财务报告和审定财务报表 `place_fips`5位数的 ZIP (或 ZIP+4) 解决其 ZIP 代码制表区(`zip code tabulation area`(中文(简体) )
-   自动检测 `geography_type` 为州,县,地点,道,和ZIP. 都市/微城市统计区、综合统计区、合并城市和经济地点需要明确 `geography_type`· ; `economic place` 返回八位数 `ecnbasic` 代码( 西雅图) `03363000`(中文(简体) )
-   地点级别包括人口普查指定地点,只有在没有并入地点或县级完全匹配时才回答姓名;使用全名("Arlington CDP, VA")或 `geography_type: "place"` 达到一个。 可选 `county_fips` 范围 县和道分辨率`county_scope_unsupported` 用于任何其他级别或地址)
-   匹配忽略了大小写,接受州名缩写或全名,并容忍圣/圣和口音差异. 纽约市辖区决定所属县("纽约布鲁克林") – 金斯县 `047`带有 `notice`
-   匹配多个地理学返回的名称 `ambiguous_name` 每个候选人的FIPS密码和状态 成果 `state_fips` (-) `parent_fips`和 `fips_summary` (-) `geography_fips`)用于下一个工具;统计区和ZCTA省略 `state_fips`

* * *

### `census_query_data` 工具

-   需要 FIPS 代码( 使用) `census_resolve_geography` 地名). `geography_fips: "*"` 返回父关中的每个地理; 每行带 `geography_fips` 国家的独特性 `geography_geoid`复发 `limit` gEOID 顺序中的行( 默认为 50, 最大为 500), 有 `offset` 用于呼叫和 `totalCount` 用于所有匹配. `truncated` 只有在另一页存在时才属实; `nextOffset` 该页的名称
-   以逗号分隔的列表( N)`"06,53"`,或 `"033,061"` 与 `parent_fips: "53"`)返回按GEOID顺序排列的每列同级编码,并按同一方式进行页面;代码取该等宽度, 不 `"*"` 成员 父母需要一个代码 通知名称 每一个列出的代码 无一行回来
-   每个呼叫最多49个可变代码,增加标签或记录列的数据集较少(`too_many_variables` 说明最大值)。 未知代码失败 `variable_not_found`; 级别和父问题失败 `parent_required` 或者说 `parent_not_accepted`可选 `tract_fips` (6位数字,带混凝土) `county_fips`将块组或十年一次的块查询瞄准一个道
-   可选 `predicates` 映射过滤业务, `pep`,以及 `dec` 数据集和 `acs/acs1/spp` (例如, `{"NAICS2017": "5112"}`) (中文(简体) ). 未设定维度默认为人口普查默认值,每行对应 `applied_filters`· ; `"*"` 返回每个类别一行,标签在 `record`。 。 。 . `pep/charv` 返回每个地理的数行,所以为 1 (例如, `{"MONTH": "7"}`(中文(简体) )
-   ACS sentinel 值解决其已发布的含义,并标出一个无限制间隔的中位数 `open_ended`打开 `cbp`, (中文(简体) ), `ecnbasic`,以及 `nonemp`,被扣值报告为与国旗含义相符合的压制值。 无效 `estimate` 表示被压制的文本单元格(返回到 `value`),或为空
-   打开 `dec/ddhca` 财务报告和审定财务报表 `dec/ddhcb`,一个地理的 `POPGROUP` 团体只坐在一个家庭的一桌;a `no_data` 提示或通知列表名称。 要求数 `CENSUS_API_KEY`
-   缺少地理指导名称 适用的ACS 出版阈值 可能的原因与代码检查, 和配对的更广泛的覆盖数据集 与可变再发现

* * *

### `census_compare_geographies` 工具

-   在一个级别或一个名称上排列所有地理 `geographies` (一) GEOID/平面编码清单; `within`编号 :`within_county` 国家/县的范围,省略以作全国比较
-   在一个变量上的排名: `sort_by` (默认第一个代码;必须是请求的代码,否则 `sort_by_not_requested`, (中文(简体) ), `sort_dir` (默认) `desc`),以及 `limit` (1至500,默认为50). 平等数值 共享竞争排名`1, 2, 2, 4`)和由GEOID订购;通知在平局内识别出一页边界. 按大小、而不是比率排列的计数等级,按一个比率排列公布的百分比(`S1701_C03_001E` 内 `acs/acs5/subject`, (中文(简体) ), `DP04_0047PE` 内 `acs/acs5/profile`(中文(简体) )
-   `offset` 在排序的匹配集中计数行;在呼出前会分配分行. `totalCount` 计数设置, `truncated` 表示另一个页面存在,并且 `nextOffset` 仅出现在当时。 无空 `geographies` 过滤器也返回 `scope_rank` 与所有获取的地理学和 `scopeCount` 该分母
-   取同样的 `predicates`,变量限制、验证和 `applied_filters` 作为 `census_query_data`; 多记录数据集 (`pep/charv`或一个 `"*"` 上游失败 `ambiguous_rows` 除非 `predicates` 针一. 被被压制的值以同样的原因排序为最后,文本值不能排序(通知中说). 要求数 `CENSUS_API_KEY`

* * *

## 特征

建造在 [`@cyanheads/mcp-ts-core`](https://github.com/cyanheads/mcp-ts-core): stdio和可流式的 HTTP 传输器,可插接式(`none` 编号 : `jwt` 编号 : `oauth`),可互换存储(`in-memory`, (中文(简体) ), `filesystem`, (中文(简体) ), `Supabase`, (中文(简体) ), `Cloudflare KV/R2/D1`),结构化记录,可选择的OpenTeleometry tracking.

特定普查:

-   含有可配置 TTL 的流程中可变缓存 — variable.json 在每个数据集+年份获取一次,搜索客户端
-   3-API后端:用于数据查询的人口普查数据API,用于命名地点解析的TIGERweb,用于地址到字节的人口普查地理编码器
-   在所有外部 API 呼叫中自动重试并备份
-   关键工具呼叫共享50秒上游预算,涵盖元数据、数据、复读和可选调查;数据请求在剩余预算内保留40秒上限
-   FIPS 格式化帮助器 — 零加法状态、 县和道码, 可以在工具之间传递

方便代理输出 :

-   面向工作流程的工具表面—— `fips_summary` 财务报告和审定财务报表 `state_fips` 返回值已准备通过 `geography_fips` 财务报告和审定财务报表 `parent_fips` 到下一个工具
-   已解码的禁止编码——人口普查的负哨值(例如:, `-666666666`)和商务数据集预留旗(例如, `D`)表面显示为已公布的含义,而不是原始数字或假零
-   关于错误的恢复提示——模糊的地理名称包括候选名单;缺失的API关键错误包括注册 URL

* * *

## 开始

连接到主机实例, 没有安装 :

```sh
claude mcp add --transport http census-mcp-server https://census.caseyjhand.com/mcp
```

或者在当地运行它:

```sh
claude mcp add census-mcp-server -e CENSUS_API_KEY=your-key -- npx -y @cyanheads/census-mcp-server
```

对于其他客户端,请将此添加到 MCP 配置文件中 :

```json
{
  "mcpServers": {
    "census-mcp-server": {
      "command": "npx",
      "args": ["-y", "@cyanheads/census-mcp-server"],
      "env": { "CENSUS_API_KEY": "your-key" }
    }
  }
}
```

注册自由密钥到 [api.census.gov/data/key signup.html 页面存档备份,存于互联网档案馆](https://api.census.gov/data/key_signup.html)数据查询`census_query_data`, (中文(简体) ), `census_compare_geographies`) 要求,正如 `census_list_predicate_values` 它所列举的维度是活的;可变搜索和地理解析工作是没有活的。 对于 Docker 或源构建,请参见 [运行服务器](https://npmcn.com/package/%40cyanheads/census-mcp-server/#readme-running-the-server)。 。 。 .

* * *

## 配置

| 变量 | 说明 | 默认 |
| :-- | :-- | :-- |
| `CENSUS_API_KEY` | **数据查询要求** (单位:千美元)`census_query_data`, (中文(简体) ), `census_compare_geographies`和用于 `census_list_predicate_values` 没有它,那些失败的 `missing_api_key`,则一个词典列表不附带任何限制。 api.census.gov/data/key signup.html免费注册. | —— 说 |
| `CENSUS_DEFAULT_YEAR` | 未指定年份时的默认年份 . | `2024` |
| `CENSUS_VARIABLE_CACHE_TTL_HOURS` | 小时到缓存变量. json 每个数据集+年的内存. | `24` |
| `MCP_TRANSPORT_TYPE` | 运输: `stdio` 或者说 `http`。 。 。 . | `stdio` |
| `MCP_SESSION_MODE` | HTTP 会话模式 : `stateful`, (中文(简体) ), `stateless`,或 `auto`。 。 。 . | `stateless` |
| `MCP_HTTP_PORT` | HTTP 服务器端口 . | `3010` |
| `MCP_AUTH_MODE` | Auth 模式 : `none`, (中文(简体) ), `jwt`,或 `oauth`。 。 。 . | `none` |
| `MCP_LOG_LEVEL` | 日志级别 (`debug`, (中文(简体) ), `info`, (中文(简体) ), `notice`, (中文(简体) ), `warning`, (中文(简体) ), `error`) (中文(简体) ). | `info` |
| `LOG_TOOL_FAILURE_PAYLOADS` | 记录每个工具调用失败的参数和结果,按密钥名称编辑并封顶 `LOG_TOOL_FAILURE_PAYLOAD_MAX_BYTES` (默认) `16384`) (中文(简体) ). 自由形式值内部的秘密不编辑 . | `false` |
| `OTEL_ENABLED` | 启用 OpenTeleometry 仪器 . | `false` |

见 [`.env.example`](https://npmcn.com/package/%40cyanheads/census-mcp-server/.env.example) 用于完整可选覆盖列表.

* * *

## 运行服务器

### 地方发展

要求数 [Bun v1.4.0 (英语)](https://bun.sh/) 或更高(或Node.js v24+).

-   **克隆并安装 :**
    
    ```sh
    git clone https://github.com/cyanheads/census-mcp-server.git
    cd census-mcp-server && bun install
    cp .env.example .env   # set CENSUS_API_KEY
    ```
    
-   **构建和运行 :**
    
    ```sh
    # One-time build
    bun run rebuild
    
    # Run the built server
    bun run start:stdio
    # or
    bun run start:http
    ```
    
-   **运行检查和测试 :**
    
    ```sh
    bun run devcheck   # Lint, format, typecheck, security audit
    bun run test       # Vitest test suite
    bun run lint:mcp   # Validate MCP definitions against spec
    ```
    

### 夹克

```sh
docker run --rm -e CENSUS_API_KEY=your-key -p 3010:3010 ghcr.io/cyanheads/census-mcp-server:latest
```

图像默认为 HTTP 传输、 无国籍会话模式和日志到 `/var/log/census-mcp-server`运行到一个 MCP 客户端的 stdio,使用 `"command": "docker"` 与 `"args": ["run", "-i", "--rm", "-e", "MCP_TRANSPORT_TYPE=stdio", "-e", "CENSUS_API_KEY=your-key", "ghcr.io/cyanheads/census-mcp-server:latest"]`为了在当地建设, `docker build -t census-mcp-server .`; OpenTeleometry 端点依赖性默认安装——用 `--build-arg OTEL_ENABLED=false` 以略去它们.

* * *

## 项目结构

| 路径 | 目的 |
| :-- | :-- |
| `src/index.ts` | `createApp()` 进入点——登记工具并初始化服务. |
| `src/config/server-config.ts` | 人口普查专栏 var 与 Zod 解析与验证. |
| `src/mcp-server/tools/definitions/` | 工具定义`*.tool.ts`) (中文(简体) ). |
| `src/services/census-api/` | 人口普查数据API客户端——数据查询,压制代码映射,重试逻辑. |
| `src/services/geography/` | 地理分辨率——TIGERweb命名-地点查询和人口普查地理编码地址-对接. |
| `src/services/variable-cache/` | 进程内变量. json 缓存 有 TTL 和关键字搜索 . |
| `tests/` | 模拟测试镜像 `src/` 结构. |

* * *

## 发展指南

见 [`CLAUDE.md`](https://npmcn.com/package/%40cyanheads/census-mcp-server/CLAUDE.md) 发展准则和建筑规则。 简本:

-   搬运工投掷,框架渔获量——否 `try/catch` 在工具逻辑中
-   使用 `ctx.log` 请求范围伐木, `ctx.state` 租户范围储存
-   通过枪管登记新工具 `src/mcp-server/tools/definitions/index.ts`
-   环绕外部 API 调用: 验证 生 → 规范到域类型 → 返回输出计划; 永远不要编织缺失的字段

* * *

## 捐款

问题值得欢迎。 提交前进行检查和测试:

```sh
bun run devcheck
bun run test
```

* * *

## 许可证

阿帕奇-2.0 — 见 [自由主义](https://npmcn.com/package/%40cyanheads/census-mcp-server/LICENSE) 详细情况.

## 常见问题

### @cyanheads/census-mcp-server 是什么？

通过MCP查询美国人口普查局的数据,变量和地理学\. \(原始内容存档于2012-10-12\)\. STIO or Streamable HTTP\.

### 如何安装 @cyanheads/census-mcp-server？

在项目目录运行 npm install @cyanheads/census-mcp-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 census-mcp-server，可以用 npx census-mcp-server 直接运行。

### @cyanheads/census-mcp-server 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @cyanheads/census-mcp-server 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @cyanheads/census-mcp-server 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @cyanheads/census-mcp-server 可以商用吗？

@cyanheads/census-mcp-server 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @cyanheads/census-mcp-server 的下载量有多少？

根据 npm 官方下载统计，@cyanheads/census-mcp-server 在 2026/10/11 – 2026/11/09 这 30 天内被下载 2,233 次，日均约 74 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cyanheads/census-mcp-server 还在维护吗？

最新版本 0\.7\.2 发布于 2026/11/04（7 天前）；至今共发布 27 个版本，其中过去 12 个月发布了 27 个；首次发布于 2026/05/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。