
NPS Explorer MCP Server 🔭

2025.05.04
1
TypeScript国家公园信息服务旅游规划工具位置服务
NPS Explorer MCP Server 是一个基于 Cloudflare Workers 的 Model Context Protocol (MCP) 服务器,专门用于提供美国国家公园的相关信息。它集成了国家公园服务 API、Recreation.gov API 和天气 API,能够通过简单的工具调用向 LLM 提供公园概述、步道信息、警报、事件、天气预报等数据。
View on GitHub
Overview
基本能力
产品定位
NPS Explorer MCP Server 是一个专门用于查询和展示美国国家公园信息的 MCP 服务器,旨在为 LLM 提供丰富的国家公园上下文数据。
核心功能
- 获取公园详细信息(
getParkInfo
) - 获取步道信息(
getTrailInfo
,正在开发中) - 根据条件查找公园(
findParks
) - 获取公园警报和通知(
getParkAlerts
) - 获取公园活动信息(
getParkEvents
) - 查找附近娱乐区域(
findNearbyRecreation
,目前存在问题) - 规划公园访问时间(
planParkVisit
) - 获取公园天气预报(
getParkWeatherForecast
) - 获取露营地信息(
getCampgrounds
)
适用场景
- 国家公园信息查询系统
- 旅游规划工具
- 户外活动推荐系统
- 天气相关的公园访问规划
工具列表
工具名称 | 描述 | 状态 |
---|---|---|
getParkInfo |
获取公园的详细信息,包括静态数据和当前状况 | 正常工作 |
getTrailInfo |
获取步道详细信息(难度、长度、海拔变化等) | 正在开发 |
findParks |
根据州、活动或设施等条件查找国家公园 | 正常工作 |
getParkAlerts |
获取指定公园的当前警报、关闭和通知 | 正常工作 |
getParkEvents |
获取公园即将举办的活动(如护林员讲座、导览徒步等) | 正常工作 |
findNearbyRecreation |
查找给定位置附近的娱乐区和露营选项 | 存在问题 |
planParkVisit |
根据历史和预测天气推荐最佳访问时间 | 正常工作 |
getParkWeatherForecast |
通过公园代码获取详细的天气预报 | 正常工作 |
getCampgrounds |
列出国家公园内的露营地及其详细信息 | 正常工作 |
常见问题解答
- 连接 Claude Desktop 失败:通常是由于 Node 兼容性问题,建议使用 Node v18.20.4+ 版本
- 更多调试信息可参考 MCP 调试文档:https://modelcontextprotocol.io/docs/tools/debugging
使用教程
使用依赖
- Cloudflare 账户(已启用 Workers 和 KV)
- Node.js v18.20.4+ 和 npm
- 以下 API 的密钥:
- National Park Service API
- Recreation.gov API
- Weather API (如 weatherapi.com)
安装教程
- 克隆仓库
git clone https://github.com/Kyle-Ski/nps-explorer-mcp-server.git
cd nps-explorer-mcp-server
- 复制并填写
.dev.vars
文件
cp .dev.vars.example .dev.vars
然后编辑 .dev.vars
文件,填入您的 API 密钥
- 安装依赖
npm i
- 本地运行
npm start
部署
使用 Wrangler 部署到 Cloudflare Workers
npm run deploy
调试方式
使用 MCP Server Inspector Tool 测试服务器连接
npx @modelcontextprotocol/inspector