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:
Power your agent
Install from the publisher. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
No packaged release in the registry yet. Follow the repository README.
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchFrom the publisher
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:
An MCP server in Go that enables LLMs to discover and learn about recreation opportunities

This server provides 9 tools for exploring recreation opportunities:
Search for national parks by name, state, or activity.
Inputs:
query (optional): Search textstate (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"
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"
Get current alerts, closures, and important notices for a park.
Inputs:
park_code (required): Four-letter park codeExample: "Are there any alerts for Grand Canyon?"
Search for campgrounds in national parks or recreation areas.
Inputs:
park_code (optional): NPS park codestate (optional): State codequery (optional): Search textlimit (optional): Maximum results (default: 10)Example: "Find campgrounds near Yellowstone"
Search recreation areas on Recreation.gov across federal lands.
Inputs:
query (optional): Search textstate (optional): State codeactivity (optional): Activity namelimit (optional): Maximum results (default: 10)Example: "Show me recreation areas in Utah with hiking"
Get detailed information about a specific facility (campground, day-use area, etc.).
Inputs:
facility_id (required): Recreation.gov facility IDExample: "Tell me about facility 234567"
Get current weather conditions for a location.
Inputs:
latitude (required): Latitude coordinatelongitude (required): Longitude coordinateunits (optional): "metric" or "imperial" (default: "imperial")Example: "What's the weather at 44.4280, -110.5885?" (Yellowstone coordinates)
Get 5-day weather forecast for a location.
Inputs:
latitude (required): Latitude coordinatelongitude (required): Longitude coordinateunits (optional): "metric" or "imperial" (default: "imperial")Example: "What's the weather forecast for Rocky Mountain National Park?"
List all available activities across NPS and Recreation.gov.
Inputs:
source (optional): "nps", "recreation_gov", or "all" (default: "all")limit (optional): Maximum results (default: 50)Example: "What activities are available in national parks?"
You can run this MCP server in two ways:
git clone https://github.com/adhocteam/recreation-mcp-server.git
cd recreation-mcp-server
Copy the example environment file and add your API keys:
cp .env.example .env
# Edit .env and add your API keys
Build and run:
docker-compose build
docker-compose up
Configure Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"recreation": {
"command": "docker",
"args": [
"compose",
"-f",
"/path/to/recreation-mcp-server/docker-compose.yml",
"run",
"--rm",
"mcp-recreation-server"
]
}
}
}
Replace /path/to/recreation-mcp-server with the actual path to this repository.
Build and run:
go build -o recreation-mcp-server
./recreation-mcp-server
Configure Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"recreation": {
"command": "/path/to/recreation-mcp-server/recreation-mcp-server",
"env": {
"NPS_API_KEY": "your-nps-api-key",
"RIDB_API_KEY": "your-ridb-api-key",
"OPENWEATHER_API_KEY": "your-openweather-api-key"
}
}
}
}
Replace /path/to/recreation-mcp-server with the actual path to this repository and add your API keys.
Install Go 1.25+
go version # Verify installation
Clone and setup
git clone https://github.com/adhocteam/recreation-mcp-server.git
cd recreation-mcp-server
go mod download
Set up environment
cp .env.example .env
# Edit .env and add your API keys
# Build the binary
go build -o mcp-server ./cmd/server
# Build for specific OS/architecture
GOOS=linux GOARCH=amd64 go build -o mcp-server-linux ./cmd/server
GOOS=darwin GOARCH=arm64 go build -o mcp-server-darwin ./cmd/server
# Run all unit tests
make test
# or
go test -v -race ./...
# Run with coverage
make test-coverage
# or
go test -coverprofile=coverage.out ./...
go tool cover -html=coverage.out -o coverage.html
# Check coverage percentage
go tool cover -func=coverage.out | grep total
# Run specific package tests
go test -v ./internal/api/...
# Run with verbose output
go test -v -run TestSearchParks ./internal/api/
Coverage Requirements:
make test-coverage# Make sure .env file exists with your API keys
go run ./cmd/server
# With debug logging
LOG_LEVEL=debug go run ./cmd/server
# Format code
make fmt
# or
go fmt ./...
# Run linter
make lint
# or
golangci-lint run
# Run all pre-commit checks
make pre-commit
The project includes a Makefile with common development tasks:
make help # Show all available commands
make build # Build the binary
make test # Run tests
make test-coverage # Generate coverage report
make lint # Run linter
make clean # Clean build artifacts
make run # Run the server locally
make docker-build # Build Docker image
make pre-commit # Run all pre-commit checks
make ci-check # Simulate CI environment locally
git checkout -b feature/my-featuremake pre-commitFor local development testing with Claude Desktop, you can run the server directly without Docker:
make build{
"mcpServers": {
"recreation": {
"command": "/absolute/path/to/recreation-mcp-server/mcp-server"
}
}
}
Enable debug logging to see detailed API requests and responses:
LOG_LEVEL=debug go run ./cmd/server
Debug output includes:
Once integrated with Claude Desktop, you can ask questions like:
Claude can combine multiple tools to answer complex questions:
recreation-mcp-server/
├── cmd/
│ └── server/ # Main application entry point
├── internal/
│ ├── mcp/ # MCP server implementation
│ ├── api/ # API clients (NPS, Recreation.gov, Weather)
│ ├── models/ # Data models
│ ├── cache/ # Response caching
│ └── config/ # Configuration management
├── pkg/
│ └── util/ # Utility functions
├── test/
│ ├── fixtures/ # Test data
│ └── integration/ # Integration tests
├── spec/ # Project specification
├── Dockerfile # Container definition
├── docker-compose.yml # Container orchestration
└── README.md # This file
The server can be configured through environment variables or an optional config.yaml file. See .env.example for available options.
Problem: Container exits immediately or fails to start
Solutions:
.env file: cat .envdocker-compose logs -fdocker build --no-cache .Problem: Claude doesn't see the MCP server or can't connect
Solutions:
claude_desktop_config.json is correctdocker-compose run --rm mcp-recreation-serverConfig file locations:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json~/.config/Claude/claude_desktop_config.jsonProblem: Tools return errors or no data
Solutions:
# Test NPS API
curl "https://developer.nps.gov/api/v1/parks?limit=1&api_key=YOUR_KEY"
# Test Recreation.gov API
curl -H "apikey: YOUR_KEY" "https://ridb.recreation.gov/api/v1/recareas?limit=1"
# Test OpenWeather API
curl "https://api.openweathermap.org/data/2.5/weather?lat=35&lon=-106&appid=YOUR_KEY"
docker-compose logsProblem: Queries return empty results
Solutions:
LOG_LEVEL=debug docker-compose upProblem: Slow responses or timeouts
Solutions:
CACHE_ENABLED=true in .envdocker statsProblem: Docker build fails
Solutions:
docker-compose build --no-cacheLOG_LEVEL=debug in your .env filedocker-compose logs -f┌─────────────────┐
│ Claude Desktop │ User interacts with Claude
│ (MCP Client) │
└────────┬────────┘
│ MCP Protocol (stdio)
▼
┌─────────────────────────────────┐
│ Recreation MCP Server (Go) │
│ ┌─────────────────────────┐ │
│ │ MCP Protocol Handler │ │ Handles tool calls
│ └──────────┬──────────────┘ │
│ │ │
│ ┌──────────▼──────────────┐ │
│ │ Tool Implementations │ │ 9 recreation tools
│ │ ┌──────────────────┐ │ │
│ │ │ Cache Layer │ │ │ LRU cache with TTL
│ │ └──────────────────┘ │ │
│ │ ┌──────────────────┐ │ │
│ │ │ API Clients │ │ │ HTTP clients
│ │ │ - NPS │ │ │ with retry logic
│ │ │ - Recreation.gov│ │ │
│ │ │ - OpenWeather │ │ │
│ │ └──────────────────┘ │ │
│ └─────────────────────────┘ │
└─────────────────────────────────┘
│ HTTPS
▼
┌─────────────────────────────────┐
│ External REST APIs │
│ - api.nps.gov │
│ - ridb.recreation.gov │
│ - api.openweathermap.org │
└─────────────────────────────────┘
internal/mcp/): Handles MCP protocol communicationinternal/api/): HTTP clients for external APIs with retry logicinternal/cache/): LRU cache with configurable TTLinternal/config/): Environment-based configurationinternal/models/): Shared data structurespkg/util/): HTTP client, logging, and helper functionsContributions are welcome! Here's how you can help:
git checkout -b feature/amazing-feature)make test)make lint)git commit -m 'Add amazing feature')git push origin feature/amazing-feature)AGENTS.md for project conventions and patternsCurrent Status:
Coverage by Package:
internal/config: 94.3% ✅internal/cache: 45.7%internal/api: 27.2%internal/mcp: 0.0% ⚠️pkg/util: 0.0% ⚠️Roadmap to 70% Coverage:
internal/mcppkg/utilBefore Submitting PRs:
make test-coveragemain before mergingThe main branch is protected with the following requirements:
These protections ensure code quality and prevent broken code from reaching production.
Future enhancements being considered:
MIT License - see LICENSE file for details.
An MCP server in Go that enables LLMs to discover and learn about recreation opportunities
Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
Recreation runs locally over stdio.
Last checked 2026-10-27. An MCP server in Go that enables LLMs to discover and learn about recreation opportunities