NPS Explorer MCP Server 🔭

NPS Explorer MCP Server 🔭

site icon
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

使用教程

使用依赖

  1. Cloudflare 账户(已启用 Workers 和 KV)
  2. Node.js v18.20.4+ 和 npm
  3. 以下 API 的密钥:
  4. National Park Service API
  5. Recreation.gov API
  6. Weather API (如 weatherapi.com)

安装教程

  1. 克隆仓库
git clone https://github.com/Kyle-Ski/nps-explorer-mcp-server.git
cd nps-explorer-mcp-server
  1. 复制并填写 .dev.vars 文件
cp .dev.vars.example .dev.vars

然后编辑 .dev.vars 文件,填入您的 API 密钥

  1. 安装依赖
npm i
  1. 本地运行
npm start

部署

使用 Wrangler 部署到 Cloudflare Workers

npm run deploy

调试方式

使用 MCP Server Inspector Tool 测试服务器连接

npx @modelcontextprotocol/inspector

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。