https://github.com/KyrieTangSheng/mcp-server-nationalparks
https://github.com/KyrieTangSheng/mcp-server-nationalparks
Last synced: 29 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/KyrieTangSheng/mcp-server-nationalparks
- Owner: KyrieTangSheng
- License: mit
- Created: 2025-03-20T05:57:34.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-03-20T09:15:45.000Z (about 1 month ago)
- Last Synced: 2025-03-20T10:25:35.389Z (about 1 month ago)
- Language: JavaScript
- Size: 26.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-zh - KyrieTangSheng/mcp-server-nationalparks
- awesome-mcp-servers - KyrieTangSheng/mcp-server-nationalparks - National Park Service API integration providing latest information of park details, alerts, visitor centers, campgrounds, and events for U.S. National Parks (Legend / 🚆 <a name="travel-and-transportation"></a>Travel & Transportation)
- awesome-mcp-servers - KyrieTangSheng/mcp-server-nationalparks - National Park Service API integration providing latest information of park details, alerts, visitor centers, campgrounds, and events for U.S. National Parks (Legend / 🚆 <a name="travel-and-transportation"></a>Travel & Transportation)
- awesome-mcp-servers - KyrieTangSheng/mcp-server-nationalparks - 米国国立公園局APIの統合で、米国国立公園の詳細情報、警報、ビジターセンター、キャンプ場、イベントの最新情報を提供 (サーバー実装 / 🚆 <a name="travel-and-transportation"></a>旅行と交通)
- awesome-mcp-servers - National Parks API Server - Provides real-time data on U.S. National Parks, including details, alerts, and activities (Table of Contents / Other Tools and Integrations)
- awesome-mcp-servers - National Parks API Server - Provides real-time data on U.S. National Parks, including details, alerts, and activities (Table of Contents / Other Tools and Integrations)
README
# National Parks MCP Server
[](https://smithery.ai/server/@KyrieTangSheng/mcp-server-nationalparks)
MCP Server for the National Park Service (NPS) API, providing real-time information about U.S. National Parks, including park details, alerts, and activities.
## Tools
1. `findParks`
- Search for national parks based on various criteria
- Inputs:
- `stateCode` (optional string): Filter parks by state code (e.g., "CA" for California). Multiple states can be comma-separated (e.g., "CA,OR,WA")
- `q` (optional string): Search term to filter parks by name or description
- `limit` (optional number): Maximum number of parks to return (default: 10, max: 50)
- `start` (optional number): Start position for results (useful for pagination)
- `activities` (optional string): Filter by available activities (e.g., "hiking,camping")
- Returns: Matching parks with detailed information
2. `getParkDetails`
- Get comprehensive information about a specific national park
- Inputs:
- `parkCode` (string): The park code of the national park (e.g., "yose" for Yosemite, "grca" for Grand Canyon)
- Returns: Detailed park information including descriptions, hours, fees, contacts, and activities
3. `getAlerts`
- Get current alerts for national parks including closures, hazards, and important information
- Inputs:
- `parkCode` (optional string): Filter alerts by park code (e.g., "yose" for Yosemite). Multiple parks can be comma-separated (e.g., "yose,grca")
- `limit` (optional number): Maximum number of alerts to return (default: 10, max: 50)
- `start` (optional number): Start position for results (useful for pagination)
- `q` (optional string): Search term to filter alerts by title or description
- Returns: Current alerts organized by park
4. `getVisitorCenters`
- Get information about visitor centers and their operating hours
- Inputs:
- `parkCode` (optional string): Filter visitor centers by park code (e.g., "yose" for Yosemite). Multiple parks can be comma-separated (e.g., "yose,grca")
- `limit` (optional number): Maximum number of visitor centers to return (default: 10, max: 50)
- `start` (optional number): Start position for results (useful for pagination)
- `q` (optional string): Search term to filter visitor centers by name or description
- Returns: Visitor center information including location, hours, and contact details
5. `getCampgrounds`
- Get information about available campgrounds and their amenities
- Inputs:
- `parkCode` (optional string): Filter campgrounds by park code (e.g., "yose" for Yosemite). Multiple parks can be comma-separated (e.g., "yose,grca")
- `limit` (optional number): Maximum number of campgrounds to return (default: 10, max: 50)
- `start` (optional number): Start position for results (useful for pagination)
- `q` (optional string): Search term to filter campgrounds by name or description
- Returns: Campground information including amenities, fees, and reservation details
6. `getEvents`
- Find upcoming events at parks
- Inputs:
- `parkCode` (optional string): Filter events by park code (e.g., "yose" for Yosemite). Multiple parks can be comma-separated (e.g., "yose,grca")
- `limit` (optional number): Maximum number of events to return (default: 10, max: 50)
- `start` (optional number): Start position for results (useful for pagination)
- `dateStart` (optional string): Start date for filtering events (format: YYYY-MM-DD)
- `dateEnd` (optional string): End date for filtering events (format: YYYY-MM-DD)
- `q` (optional string): Search term to filter events by title or description
- Returns: Event information including dates, times, and descriptions
## Setup
### Installing via Smithery
To install mcp-server-nationalparks for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@KyrieTangSheng/mcp-server-nationalparks):
```bash
npx -y @smithery/cli install @KyrieTangSheng/mcp-server-nationalparks --client claude
```
### NPS API Key
1. Get a free API key from the [National Park Service Developer Portal](https://www.nps.gov/subjects/developer/get-started.htm)
2. Store this key securely as it will be used to authenticate requests
### Usage with Claude Desktop
To use this server with Claude Desktop, add the following to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"nationalparks": {
"command": "npx",
"args": ["-y", "mcp-server-nationalparks"],
"env": {
"NPS_API_KEY": "YOUR_NPS_API_KEY"
}
}
}
}
```
## Example Usage
### Finding Parks in a State
```
Tell me about national parks in Colorado.
```
### Getting Details About a Specific Park
```
What's the entrance fee for Yellowstone National Park?
```
### Checking for Alerts or Closures
```
Are there any closures or alerts at Yosemite right now?
```
### Finding Visitor Centers
```
What visitor centers are available at Grand Canyon National Park?
```
### Looking for Campgrounds
```
Are there any campgrounds with electrical hookups in Zion National Park?
```
### Finding Upcoming Events
```
What events are happening at Acadia National Park next weekend?
```
### Planning a Trip Based on Activities
```
Which national parks in Utah have good hiking trails?
```
## License
This MCP server is licensed under the MIT License. See the LICENSE file for details.
## Appendix: Popular National Parks and their codes
| Park Name | Park Code |
|-----------|-----------|
| Yosemite | yose |
| Grand Canyon | grca |
| Yellowstone | yell |
| Zion | zion |
| Great Smoky Mountains | grsm |
| Acadia | acad |
| Olympic | olym |
| Rocky Mountain | romo |
| Joshua Tree | jotr |
| Sequoia & Kings Canyon | seki |
For a complete list, visit the [NPS website](https://www.nps.gov/findapark/index.htm).