Servidor MCP de GeoTap

Conecta Claude, Cursor, Windsurf y otras herramientas de IA a más de 80 fuentes de datos ambientales y de infraestructura federales de EE. UU.

GeoTap agrega datos de FEMA, USGS, EPA, NOAA, USDA, USFWS, DOT, el Censo y más, accesibles a través del MCP (Protocolo de Contexto de Modelo).

Aplicación web: geotapdata.com — no requiere código, dibuja en un mapa y explora datos visualmente.

Primeros pasos

Requisitos previos

• Node.js (v18 o posterior) — descárgalo aquí

• Una dirección de correo electrónico para registrarse y obtener su clave API

Paso 1: Obtenga su clave API

Visite geotapdata.com/developers y regístrese con su correo electrónico para obtener una clave API gratuita.

Su clave API se enviará a su correo electrónico. Guárdela: la necesitará en el siguiente paso.

Paso 2: Configure el servidor MCP

Elija su herramienta de IA a continuación y siga las instrucciones. El servidor MCP se instala automáticamente a través de npx; no es necesaria una descarga manual.

1. Abra Claude Desktop

2. Vaya a Settings (icono de engranaje) → Developer → Edit Config

3. Esto abrirá su archivo claude_desktop_config.json. Añada lo siguiente (reemplace your-api-key-here con su clave real):

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

Ubicación del archivo de configuración:

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

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

4. Reinicie Claude Desktop por completo (cierre y vuelva a abrir)

5. Debería ver un icono de martillo (🔨) en la entrada de chat; eso significa que GeoTap está conectado

Ejecute este comando para añadir GeoTap a sus servidores MCP de Claude Code:

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

Luego, establezca su clave API como una variable de entorno. Añada esto a su perfil de shell (~/.zshrc, ~/.bashrc, etc.):

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

Reinicie su terminal y luego inicie Claude Code. Las herramientas de GeoTap estarán disponibles automáticamente.

1. Abra Cursor

2. Vaya a Settings (⌘ + , en Mac, Ctrl + , en Windows) → busque "MCP"

3. Haga clic en "Edit in settings.json" o añada al archivo .cursor/mcp.json:

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

4. Reinicie Cursor

5. Abra el panel de chat de IA: las herramientas de GeoTap aparecerán en la lista de herramientas disponibles

1. Abra Windsurf

2. Vaya a Settings → MCP Servers (o edite ~/.codeium/windsurf/mcp_config.json directamente)

3. Añada:

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

4. Reinicie Windsurf

Para cualquier cliente MCP, el servidor se puede ejecutar directamente:

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

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

El servidor se comunica a través de stdio: apunte su cliente MCP al comando geotap-mcp con la variable de entorno GEOTAP_API_KEY establecida.

Paso 3: Empiece a hacer preguntas

Una vez conectado, pídale a su asistente de IA que obtenga datos para cualquier sitio en EE. UU. GeoTap recopila información de las más de 80 fuentes federales a la vez; solo proporcione una ubicación y luego pregunte lo que desee:

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

Una vez que los datos regresen (~60-120 segundos), puede hacer preguntas de seguimiento como:

• "¿Está este sitio en una zona inundable?"

• "¿Qué tipos de suelo hay aquí y cuál es el número de curva?"

• "¿Hay preocupaciones de contaminación cerca?"

• "¿Cuál es la precipitación de 100 años?"

• "¿Qué permisos necesitaría para desarrollar este sitio?"

• "Resuma los riesgos ambientales clave"

Solución de problemas

Fuentes de datos

Cada respuesta incluye la atribución de la fuente: la agencia federal, el nombre del conjunto de datos y la URL de referencia.

Configuración

Casos de uso

Ingeniería civil y ambiental

• Diseño de aguas pluviales: precipitaciones (Atlas 14, curvas IDF, hietogramas), números de curva, tiempo de concentración, descarga máxima

• Análisis de inundaciones: frecuencia de inundaciones del Boletín 17C, curvas de duración de flujo, estimaciones de regresión regional

• Delimitación de cuencas hidrográficas y entradas de modelos hidrológicos (HEC-HMS, SWMM)

• Análisis de flujo bajo para permisos NPDES (7Q10, 7Q2, flujo medio armónico)

• Tormentas de diseño ajustadas al clima para la resiliencia de la infraestructura

Bienes raíces y desarrollo

• Debida diligencia ambiental para transacciones de propiedades

• Puntuación de viabilidad y desarrollabilidad del sitio (escala 0-100)

• Detección de zonas inundables, humedales y contaminación

• Análisis de vías de permisos (Sección 404, NPDES, desarrollo en llanuras aluviales)

Consultoría ambiental

• Recopilación de datos de escritorio para ESA Fase I (sitios de la EPA, calidad del agua)

• Apoyo a la delimitación de humedales (NWI + suelos + hidrología)

• Detección de hábitat de especies en peligro de extinción (hábitat crítico de USFWS)

• Evaluación de deterioro de la calidad del agua (lista 303(d) de EPA ATTAINS)

Contribución

¡Las contribuciones son bienvenidas! Por favor, abra un issue o un pull request.

Licencia

MIT

Enlaces

• Aplicación web: geotapdata.com

• Problemas: GitHub Issues

• npm: geotap-mcp-server