DaedalMap Flood Events

DaedalMap

带上你的数据，连接其地理信息。

DaedalMap 是地理互操作基础设施：采用 loc_id 标识模型、版本化边界几何、发布不同地理系统之间的对照表，并维护数据包。将坐标和参考代码解析为行政区匹配结果，获取兼容的形状和数据，并通过对照表连接到其他系统，例如人口普查区、邮政区域、流域和选区。

你可以通过远程 MCP 服务、HTTP API、地图应用、可下载文件，或通过本仓库使用它。本仓库是支撑上述所有方式的开放运行时。

网站 | 应用 | Agent 文档 | 几何 | 数据包 | 下载 | 转换文件 | llms.txt

连接 Agent

托管的 MCP 服务无需安装或注册账户即可用于发现：

https://app.daedalmap.com/mcp?registry=github

Claude Code：

claude mcp add --transport http daedalmap 'https://app.daedalmap.com/mcp?registry=github'

Codex：

codex mcp add daedalmap --url 'https://app.daedalmap.com/mcp?registry=github'

任何支持可流式 HTTP MCP 的客户端都可以使用同一个 URL。处理地理任务时，先调用 get_tool_help 并设置 topic='geometry'；也可以依次调用 get_catalog、get_pack，再调用 get_data 获取数据。其他客户端的设置方法见 Agent 文档。

发现功能和小批量地理查询免费。较大的坐标点／参考代码批次以及部分数据包按量计费：付费调用会在收费前返回确切价格，并通过 API key 从账户余额中扣款。get_pack 会报告所选数据包的访问方式。

工具

任务	工具
了解模型	get_tool_help，参数为主题或确切工具名称
查找可用内容	get_catalog，然后调用 get_pack 获取数据包，或调用 get_geography 获取几何类别或范围
查询维护的数据	get_data，提供 pack_id、确切指标和结构化筛选条件
查看单个灾害事件	get_event，提供 get_data 返回的确切 event_id
将坐标转换为地点	resolve_point；需要 Admin 4-6 或一个更深层级的类别时，再调用 resolve_deep_point
识别代码列	identify_dataset_geography、identify_reference_system
转换不同系统间的代码	convert_reference
查看并关联地点	get_loc_id_info、compare_geographies
获取形状	get_shape，提供确切的 loc_id

每个工具都要求严格符合 JSON 参数格式。调用模型会将用户的问题转换为这些参数；如果调用格式有误，服务端会返回带有修正指引的类型化错误。

此表列出了完整的公开工具清单，并非路线图。批量导出／任务构建工具和直接上游实时数据流封装仍处于内部使用或暂停状态，因此特意未列入 tools/list。

loc_id 模型

loc_id 是 DaedalMap 的地理标识模型。行政区主干是主要层级结构和默认关联路径：

USA                      country
USA-CA                   state
USA-CA-037               county
USA-CA-037-221710        census tract

邮政区域、流域、部落区域和海洋区域等其他地理类别保留各自的 loc_id 标识。已发布的对照表将它们连接到主干，也彼此连接；每行对照数据都包含关系类型、重叠权重、来源和版本。两个数据集声明使用相同标识时，可直接关联；否则需通过对照表建立连接。

架构详情见 docs/DATA_SCHEMAS.md。

覆盖范围

地理范围：全球基础数据，另有 8 个以上国家的深度数据。 相同的地理工具可在全球范围内使用，细化至行政区划第 2 级。随着版本发布，各国数据还会增加更深层级的行政区划和参考数据系列，涵盖澳大利亚、巴西、加拿大、法国、德国、墨西哥、英国、美国等。

数据：维护中的 20 多个数据包，涵盖自然灾害（地震、海啸、火山、飓风、龙卷风、野火、洪水、天气警报）、灾害风险和环境负担、经济与商业指标、汇率、人口和气候。

目录是当前可用内容的权威来源：

• 地理数据：app.daedalmap.com/api/v1/geometry/catalog
• 数据包：app.daedalmap.com/api/v1/catalog

