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
Python 3.11+
Ein NPS-API-Schlüssel — kostenlos erhältlich unter https://www.nps.gov/subjects/developer/get-started.htm
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.txtKonfiguration
# 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_hereIhre .env-Datei ist in .gitignore aufgeführt und wird niemals committet.
Ausführen des Servers
python server.pyDer 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
Öffnen Sie Ihre Claude Desktop-Konfigurationsdatei:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
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.
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-parksmit 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.pySetzen Sie dann die Umgebungsvariable in Ihrer Shell, bevor Sie Claude Code ausführen:
export NPS_API_KEY=your_api_key_here
claudeTesten mit dem MCP Inspector
npx @modelcontextprotocol/inspector python server.pyDies öffnet eine Browser-Benutzeroberfläche, in der Sie jedes Tool manuell aufrufen und Antworten untersuchen können.
Verfügbare Tools
Tool | Beschreibung |
| Listet alle Park-Codes und vollständigen Namen auf, die diesem Server bekannt sind |
| Sucht Parks nach Name oder Stichwort, optional gefiltert nach Bundesstaat |
| Ruft vollständige Details für einen bestimmten Park per Code ab |
| Aktuelle Schließungen, Gefahren und Hinweise für einen Park |
| Öffnungszeiten und Kontaktinformationen der Besucherzentren |
| Kapazität, Barrierefreiheit und Live-Belegung von Parkplätzen |
| Details zu Campingplätzen, Gebühren und Reservierungen |
| Kommende Ranger-Programme und Park-Veranstaltungen |
| Empfohlene Aktivitäten (Wandern, Angeln, Sternenbeobachtung usw.) |
| Geführte Touren, die in einem Park verfügbar sind |
| Live-Webcam-Feeds |
| Eintrittsgebühren und Informationen zu Pässen |
| Aktuelle Pressemitteilungen eines Parks |
| Straßensperrungen und Baustellen |
| Bedeutende Sehenswürdigkeiten und Orte innerhalb eines Parks |
| Historische Persönlichkeiten und Naturschützer, die mit einem Park verbunden sind |
| Pädagogische Artikel, die vom Park veröffentlicht wurden |
| Unterrichtspläne für Lehrer in Bezug auf einen Park |
| Orte zum Sammeln von National Park Passport-Stempeln |
| Durchsuchen aller Aktivitätskategorien im gesamten NPS |
| 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 |
| Acadia National Park |
| New River Gorge National Park & Preserve |
| Shenandoah National Park |
| Virgin Islands National Park |
Südosten
Code | Park |
| Biscayne National Park |
| Congaree National Park |
| Dry Tortugas National Park |
| Everglades National Park |
| Great Smoky Mountains National Park |
| Hot Springs National Park |
| Mammoth Cave National Park |
Mittlerer Westen
Code | Park |
| Cuyahoga Valley National Park |
| Indiana Dunes National Park |
| Isle Royale National Park |
| Gateway Arch National Park |
| Voyageurs National Park |
Great Plains
Code | Park |
| Badlands National Park |
| Theodore Roosevelt National Park |
| Wind Cave National Park |
Rocky Mountain
Code | Park |
| Black Canyon Of The Gunnison National Park |
| Bryce Canyon National Park |
| Canyonlands National Park |
| Capitol Reef National Park |
| Great Sand Dunes National Park & Preserve |
| Grand Teton National Park |
| Mesa Verde National Park |
| Rocky Mountain National Park |
| Yellowstone National Park |
| Zion National Park |
Südwesten
Code | Park |
| Arches National Park |
| Big Bend National Park |
| Carlsbad Caverns National Park |
| Death Valley National Park |
| Grand Canyon National Park |
| Great Basin National Park |
| Guadalupe Mountains National Park |
| Petrified Forest National Park |
| Saguaro National Park |
| White Sands National Park |
Kalifornien
Code | Park |
| Channel Islands National Park |
| Joshua Tree National Park |
| Kings Canyon National Park |
| Lassen Volcanic National Park |
| Pinnacles National Park |
| Redwood National & State Parks |
| Sequoia National Park |
| Yosemite National Park |
Pazifischer Nordwesten
Code | Park |
| Crater Lake National Park |
| Mount Rainier National Park |
| North Cascades National Park |
| Olympic National Park |
Hawaii
Code | Park |
| Haleakalā National Park |
| Hawaiʻi Volcanoes National Park |
Alaska
Code | Park |
| Denali National Park & Preserve |
| Gates of the Arctic National Park & Preserve |
| Glacier Bay National Park & Preserve |
| Katmai National Park & Preserve |
| Kenai Fjords National Park |
| Kobuk Valley National Park |
| Lake Clark National Park & Preserve |
| Wrangell-St. Elias National Park & Preserve |
Sonstige
Code | Park |
| Glacier National Park (Montana) |
| 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.
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