mcpField
O
Openfema

Openfema

远程服务
pipeworx.io法律与政务02 周前更新

关于 Openfema

Openfema 是用于查询 FEMA 开放数据的 MCP 服务,适合分析美国灾害声明的 Agent 和用户。它支持按条件筛选和统计声明,也可对列出的 OpenFEMA 数据集执行通用 OData 查询。

主要功能

  1. 01筛选并统计灾害声明
  2. 02使用 OData 参数查询数据集
  3. 03列出可用数据集及版本

适用场景

  1. 01按州或事件类型统计声明
  2. 02查看指定日期范围内的灾害
  3. 03查询前发现可用数据集

MCP 相关

通过 Pipeworx 网关端点或本地 stdio 服务向 MCP 客户端提供 FEMA 声明和数据集查询工具。网关连接还包含 Pipeworx 共享元工具。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://gateway.pipeworx.io/openfema/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

mcp-openfema

OpenFEMA MCP — 美国联邦紧急事务管理局开放数据。

属于 Pipeworx — 一个将 AI Agent 连接到 1815+ 个实时数据源的 MCP 网关。这是一个独立、非官方的集成 — 与上游提供方无关联、未获其认可,也非由其发布。

工具

工具描述
disaster_declarations查询并统计美国联邦灾害声明(FEMA DisasterDeclarationsSummaries)。筛选条件:state(2 个字母)、incidentType(例如 'Fire'、'Flood'、'Hurricane'、'Severe Storm')、declarationType('DR' 重大灾害、'EM' 紧急情况、'FM' 火灾管理)、year(fyDeclared,即联邦财政年度),以及用于实际日历日期范围的 since/until — 对于“过去一年”这类问题,请使用 since/until,因为财政年度无法回答此类问题。默认统计的是不同灾害的数量,而不是表格行数:FEMA 按每个灾害涉及的县发布一行,因此哈维飓风在德克萨斯州约有 60 行记录,但只有一项声明。传入 designatedArea 或 grain:'area' 可获取县级行。结果按时间由近到远排列。响应会回显 filters_applied 和 note:declarationType/incidentType/state/designatedArea 各自都会将总数缩小到一个子集(例如,declarationType:'DR' 会排除 'EM' 和 'FM')— 若要获取所有类型/所有州的总数,请在不带该筛选条件的情况下再次调用,而不要将某次带筛选条件的调用结果当作总数;若要获取真实的分类统计,请针对每个值各调用一次,并自行汇总总数。
query_dataset针对任意 OpenFEMA 数据集执行通用 OData 查询。指定实体名称(可选指定版本;默认使用已验证的当前版本),以及 OData 参数:filter、select、orderby、top、skip。使用 list_datasets 查看可用的实体/版本和筛选语法。返回 { metadata, records }。
list_datasets列出此工具包所了解的 OpenFEMA 数据集,包括实体名称、当前版本和描述。还会说明 OData 筛选语法和响应格式。请先调用此工具,以了解 query_dataset 可以查询哪些数据。

快速开始

添加到你的 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):

{
  "mcpServers": {
    "openfema": {
      "url": "https://gateway.pipeworx.io/openfema/mcp"
    }
  }
}
此端点实际提供的内容

https://gateway.pipeworx.io/openfema/mcp 上的 tools/list 会返回上表中的工具,以及 Pipeworx 的共享元工具 — ask_pipeworx、 discover_tools、search_within、remember/recall 以及网关范围内的其他工具。因此,你看到的工具数量会多于此表:目前,单个工具包端点除了该工具包自身的工具外,还会列出约 30 个共享工具。initialize 响应会说明其确切范围,并且是特定日期的权威答案。

这是有意为之,并非意外的多路复用。这些元工具可让限定范围的连接回答此工具包未涵盖的问题 — 通过 ask_pipeworx 跨整个目录路由 — 而无需添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点;如果额外的架构占用的上下文比路由带来的价值还多,请连接一次完整网关,而不是连接多个工具包端点。

也可以连接完整的 Pipeworx 网关,直接列出每个工具包的工具,而不仅仅是此工具包的工具:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都会连接到同一个网关和相同的 1815+ 个数据源。唯一的区别在于哪些工具包的工具会被直接列出;无论连接哪个端点,ask_pipeworx 都可以访问所有工具。

没有 MCP 客户端?通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/disaster_declarations \
  -H 'Content-Type: application/json' \
  -d '{"state":"CA","year":2024}'

首次调用无需账户。检查任意工具:GET https://gateway.pipeworx.io/v1/tools/disaster_declarations。查找工具包:向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求,并附上 {"query":"..."}。

独立运行(无需网关账户)

此软件包也可作为本地 stdio MCP 服务运行,无需 Pipeworx 账户,也无需经过网关往返:

{
  "mcpServers": {
    "openfema": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-openfema"]
    }
  }
}

也可以直接运行,确认它能正常启动:

npx -y @pipeworx/mcp-openfema

它通过 stdin/stdout 使用 MCP 通信,并针对仅限此软件包的工具响应 initialize/tools/list/tools/call——不包含上方网关连接所添加的任何共享元工具。相同的源代码,相同的工具,无需 ask_pipeworx 路由。

使用 ask_pipeworx

你也可以用通俗的英语提问,而不是直接调用工具——这既适用于上方的软件包端点,也适用于完整网关:

ask_pipeworx({ question: "your question about Openfema data" })

网关会选择合适的工具并自动填写参数。

更多信息

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。