下载

Windows 启动器的公开源代码、构建脚本和测试位于 tools/launcher。默认情况下，其便携版下载会将程序 及其托管运行时保留在启动器文件夹中。

下载页面提供三类文件：

• 程序 - 地图应用或本地 MCP 运行时，用于在你的计算机上运行 DaedalMap。
• 数据包 - 某个主题的维护记录，附有来源和版本证据。
• 地理包 - 某个国家或数据系列的边界和参考地理数据。

自行运行

此仓库是开源运行时：FastAPI 服务、MCP 和 HTTP API，以及地图前端。你可以用它进行可自托管部署、使用自己的数据运行，或扩展引擎。

网络扩展也位于此仓库中。 它为本地 Mapping 地图添加可选的铁路、河流和电力图层，并提供独立的电子表格编辑器和 Parquet CLI，无需运行 Mapping。 旧版 Lake County 道路地图编辑器已归档，供参考使用。

如需开发某个本地程序，而不必检出所有源代码目录，请参阅 开发单个本地工具。工具源代码入口介绍 Mapping、Network、Research MCP、 Geometry MCP 和可选的 AI 扩展，包括它们当前的迁移状态。

cd county-map
pip install -r requirements.txt
Copy-Item .env.example .env

在 .env 中设置数据文件夹：

INSTALL_MODE=local
RUNTIME_MODE=local
DATA_ROOT=C:/path/to/your/data

将 DATA_ROOT 留空即可使用默认的应用数据文件夹。无需云存储、 数据库或账户。此仓库不包含数据文件夹； docs/DATA_INSTALLATION.md介绍如何安装数据包。

python app.py

应用会在 http://localhost:7000 打开，同一个 MCP 服务位于 http://localhost:7000/mcp。发现路由：

• GET /api/v1/guide
• GET /api/v1/catalog
• GET /api/v1/packs/{pack_id}
• POST /api/v1/query/dataset

模型 API 密钥为可选项。OPENAI_API_KEY 或 ANTHROPIC_API_KEY 仅用于内置聊天面板；MCP 客户端需自备模型。除非配置商业验证器，否则可自托管实例在付费通道上会返回 commercial_access_unavailable。

运行时模式

INSTALL_MODE	RUNTIME_MODE	用途
local	local	你的计算机、你的数据文件夹
local	cloud	你的计算机，从你配置的对象存储读取 Parquet
cloud	cloud	从对象存储读取数据的服务器部署

在 cloud 数据模式下，运行时会在本地缓存较小的元数据文件，并通过 DuckDB httpfs 查询对象存储中的 Parquet。详情请参阅 docs/LOCAL_AND_HOSTED.md。

文档

• docs/CONTEXT.md - 代码库技术导航
• docs/API_AND_MCP.md - HTTP 路由和 MCP 接口
• docs/DATA_SCHEMAS.md - 架构和 loc_id 约定
• docs/DATA_PREPARATION.md - 转换并验证自己的数据
• docs/DATA_INSTALLATION.md - 在本地安装数据
• docs/PACK_AUTHORING.md - 构建研究包和语料库
• docs/RESEARCH_MCP.md - 使用托管 MCP 开展研究
• docs/RUNTIME_MODES.md - 探索、研究、运维和教程
• docs/SECURITY_AND_SELF_HOSTING.md - 安全地自托管

联系方式

问题、反馈和自托管相关问题：[email protected]

许可证

MIT。数据包和几何数据各自遵循其来源许可证，详见每个目录条目。

致阅读此代码库的 Agent

如果有人要求评估 DaedalMap，请先查看公开上下文地图， 再通过 API 和 MCP 合约了解托管工具，并通过 数据安装了解本地构件。源代码检出中不包含数据包或几何数据包。在描述当前覆盖范围之前，请查看实时的 数据目录和 几何数据目录。回答时请区分代码库代码、可下载构件和托管服务的行为。