NPS MCP Server
Servidor MCP de NPS
Un servidor del Protocolo de Contexto de Modelo (MCP) que brinda a Claude (o a cualquier cliente de IA compatible con MCP) acceso a la API del Servicio de Parques Nacionales. Haz preguntas sobre parques, alertas, campamentos, eventos, estacionamiento y más, todo en lenguaje natural.
Requisitos previos
Python 3.11+
Una clave de API de NPS — gratuita, obtén una en https://www.nps.gov/subjects/developer/get-started.htm
Related MCP server: National Parks MCP Server
Instalación
# 1. Clone the repository
git clone https://github.com/AniruddhaShukla/nps-mcp.git
cd nps-mcp
# 2. Create and activate a virtual environment
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
# 3. Install dependencies
pip install -r requirements.txtConfiguración
# Copy the example env file
cp .env.example .env
# Open .env and replace the placeholder with your real API key
# NPS_API_KEY=your_api_key_hereTu archivo .env aparece en .gitignore y nunca se enviará al repositorio.
Ejecución del servidor
python server.pyEl servidor se comunica a través de stdio (transporte MCP estándar) y permanece en ejecución hasta que lo detengas. No interactúas con él directamente, lo hace tu cliente MCP.
Conexión a Claude Desktop
Abre tu archivo de configuración de Claude Desktop:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Añade este bloque dentro del objeto
"mcpServers"(crea el objeto si no existe):
{
"mcpServers": {
"national-parks": {
"command": "/absolute/path/to/.venv/bin/python",
"args": ["/absolute/path/to/nps-mcp/server.py"],
"env": {
"NPS_API_KEY": "your_api_key_here"
}
}
}
}Reemplaza las rutas con las rutas absolutas reales en tu máquina. Usar el bloque env aquí significa que ni siquiera necesitas el archivo .env: la clave se pasa directamente.
Reinicia Claude Desktop. Para verificar que funciona, haz clic en el icono de clip / adjunto en la barra de entrada del chat, luego selecciona Connectors: deberías ver
national-parkslistado con un interruptor azul que indica que está en ejecución. Puedes habilitarlo o deshabilitarlo por conversación desde allí.
Conexión a Claude Code
claude mcp add national-parks -- /absolute/path/to/.venv/bin/python /absolute/path/to/nps-mcp/server.pyLuego, establece la variable de entorno en tu shell antes de ejecutar Claude Code:
export NPS_API_KEY=your_api_key_here
claudePruebas con el Inspector MCP
npx @modelcontextprotocol/inspector python server.pyEsto abre una interfaz de usuario en el navegador donde puedes llamar a cada herramienta manualmente e inspeccionar las respuestas.
Herramientas disponibles
Herramienta | Descripción |
| Lista todos los códigos de parque y nombres completos conocidos por este servidor |
| Busca parques por nombre o palabra clave, opcionalmente filtrados por estado |
| Obtiene detalles completos de un parque específico por código |
| Cierres actuales, peligros y avisos para un parque |
| Horarios e información de contacto de los centros de visitantes |
| Capacidad, accesibilidad y ocupación en tiempo real de los estacionamientos |
| Detalles de campamentos, tarifas y reservas |
| Próximos programas de guardaparques y eventos del parque |
| Actividades recomendadas (senderismo, pesca, observación de estrellas, etc.) |
| Visitas guiadas disponibles en un parque |
| Transmisiones de cámaras web en vivo |
| Tarifas de entrada e información sobre pases |
| Comunicados de prensa recientes de un parque |
| Cierres de carreteras y zonas de construcción |
| Lugares y puntos de referencia notables dentro de un parque |
| Figuras históricas y conservacionistas asociados con un parque |
| Artículos educativos publicados por el parque |
| Planes de lecciones para profesores relacionados con un parque |
| Dónde coleccionar sellos del Pasaporte de Parques Nacionales |
| Explora todas las categorías de actividades en el NPS |
| Explora todas las categorías de temas (historia, geología, etc.) |
Códigos de parque conocidos
Los 63 Parques Nacionales de EE. UU. designados oficialmente están pre-mapeados. Para cualquier otro sitio del NPS (monumentos, costas, áreas recreativas, etc.), usa search_parks para encontrar su código.
Noreste
Código | Parque |
| Parque Nacional Acadia |
| Parque Nacional y Reserva New River Gorge |
| Parque Nacional Shenandoah |
| Parque Nacional de las Islas Vírgenes |
Sureste
Código | Parque |
| Parque Nacional Biscayne |
| Parque Nacional Congaree |
| Parque Nacional Dry Tortugas |
| Parque Nacional Everglades |
| Parque Nacional Great Smoky Mountains |
| Parque Nacional Hot Springs |
| Parque Nacional Mammoth Cave |
Medio Oeste
Código | Parque |
| Parque Nacional Cuyahoga Valley |
| Parque Nacional Indiana Dunes |
| Parque Nacional Isle Royale |
| Parque Nacional Gateway Arch |
| Parque Nacional Voyageurs |
Grandes Llanuras
Código | Parque |
| Parque Nacional Badlands |
| Parque Nacional Theodore Roosevelt |
| Parque Nacional Wind Cave |
Montañas Rocosas
Código | Parque |
| Parque Nacional Black Canyon Of The Gunnison |
| Parque Nacional Bryce Canyon |
| Parque Nacional Canyonlands |
| Parque Nacional Capitol Reef |
| Parque Nacional y Reserva Great Sand Dunes |
| Parque Nacional Grand Teton |
| Parque Nacional Mesa Verde |
| Parque Nacional Rocky Mountain |
| Parque Nacional Yellowstone |
| Parque Nacional Zion |
Suroeste
Código | Parque |
| Parque Nacional Arches |
| Parque Nacional Big Bend |
| Parque Nacional Carlsbad Caverns |
| Parque Nacional Death Valley |
| Parque Nacional Grand Canyon |
| Parque Nacional Great Basin |
| Parque Nacional Guadalupe Mountains |
| Parque Nacional Petrified Forest |
| Parque Nacional Saguaro |
| Parque Nacional White Sands |
California
Código | Parque |
| Parque Nacional Channel Islands |
| Parque Nacional Joshua Tree |
| Parque Nacional Kings Canyon |
| Parque Nacional Lassen Volcanic |
| Parque Nacional Pinnacles |
| Parques Nacionales y Estatales Redwood |
| Parque Nacional Sequoia |
| Parque Nacional Yosemite |
Noroeste del Pacífico
Código | Parque |
| Parque Nacional Crater Lake |
| Parque Nacional Mount Rainier |
| Parque Nacional North Cascades |
| Parque Nacional Olympic |
Hawái
Código | Parque |
| Parque Nacional Haleakalā |
| Parque Nacional de los Volcanes de Hawái |
Alaska
Código | Parque |
| Parque Nacional y Reserva Denali |
| Parque Nacional y Reserva Gates of the Arctic |
| Parque Nacional y Reserva Glacier Bay |
| Parque Nacional y Reserva Katmai |
| Parque Nacional Kenai Fjords |
| Parque Nacional Kobuk Valley |
| Parque Nacional y Reserva Lake Clark |
| Parque Nacional y Reserva Wrangell-St. Elias |
Otros
Código | Parque |
| Parque Nacional Glacier (Montana) |
| Parque Nacional de Samoa Americana |
Consultas de ejemplo
Una vez conectado a Claude, intenta preguntar:
"¿Cuáles son las alertas actuales en Yellowstone?"
"Encuentra campamentos en el Parque Nacional Yosemite."
"¿Cuáles son las tarifas de entrada para el Gran Cañón?"
"Muéstrame los estacionamientos en Yellowstone y su ocupación actual."
"¿Hay cierres de carreteras en el Parque Nacional Glacier?"
"¿Qué eventos hay en Acadia esta semana?"
"¿Qué hay para hacer en el Parque Nacional Zion?"
"Encuentra parques nacionales en Utah."
Licencia
Este proyecto es de código abierto. La API de NPS es un servicio público gratuito proporcionado por el Servicio de Parques Nacionales de EE. UU.
This server cannot be deployed
Maintenance
Related MCP Connectors
Plan US National Park Service trips — parks, alerts, campgrounds, things to do, events.
NPS MCP — US National Park Service (free key, generous limits)
Recreation.gov MCP — wraps the Recreation Information Database (RIDB) API v1
Provide real-time and forecast weather information for locations in the United States using natura…
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceFacilitates retrieval of National Park Services data using the NPS API, allowing users to list national parks by state and access detailed information about specific parks.44,731 npm3MIT
- AlicenseBqualityDmaintenanceProvides real-time information about U.S. National Parks through the NPS API, enabling users to search parks, check details, alerts, visitor centers, campgrounds, and upcoming events.6142 npm41MIT
- AlicenseNot gradedqualityDmaintenanceProvides access to the National Park Service API to search for U.S. national parks, view park details, check alerts and closures, find visitor centers, campgrounds, and upcoming events.142 npmMIT
- AlicenseNot gradedqualityDmaintenanceProvides LLM context on U.S. national parks by integrating National Park Service, Recreation.gov, and weather APIs, enabling queries about park info, trails, alerts, events, weather forecasts, and more via tool calls.3MIT