GeoTap MCP 服务器

将 Claude、Cursor、Windsurf 和其他 AI 工具连接到 80 多个美国联邦环境和基础设施数据源。

GeoTap 聚合了来自 FEMA、USGS、EPA、NOAA、USDA、USFWS、DOT、人口普查局等机构的数据，并通过 MCP（模型上下文协议）进行访问。

Web 应用：geotapdata.com — 无需代码，在地图上绘制即可直观地探索数据。

入门指南

前置要求

• Node.js (v18 或更高版本) — 在此下载

• 一个用于注册 API 密钥的电子邮箱地址

第 1 步：获取您的 API 密钥

前往 geotapdata.com/developers 并使用您的邮箱注册以获取免费的 API 密钥。

您的 API 密钥将发送到您的邮箱。请保存好它 — 您将在下一步中使用它。

第 2 步：设置 MCP 服务器

在下方选择您的 AI 工具并按照说明操作。MCP 服务器通过 npx 自动安装 — 无需手动下载。

1. 打开 Claude Desktop

2. 前往 Settings（齿轮图标） → Developer → Edit Config

3. 这将打开您的 claude_desktop_config.json 文件。添加以下内容（将 your-api-key-here 替换为您实际的密钥）：

{
  "mcpServers": {
    "geotap": {
      "command": "npx",
      "args": ["-y", "geotap-mcp-server"],
      "env": {
        "GEOTAP_API_KEY": "your-api-key-here"
      }
    }
  }
}

配置文件位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

4. 完全重启 Claude Desktop（退出并重新打开）

5. 您应该会在聊天输入框中看到一个锤子图标 (🔨) — 这意味着 GeoTap 已连接

运行此命令将 GeoTap 添加到您的 Claude Code MCP 服务器中：

claude mcp add geotap -- npx -y geotap-mcp-server

然后将您的 API 密钥设置为环境变量。将其添加到您的 shell 配置文件（~/.zshrc、~/.bashrc 等）中：

export GEOTAP_API_KEY="your-api-key-here"

重启您的终端，然后启动 Claude Code。GeoTap 工具将自动可用。

1. 打开 Cursor

2. 前往 Settings（Mac 上为 ⌘ + ,，Windows 上为 Ctrl + ,） → 搜索 "MCP"

3. 点击 "Edit in settings.json" 或添加到您的 .cursor/mcp.json 文件中：

{
  "mcpServers": {
    "geotap": {
      "command": "npx",
      "args": ["-y", "geotap-mcp-server"],
      "env": {
        "GEOTAP_API_KEY": "your-api-key-here"
      }
    }
  }
}

4. 重启 Cursor

5. 打开 AI 聊天面板 — GeoTap 工具将出现在可用工具列表中

1. 打开 Windsurf

2. 前往 Settings → MCP Servers（或直接编辑 ~/.codeium/windsurf/mcp_config.json）

3. 添加：

{
  "mcpServers": {
    "geotap": {
      "command": "npx",
      "args": ["-y", "geotap-mcp-server"],
      "env": {
        "GEOTAP_API_KEY": "your-api-key-here"
      }
    }
  }
}

4. 重启 Windsurf

对于任何 MCP 客户端，服务器都可以直接运行：

# Install globally
npm install -g geotap-mcp-server

# Run with your API key
GEOTAP_API_KEY=your-api-key-here geotap-mcp

服务器通过 stdio 进行通信 — 将您的 MCP 客户端指向 geotap-mcp 命令，并设置 GEOTAP_API_KEY 环境变量。

第 3 步：开始提问

连接后，让您的 AI 助手提取任何美国地点的相关数据。GeoTap 会同时从所有 80 多个联邦来源收集数据 — 只需提供一个地点，然后询问您想知道的任何内容：

"Collect site data for 123 Main St, Austin TX"

数据返回后（约 60-120 秒），您可以询问后续问题，例如：

• “这个地点在洪水区吗？”

• “这里的土壤类型是什么，曲线数（curve number）是多少？”

• “附近有任何污染隐患吗？”

• “百年一遇的降雨量是多少？”

• “开发这个地点需要什么许可证？”

• “总结一下主要的环境风险”

故障排除

数据来源

每条响应都包含来源归属 — 联邦机构、数据集名称和参考 URL。

配置

用例

土木与环境工程

• 雨水设计：降雨量（Atlas 14、IDF 曲线、雨型）、曲线数、汇流时间、峰值流量

• 洪水分析：Bulletin 17C 洪水频率、流量历时曲线、区域回归估计

• 流域划分和水文建模输入 (HEC-HMS, SWMM)

• NPDES 许可证的低流量分析 (7Q10, 7Q2, 调和平均流量)

• 针对基础设施韧性的气候调整设计暴雨

房地产与开发

• 房地产交易的环境尽职调查

• 地点可行性和可开发性评分（0-100 分）

• 洪水区、湿地和污染筛查

• 许可证路径分析 (Section 404, NPDES, 洪泛区开发)

环境咨询

• 第一阶段环境现场评估 (ESA) 桌面数据收集（EPA 场地、水质）

• 湿地划定支持 (NWI + 土壤 + 水文)

• 濒危物种栖息地筛查 (USFWS 关键栖息地)

• 水质损害评估 (EPA ATTAINS 303(d) 清单)

贡献

欢迎贡献！请提交 issue 或 pull request。

许可证

MIT

链接

• Web 应用: geotapdata.com

• 问题反馈: GitHub Issues

• npm: geotap-mcp-server