Skip to main content
Glama
AniruddhaShukla

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


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.txt

Configuració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_here

Tu archivo .env aparece en .gitignore y nunca se enviará al repositorio.


Ejecución del servidor

python server.py

El 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

  1. Abre tu archivo de configuración de Claude Desktop:

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

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

  2. 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.

  1. 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-parks listado 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.py

Luego, establece la variable de entorno en tu shell antes de ejecutar Claude Code:

export NPS_API_KEY=your_api_key_here
claude

Pruebas con el Inspector MCP

npx @modelcontextprotocol/inspector python server.py

Esto abre una interfaz de usuario en el navegador donde puedes llamar a cada herramienta manualmente e inspeccionar las respuestas.


Herramientas disponibles

Herramienta

Descripción

list_known_parks

Lista todos los códigos de parque y nombres completos conocidos por este servidor

search_parks

Busca parques por nombre o palabra clave, opcionalmente filtrados por estado

get_park

Obtiene detalles completos de un parque específico por código

get_park_alerts

Cierres actuales, peligros y avisos para un parque

get_visitor_centers

Horarios e información de contacto de los centros de visitantes

get_parking_lots

Capacidad, accesibilidad y ocupación en tiempo real de los estacionamientos

get_campgrounds

Detalles de campamentos, tarifas y reservas

get_events

Próximos programas de guardaparques y eventos del parque

get_things_to_do

Actividades recomendadas (senderismo, pesca, observación de estrellas, etc.)

get_tours

Visitas guiadas disponibles en un parque

get_webcams

Transmisiones de cámaras web en vivo

get_fees_passes

Tarifas de entrada e información sobre pases

get_news_releases

Comunicados de prensa recientes de un parque

get_road_events

Cierres de carreteras y zonas de construcción

get_places

Lugares y puntos de referencia notables dentro de un parque

get_people

Figuras históricas y conservacionistas asociados con un parque

get_articles

Artículos educativos publicados por el parque

get_lesson_plans

Planes de lecciones para profesores relacionados con un parque

get_passport_stamp_locations

Dónde coleccionar sellos del Pasaporte de Parques Nacionales

get_activities

Explora todas las categorías de actividades en el NPS

get_topics

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

acad

Parque Nacional Acadia

neri

Parque Nacional y Reserva New River Gorge

shen

Parque Nacional Shenandoah

viis

Parque Nacional de las Islas Vírgenes

Sureste

Código

Parque

bisc

Parque Nacional Biscayne

cong

Parque Nacional Congaree

drto

Parque Nacional Dry Tortugas

ever

Parque Nacional Everglades

grsm

Parque Nacional Great Smoky Mountains

hosp

Parque Nacional Hot Springs

maca

Parque Nacional Mammoth Cave

Medio Oeste

Código

Parque

cuva

Parque Nacional Cuyahoga Valley

indu

Parque Nacional Indiana Dunes

isro

Parque Nacional Isle Royale

jeff

Parque Nacional Gateway Arch

voya

Parque Nacional Voyageurs

Grandes Llanuras

Código

Parque

badl

Parque Nacional Badlands

thro

Parque Nacional Theodore Roosevelt

wica

Parque Nacional Wind Cave

Montañas Rocosas

Código

Parque

blca

Parque Nacional Black Canyon Of The Gunnison

brca

Parque Nacional Bryce Canyon

cany

Parque Nacional Canyonlands

care

Parque Nacional Capitol Reef

grsa

Parque Nacional y Reserva Great Sand Dunes

grte

Parque Nacional Grand Teton

meve

Parque Nacional Mesa Verde

romo

Parque Nacional Rocky Mountain

yell

Parque Nacional Yellowstone

zion

Parque Nacional Zion

Suroeste

Código

Parque

arch

Parque Nacional Arches

bibe

Parque Nacional Big Bend

cave

Parque Nacional Carlsbad Caverns

deva

Parque Nacional Death Valley

grca

Parque Nacional Grand Canyon

grba

Parque Nacional Great Basin

gumo

Parque Nacional Guadalupe Mountains

pefo

Parque Nacional Petrified Forest

sagu

Parque Nacional Saguaro

whsa

Parque Nacional White Sands

California

Código

Parque

chis

Parque Nacional Channel Islands

jotr

Parque Nacional Joshua Tree

kica

Parque Nacional Kings Canyon

lavo

Parque Nacional Lassen Volcanic

pinn

Parque Nacional Pinnacles

redw

Parques Nacionales y Estatales Redwood

sequ

Parque Nacional Sequoia

yose

Parque Nacional Yosemite

Noroeste del Pacífico

Código

Parque

crla

Parque Nacional Crater Lake

mora

Parque Nacional Mount Rainier

noca

Parque Nacional North Cascades

olym

Parque Nacional Olympic

Hawái

Código

Parque

hale

Parque Nacional Haleakalā

havo

Parque Nacional de los Volcanes de Hawái

Alaska

Código

Parque

dena

Parque Nacional y Reserva Denali

gaar

Parque Nacional y Reserva Gates of the Arctic

glba

Parque Nacional y Reserva Glacier Bay

katm

Parque Nacional y Reserva Katmai

kefj

Parque Nacional Kenai Fjords

kova

Parque Nacional Kobuk Valley

lacl

Parque Nacional y Reserva Lake Clark

wrst

Parque Nacional y Reserva Wrangell-St. Elias

Otros

Código

Parque

glac

Parque Nacional Glacier (Montana)

npsa

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.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Facilitates 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 npm
    3
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    Provides 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.
    6
    142 npm
    41
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides 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.
    3
    MIT