nps-explorer-mcp-server

Kyle-Ski/nps-explorer-mcp-server

3.2

If you are the rightful owner of nps-explorer-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The NPS Explorer MCP Server is a modified version of Cloudflare’s remote-MCP-GitHub-OAuth demo, designed to provide comprehensive information on U.S. national parks through a Model Context Protocol server.

Tools

  1. getParkInfo

    Get comprehensive information about a national park including both static details and current conditions

  2. getTrailInfo

    Get detailed information about trails (difficulty, length, elevation gain, current conditions)

  3. findParks

    Find national parks based on criteria such as state, activities, or amenities

  4. getParkAlerts

    Get current alerts, closures, and notifications for specified parks

  5. getParkEvents

    Get upcoming events at parks including ranger talks, guided hikes, and educational programs

  6. findNearbyRecreation

    Find recreation areas and camping options near a given location

  7. planParkVisit

    Get recommendations for the best time to visit a park based on historical and forecast weather

  8. getParkWeatherForecast

    Get detailed weather forecast for a national park by park code

  9. getCampgrounds

    List campgrounds within a given national park with detailed information

NPS Explorer MCP Server 🔭

Overview

This repository is a modified version of Cloudflare’s remote-MCP-GitHub-OAuth demo, extended into a National Parks Service Explorer. It provides an LLM context on U.S. national parks by integrating:

It runs as a Model Context Protocol (MCP) server on Cloudflare Workers, letting you query park overviews, trails, alerts, events, weather forecasts, and more via simple tool calls to the LLM.

Looking for the original demo?
See Cloudflare’s instructions here.

Want to add this tool directly to your Claude Desktop?
Checkout the instructions here

Want to clone their example directly? Use their command line to get a server going on your machine:

 npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-github-oauth

📋 Prerequisites

  • A Cloudflare account with Workers and KV enabled
  • Node.js v18.20.4+ and npm
  • Your own API keys for:
    • National Park Service API
    • Recreation.gov API
    • Weather API (weatherapi)

⚙️ Setup

  1. Clone this repo

    git clone https://github.com/Kyle-Ski/nps-explorer-mcp-server.git
cd nps-explorer-mcp-server

  2. Copy and fill .dev.vars

    cp .dev.vars.example .dev.vars

    Then open .dev.vars and populate with your own secrets.

  1. Install dependencies
npm i
  1. Run Locally
npm start

🚀 Deployment

The deploy command is using Wrangler to deploy your server to Cloudflare Workers! Cloudflare will also use their Durable Objects and Workers KV.

npm run deploy

🧰 Tools

Tool NameDescriptionStatus
getParkInfoGet comprehensive information about a national park including both static details and current conditionsworking
getTrailInfoGet detailed information about trails (difficulty, length, elevation gain, current conditions)🚧 under construction
findParksFind national parks based on criteria such as state, activities, or amenitiesworking
getParkAlertsGet current alerts, closures, and notifications for specified parksworking
getParkEventsGet upcoming events at parks including ranger talks, guided hikes, and educational programsworking
findNearbyRecreationFind recreation areas and camping options near a given location⚠️ not working correctly
planParkVisitGet recommendations for the best time to visit a park based on historical and forecast weatherworking
getParkWeatherForecastGet detailed weather forecast for a national park by park codeworking
getCampgroundsList campgrounds within a given national park with detailed informationworking

🧪 Testing

Once your server is up and running, use the MCP Server Inspector Tool to make sure your server can connect and show you the tools and resources it has access to.

npx @modelcontextprotocol/inspector

🛜 For Production

All of this is in the original Cloudflare README.md
Cloudflare recommends creating a local and remote GitHub OAuth App:

  • For the Homepage URL, specify https://mcp-github-oauth.<your-subdomain>.workers.dev
  • For the Authorization callback URL, specify https://mcp-github-oauth.<your-subdomain>.workers.dev/callback
  • Note your Client ID and generate a Client secret and add them via Wrangler.
wrangler secret put GITHUB_CLIENT_ID
wrangler secret put GITHUB_CLIENT_SECRET
wrangler secret put COOKIE_ENCRYPTION_KEY # add any random string here e.g. openssl rand -hex 32

Set up a KV namespace

  • Create the KV namespace: wrangler kv:namespace create "OAUTH_KV"
  • Update the Wrangler file with the KV ID

📚 Reference

🧑‍🔧 Troubleshooting and Common Issues

Check out the MCP troubleshooting docs

Connecting to Claude Desktop Fails:

  • Most commonly due to Node incompatibility issues, use node v18.20.4+ locally and checkout this guide I wrote.

🤝 Contributing

  1. Fork this repository

  2. Create a feature branch (git checkout -b feature-name)

  3. Commit your changes (git commit -m 'Add new tool')

  4. Push to the branch (git push origin feature-name)

  5. Open a Pull Request

⚖️ License

his project is licensed under the MIT License. See LICENSE for details.