uap-pulse 是一个围绕美国国防部解密 UAP/UFO 档案构建的只读检索工具，包含一个 MCP 服务器和一个 3D 地图。其目标是为支持 MCP 的 AI 客户端（如 Claude、Cursor、ChatGPT）提供对官方解密记录的检索能力，并附上每条记录的官方来源链接。
用途 该工具用于检索和浏览美国联邦政府解密的 UAP/UFO 记录。根据资料，2026 年 7 月 10 日，美国战争部在 war.gov/UFO 发布了 PURSUE Release 04。uap-pulse 现已打包全部四批发布内容：334 条美国记录，加上来自 12 个国家的 16 个精选官方政府案例，共 350 条记录，时间跨度为 1944 年至 2026 年。
主要能力 作为 MCP 服务器，它允许 AI 代理按发布批次、地点、机构、年代或类型检索全部 350 条记录，并获取每条记录的官方来源链接。示例包括：查询“哪些 UAP 文件提到月球？”会调用 search_sightings({ location: "Moon" })，返回 NASA Gemini/Apollo 记录及其 war.gov 链接；查询最新发布可调用 search_sightings({ release: 4, limit: 100 })，返回 2026 年 7 月 10 日发布的全部 40 个文件，包括 1949 年洛斯阿拉莫斯会议记录、Project Sign 记录、新传感器视频和 STS-80 图像。
3D 地图提供所有可地理定位记录的 3D 地球视图，热点在目击事件集中处脉动，按机构着色，可按年代筛选（从二战 Foo Fighters 到海军时代）。点击热点可阅读文件并在 war.gov 上打开。离地记录（月球、轨道）有独立面板。
使用方式 作为 MCP 服务器使用时，可将其添加到 Claude Desktop 或任何 MCP 客户端的配置中。无需 API 密钥、认证或费用，数据随包提供。默认传输方式为 stdio，可选 Streamable HTTP（无会话 ID、JSON 响应、仅限回环地址），相关环境变量为 UAP_PULSE_HOST、UAP_PULSE_PORT、UAP_PULSE_TRANSPORT=http。
本地运行方式：可将 site/ 文件夹部署到 Vercel（静态，无需构建步骤）。重建数据集可运行 npm run data 或 python3 scripts/build_data.py。
适用场景 适用于需要检索、浏览或引用美国官方解密 UAP/UFO 档案的研究者、开发者或 AI 代理工作流。通过 MCP 集成，可在对话中直接查询记录并获取官方来源链接；通过 3D 地图，可直观查看地理分布与年代聚类。
限制与说明 数据仅来自官方来源。美国 PURSUE 记录依据 17 U.S.C. § 105 属于公有领域；国际层链接至各国官方国家档案馆，权利仍归各原始来源所有。不包含抓取的民间数据库。该项目与任何政府无关联，也未获其背书。覆盖范围：350 条记录，其中 275 条已地理定位，20 条为离地记录，时间跨度为 1944 年至 2026 年。美国记录按机构分布为：War（171）、FBI（87）、NASA（40）、CIA（21）、State（7）、DOE（5）、ODNI（1）、Intelligence Community Agency（1）、U.S. Government（1）。官方 war.gov CSV 在本地镜像以支持可复现构建；坐标是命名地点的代表性中心点，维护于 scripts/build_data.py 中。代码采用 MIT 许可证，数据为美国公有领域。
