GeoTap MCP Server

Подключите Claude, Cursor, Windsurf и другие ИИ-инструменты к более чем 80 федеральным источникам экологических и инфраструктурных данных США.

GeoTap агрегирует данные от FEMA, USGS, EPA, NOAA, USDA, USFWS, DOT, Census и других — доступ к ним осуществляется через протокол MCP (Model Context Protocol).

Веб-приложение: geotapdata.com — не требует программирования, рисуйте на карте и исследуйте данные визуально.

Начало работы

Предварительные требования

• Node.js (v18 или новее) — скачать здесь

• Адрес электронной почты для регистрации API-ключа

Шаг 1: Получите ваш API-ключ

Перейдите на geotapdata.com/developers и зарегистрируйтесь с помощью своей электронной почты, чтобы получить бесплатный API-ключ.

Ваш API-ключ будет отправлен на вашу электронную почту. Сохраните его — он понадобится вам на следующем шаге.

Шаг 2: Настройка MCP-сервера

Выберите ваш ИИ-инструмент ниже и следуйте инструкциям. 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 в ваши MCP-серверы Claude Code:

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

Затем установите ваш API-ключ в качестве переменной окружения. Добавьте это в профиль вашей оболочки (~/.zshrc, ~/.bashrc и т.д.):

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

Перезапустите терминал, затем запустите Claude Code. Инструменты GeoTap будут доступны автоматически.

1. Откройте Cursor

2. Перейдите в Settings (⌘ + , на Mac, Ctrl + , на Windows) → выполните поиск "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. Откройте панель ИИ-чата — инструменты 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: Начните задавать вопросы

После подключения попросите вашего ИИ-ассистента получить данные для любого участка в США. GeoTap собирает данные из всех 80+ федеральных источников одновременно — просто укажите местоположение, а затем спрашивайте что угодно:

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

После получения данных (~60-120 секунд) вы можете задавать уточняющие вопросы, например:

• "Находится ли этот участок в зоне затопления?"

• "Какие здесь типы почв и каков коэффициент кривой (curve number)?"

• "Есть ли поблизости опасения по поводу загрязнения?"

• "Каков уровень осадков для 100-летнего периода?"

• "Какие разрешения мне понадобятся для застройки этого участка?"

• "Обобщите основные экологические риски"

Устранение неполадок

Источники данных

Каждый ответ включает ссылку на источник — федеральное агентство, название набора данных и справочный URL.

Конфигурация

Варианты использования

Гражданское и экологическое проектирование

• Проектирование ливневой канализации: осадки (Atlas 14, кривые IDF, гиетограммы), коэффициенты кривой, время концентрации, пиковый расход

• Анализ наводнений: частота наводнений по бюллетеню 17C, кривые продолжительности стока, региональные регрессионные оценки

• Определение водоразделов и входные данные для гидрологического моделирования (HEC-HMS, SWMM)

• Анализ низкого стока для разрешений NPDES (7Q10, 7Q2, гармоническое среднее значение стока)

• Проектирование инфраструктуры с учетом климатических изменений

Недвижимость и девелопмент

• Экологическая комплексная проверка (due diligence) при сделках с недвижимостью

• Оценка осуществимости и пригодности участка для застройки (шкала 0-100)

• Проверка зон затопления, водно-болотных угодий и загрязнения

• Анализ процесса получения разрешений (Раздел 404, NPDES, застройка пойм)

Экологический консалтинг

• Сбор данных для экологической оценки Фазы I (объекты EPA, качество воды)

• Поддержка при определении границ водно-болотных угодий (NWI + почвы + гидрология)

• Проверка мест обитания исчезающих видов (критические места обитания USFWS)

• Оценка нарушений качества воды (список EPA ATTAINS 303(d))

Вклад в проект

Приветствуем любой вклад! Пожалуйста, откройте issue или pull request.

Лицензия

MIT

Ссылки

• Веб-приложение: geotapdata.com

• Проблемы: GitHub Issues

• npm: geotap-mcp-server