What is Nps Explorer Mcp Server

nps-explorer-mcp-server is a Model Context Protocol (MCP) server hosted on Cloudflare Workers. It allows users to query various APIs related to U.S. national parks, including park overviews, trails, alerts, events, and weather forecasts through simple tool calls from their preferred LLM.

Use cases

Use cases for nps-explorer-mcp-server include developing applications that provide park information to visitors, creating tools for outdoor enthusiasts to plan their trips, and building educational resources for schools and organizations focused on environmental awareness.

How to use

To use nps-explorer-mcp-server, clone the repository, set up your environment by filling in the required API keys in the .dev.vars file, and deploy the server on Cloudflare Workers. After setup, you can make API calls to retrieve information about national parks.

Key features

Key features of nps-explorer-mcp-server include integration with the National Park Service API, Recreation.gov API, and a Weather API, enabling users to access a wide range of information about national parks in a streamlined manner.

Where to use

nps-explorer-mcp-server can be used in various fields such as environmental research, tourism, outdoor recreation planning, and educational applications related to U.S. national parks.

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:

• The National Park Service API
• The Recreation.gov API
• A Weather API (I chose https://www.weatherapi.com/)

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.

• [NPS API](https://raw.githubusercontent.com/Kyle-Ski/nps-explorer-mcp-server/master/ https://www.nps.gov/subjects/developer/api-documentation.htm)
• rec.gov API
• Weather API (or whatever you choose)
• Create a GitHub OAuth App

3. Install dependencies

npm i

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

🧪 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

• Original Cloudflare Demo README:
  https://github.com/cloudflare/ai/tree/main/demos/remote-mcp-github-oauth#readme
• Model Context Protocol:
  https://modelcontextprotocol.io/introduction
• Connecting an agent to your server:

🧑‍🔧 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.