Recreation Opportunities MCP Server

An MCP (Model Context Protocol) server written in Go that enables LLMs like Claude to discover and learn about recreation opportunities by integrating three public REST APIs:

• National Park Service API - Information about national parks, activities, alerts, and campgrounds
• Recreation.gov API - Recreation areas, facilities, and campsites across federal lands
• OpenWeatherMap API - Current weather and forecasts for outdoor locations

Table of Contents

• Features
• MCP Tools
• Prerequisites
  • Getting API Keys
• Quick Start
• Example Queries
• Project Structure
• Configuration
• Development
  • Local Development Setup
  • Build Locally
  • Run Tests
  • Code Quality
  • Testing with Claude Desktop
• Architecture
• Performance
• Security
• Troubleshooting
• Contributing
• Roadmap
• Support
• License
• Acknowledgments

Features

• Search and explore national parks across the United States
• Find campgrounds and recreation facilities
• Get weather information for planning outdoor activities
• Query parks by state, activity, or keyword
• Check park alerts and closures
• Discover recreation areas and detailed facility information
• Easy deployment via Docker and docker-compose
• Seamless integration with Claude Desktop

MCP Tools

This server provides 9 tools for exploring recreation opportunities:

1. search_parks

Search for national parks by name, state, or activity.

Inputs:

• query (optional): Search text
• state (optional): Two-letter state code (e.g., "CA", "CO")
• activity (optional): Activity name (e.g., "Hiking", "Camping")
• limit (optional): Maximum results (default: 10)

Example: "Search for parks in California"

2. get_park_details

Get detailed information about a specific park including hours, fees, activities, and directions.

Inputs:

• park_code (required): Four-letter park code (e.g., "yose" for Yosemite)

Example: "Tell me about Yosemite National Park"

3. get_park_alerts

Get current alerts, closures, and important notices for a park.

Inputs:

• park_code (required): Four-letter park code

Example: "Are there any alerts for Grand Canyon?"

4. search_campgrounds

Search for campgrounds in national parks or recreation areas.

Inputs:

• park_code (optional): NPS park code
• state (optional): State code
• query (optional): Search text
• limit (optional): Maximum results (default: 10)

Example: "Find campgrounds near Yellowstone"

5. search_recreation_areas

Search recreation areas on Recreation.gov across federal lands.

Inputs:

• query (optional): Search text
• state (optional): State code
• activity (optional): Activity name
• limit (optional): Maximum results (default: 10)

Example: "Show me recreation areas in Utah with hiking"

6. get_facility_details

Get detailed information about a specific facility (campground, day-use area, etc.).

Inputs:

• facility_id (required): Recreation.gov facility ID

Example: "Tell me about facility 234567"

7. get_weather

Get current weather conditions for a location.

Inputs:

• latitude (required): Latitude coordinate
• longitude (

... View full README on GitHub