Skip to main content
Glama
AniruddhaShukla

NPS MCP Server

NPS MCP-Server

Ein Model Context Protocol (MCP)-Server, der Claude (oder jedem anderen MCP-kompatiblen KI-Client) Zugriff auf die API des National Park Service gewährt. Stellen Sie Fragen zu Parks, Warnmeldungen, Campingplätzen, Veranstaltungen, Parkplätzen und mehr – alles in natürlicher Sprache.


Voraussetzungen


Related MCP server: National Parks MCP Server

Installation

# 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

Konfiguration

# 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

Ihre .env-Datei ist in .gitignore aufgeführt und wird niemals committet.


Ausführen des Servers

python server.py

Der Server kommuniziert über stdio (Standard-MCP-Transport) und bleibt aktiv, bis Sie ihn beenden. Sie interagieren nicht direkt mit ihm — das erledigt Ihr MCP-Client.


Verbindung mit Claude Desktop

  1. Öffnen Sie Ihre Claude Desktop-Konfigurationsdatei:

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

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

  2. Fügen Sie diesen Block innerhalb des "mcpServers"-Objekts hinzu (erstellen Sie das Objekt, falls es noch nicht existiert):

{
  "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"
      }
    }
  }
}

Ersetzen Sie die Pfade durch die tatsächlichen absoluten Pfade auf Ihrem Computer. Die Verwendung des env-Blocks hier bedeutet, dass Sie nicht einmal die .env-Datei benötigen — der Schlüssel wird direkt übergeben.

  1. Starten Sie Claude Desktop neu. Um zu überprüfen, ob es funktioniert, klicken Sie auf das Büroklammer-/Anhang-Symbol in der Chat-Eingabeleiste und wählen Sie dann Connectors — Sie sollten national-parks mit einem blauen Schalter sehen, der anzeigt, dass es läuft. Sie können es dort pro Konversation aktivieren oder deaktivieren.


Verbindung mit Claude Code

claude mcp add national-parks -- /absolute/path/to/.venv/bin/python /absolute/path/to/nps-mcp/server.py

Setzen Sie dann die Umgebungsvariable in Ihrer Shell, bevor Sie Claude Code ausführen:

export NPS_API_KEY=your_api_key_here
claude

Testen mit dem MCP Inspector

npx @modelcontextprotocol/inspector python server.py

Dies öffnet eine Browser-Benutzeroberfläche, in der Sie jedes Tool manuell aufrufen und Antworten untersuchen können.


Verfügbare Tools

Tool

Beschreibung

list_known_parks

Listet alle Park-Codes und vollständigen Namen auf, die diesem Server bekannt sind

search_parks

Sucht Parks nach Name oder Stichwort, optional gefiltert nach Bundesstaat

get_park

Ruft vollständige Details für einen bestimmten Park per Code ab

get_park_alerts

Aktuelle Schließungen, Gefahren und Hinweise für einen Park

get_visitor_centers

Öffnungszeiten und Kontaktinformationen der Besucherzentren

get_parking_lots

Kapazität, Barrierefreiheit und Live-Belegung von Parkplätzen

get_campgrounds

Details zu Campingplätzen, Gebühren und Reservierungen

get_events

Kommende Ranger-Programme und Park-Veranstaltungen

get_things_to_do

Empfohlene Aktivitäten (Wandern, Angeln, Sternenbeobachtung usw.)

get_tours

Geführte Touren, die in einem Park verfügbar sind

get_webcams

Live-Webcam-Feeds

get_fees_passes

Eintrittsgebühren und Informationen zu Pässen

get_news_releases

Aktuelle Pressemitteilungen eines Parks

get_road_events

Straßensperrungen und Baustellen

get_places

Bedeutende Sehenswürdigkeiten und Orte innerhalb eines Parks

get_people

Historische Persönlichkeiten und Naturschützer, die mit einem Park verbunden sind

get_articles

Pädagogische Artikel, die vom Park veröffentlicht wurden

get_lesson_plans

Unterrichtspläne für Lehrer in Bezug auf einen Park

get_passport_stamp_locations

