GovWait

GovWait MCP 服务

通过模型上下文协议（stdio）向 AI Agent 提供 GovWait 数据集（官方发布的政府办理时长，包含来源溯源信息和历史记录）。

工具：search_entities、get_entity、get_latest_value、compare_values。 每个响应都包含 source_url、机构提供的更新时间（如果未提供，则为 GovWait 首次观测日期）、我们的验证时间戳、来源收集状态、来源单位以及署名要求。来源不可用时，current_value 和 value_days 为 null；保留的值仅作为 last_verified_value 返回，同时将 value_context 设为 last_verified_source_snapshot。

从 npm 安装

直接运行当前公开的软件包：

npx -y govwait-mcp

对于 Claude Code，使用同一公开软件包进行注册：

claude mcp add --scope user govwait-mcp -- npx -y govwait-mcp

在本地构建并验证源代码

cd machine/mcp-server
npm ci
npm run verify

如需在 Git 忽略的 release/ 目录中保留常规的、包含数据的候选发布版本及其 SHA-256 附加文件，请运行 npm run prepare:rc。如需生成必须逐字节保留现有捆绑数据的纯文档候选版本，请改为运行 npm run prepare:docs-rc。

npm run build 会将经过验证的三个流水线导出文件复制到此软件包自己的 data/ 目录，写入确定性的 SHA-256 来源溯源元数据，并编译 dist/index.js。服务默认使用这些软件包自有文件，因此运行时不依赖父级仓库。高级本地用户仍可通过 GOVWAIT_DATA_DIR=/path/to/exports 覆盖位置；该目录必须包含这三个导出文件。如果存在匹配的 provenance.json，则会使用它；软件包自带的默认数据始终要求该文件存在。

npm run audit:package 会在临时目录中创建压缩包，强制执行精确的九文件软件包允许列表，拒绝包含机密、数据库、缓存、日志、源代码或测试产物，验证每个捆绑数据文件的哈希，将压缩包解压到一个使用已锁定 npm ci 依赖树的干净临时项目中，并针对该隔离副本运行完整的 MCP 烟雾测试。之后会删除临时软件包；无需访问注册表。

已验证的公开基线为 [email protected]，其 mcpName 与官方 MCP 注册表元数据中的 io.github.artwisdom/govwait 完全一致。该版本已发布到 npm，并在官方 MCP 注册表中获准作为活跃版本。版本 0.1.1 使用 SEE LICENSE IN LICENSE 字段，该字段指向 Apache 2.0 条款，但仅适用于 GovWait 所有的软件代码。DATA-NOTICE.md 和许可证范围明确排除了捆绑的政府来源数据。通过公开注册表进行的全新安装已通过完整的 MCP 烟雾测试套件。发布到 npm 需要交互式 2FA，并且不允许使用自动化／绕过令牌。官方 mcp-publisher 1.8.1 会验证 server.json，而 官方注册表中 0.1.1 版本的条目 记录了该版本；要确认当前公开版本，请使用 npm 的 latest 标签和注册表的 latest 端点，而不要把本地构建当作证明。

版本 0.1.2 仅更改软件包文档和发布元数据。它保留了 0.1.1 中已验证的完全相同的捆绑数据集和四种 MCP 工具行为，同时添加了上述公开安装命令并移除了过时的发布前措辞。在本地构建或验证软件包不会发布新的 npm 或注册表版本。

将本地检出版本注册到 Claude Code

claude mcp add govwait -- node /ABSOLUTE/PATH/TO/govwait/machine/mcp-server/dist/index.js

将本地检出版本注册到 Claude Desktop

添加到 claude_desktop_config.json（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "govwait": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/govwait/machine/mcp-server/dist/index.js"]
    }
  }
}

试用

向已连接的 Agent 提问：“目前从印度申请加拿大访客签证需要多长时间？与尼日利亚和菲律宾相比如何？”——它应调用 compare_values，并给出带日期和来源的数据。

对于新西兰，试试提问：“访客签证目前的处理时间是多少？” nz-visitor-visa 服务会同时返回 INZ 的 50% 和 80% 工作日指标。

对于挪威，试试提问：“UDI 最近一次核实的访客签证等待时间是多少？GovWait 现在还能访问该来源吗？” MCP 服务会返回带日期、以表格为依据的快照、官方来源页面以及 source_unavailable 状态，但不会将该快照说成当前数据。

数据来源与再利用

每条响应都会保留官方来源 URL、来源日期、核实时间、单位和 GovWait 归属声明。data/provenance.json 记录了准确的数据集生成时间、行数、字节大小和 SHA-256 哈希值。GovWait 不会对底层政府信息重新授权；请遵循 https://govwait.com/data-license/ 中针对各来源的条款，以及随包提供的 DATA-NOTICE.md。

分发

本地的 server.json 是适用于公开 npm 包的有效 MCP Registry 元数据。向 Registry 和其他目录提交仍需所有者根据分发清单分别操作。