Orte zum Sammeln von National Park Passport-Stempeln

get_activities

Durchsuchen aller Aktivitätskategorien im gesamten NPS

get_topics

Durchsuchen aller Themenkategorien (Geschichte, Geologie usw.)


Bekannte Park-Codes

Alle 63 offiziell ausgewiesenen U.S. National Parks sind vorab hinterlegt. Für jede andere NPS-Stätte (Denkmäler, Küsten, Erholungsgebiete usw.) verwenden Sie search_parks, um den Code zu finden.

Nordosten

Code

Park

acad

Acadia National Park

neri

New River Gorge National Park & Preserve

shen

Shenandoah National Park

viis

Virgin Islands National Park

Südosten

Code

Park

bisc

Biscayne National Park

cong

Congaree National Park

drto

Dry Tortugas National Park

ever

Everglades National Park

grsm

Great Smoky Mountains National Park

hosp

Hot Springs National Park

maca

Mammoth Cave National Park

Mittlerer Westen

Code

Park

cuva

Cuyahoga Valley National Park

indu

Indiana Dunes National Park

isro

Isle Royale National Park

jeff

Gateway Arch National Park

voya

Voyageurs National Park

Great Plains

Code

Park

badl

Badlands National Park

thro

Theodore Roosevelt National Park

wica

Wind Cave National Park

Rocky Mountain

Code

Park

blca

Black Canyon Of The Gunnison National Park

brca

Bryce Canyon National Park

cany

Canyonlands National Park

care

Capitol Reef National Park

grsa

Great Sand Dunes National Park & Preserve

grte

Grand Teton National Park

meve

Mesa Verde National Park

romo

Rocky Mountain National Park

yell

Yellowstone National Park

zion

Zion National Park

Südwesten

Code

Park

arch

Arches National Park

bibe

Big Bend National Park

cave

Carlsbad Caverns National Park

deva

Death Valley National Park

grca

Grand Canyon National Park

grba

Great Basin National Park

gumo

Guadalupe Mountains National Park

pefo

Petrified Forest National Park

sagu

Saguaro National Park

whsa

White Sands National Park

Kalifornien

Code

Park

chis

Channel Islands National Park

jotr

Joshua Tree National Park

kica

Kings Canyon National Park

lavo

Lassen Volcanic National Park

pinn

Pinnacles National Park

redw

Redwood National & State Parks

sequ

Sequoia National Park

yose

Yosemite National Park

Pazifischer Nordwesten

Code

Park

crla

Crater Lake National Park

mora

Mount Rainier National Park

noca

North Cascades National Park

olym

Olympic National Park

Hawaii

Code

Park

hale

Haleakalā National Park

havo

Hawaiʻi Volcanoes National Park

Alaska

Code

Park

dena

Denali National Park & Preserve

gaar

Gates of the Arctic National Park & Preserve

glba

Glacier Bay National Park & Preserve

katm

Katmai National Park & Preserve

kefj

Kenai Fjords National Park

kova

Kobuk Valley National Park

lacl

Lake Clark National Park & Preserve

wrst

Wrangell-St. Elias National Park & Preserve

Sonstige

Code

Park

glac

Glacier National Park (Montana)

npsa

National Park of American Samoa


Beispielabfragen

Sobald Sie mit Claude verbunden sind, versuchen Sie es mit diesen Fragen:

  • "Was sind die aktuellen Warnmeldungen im Yellowstone?"

  • "Finde Campingplätze im Yosemite National Park."

  • "Wie hoch sind die Eintrittsgebühren für den Grand Canyon?"

  • "Zeige mir die Parkplätze im Yellowstone und deren aktuelle Belegung."

  • "Gibt es Straßensperrungen im Glacier National Park?"

  • "Welche Veranstaltungen finden diese Woche in Acadia statt?"

  • "Was kann man im Zion National Park unternehmen?"

  • "Finde Nationalparks in Utah."


Lizenz

Dieses Projekt ist Open Source. Die NPS-API ist ein kostenloser öffentlicher Dienst, der vom U.S. National Park Service bereitgestellt wird.

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