用途
mcp-server-nationalparks 是一个 MCP(Model Context Protocol)服务器,封装了美国国家公园管理局(NPS)API,用于向 AI 助手提供美国国家公园的实时信息。它适合需要查询公园详情、当前警报、游客中心、露营地和活动的场景。
主要能力
该服务器提供以下工具:
- findParks:根据多种条件搜索国家公园。输入包括 stateCode(可选,州代码,如 "CA",多个州可用逗号分隔,如 "CA,OR,WA")、q(可选,按名称或描述搜索的关键词)、limit(可选,返回数量上限,默认 10,最大 50)、start(可选,分页起始位置)、activities(可选,按活动筛选,如 "hiking,camping")。返回匹配的公园及其详细信息。
- getParkDetails:获取特定国家公园的全面信息。输入 parkCode(字符串,公园代码,如 "yose" 代表优胜美地,"grca" 代表大峡谷)。返回包括描述、开放时间、费用、联系方式和活动在内的详细公园信息。
- getAlerts:获取国家公园的当前警报,包括关闭、危险和重要信息。输入包括 parkCode(可选,按公园代码筛选,多个公园可用逗号分隔,如 "yose,grca")、limit(可选,默认 10,最大 50)、start(可选,分页起始位置)、q(可选,按标题或描述搜索)。返回按公园组织的当前警报。
- getVisitorCenters:获取游客中心及其运营时间信息。输入包括 parkCode(可选,多个公园可用逗号分隔)、limit(可选,默认 10,最大 50)、start(可选,分页起始位置)、q(可选,按名称或描述搜索)。返回游客中心的位置、时间和联系方式。
- getCampgrounds:获取可用露营地及其设施信息。输入包括 parkCode(可选,多个公园可用逗号分隔)、limit(可选,默认 10,最大 50)、start(可选,分页起始位置)、q(可选,按名称或描述搜索)。返回露营地的设施、费用和预订详情。
- getEvents:查找公园即将举办的活动。输入包括 parkCode(可选,多个公园可用逗号分隔)、limit(可选,默认 10,最大 50)、start(可选,分页起始位置)、dateStart(可选,筛选活动的开始日期,格式 YYYY-MM-DD)、dateEnd(可选,筛选活动的结束日期,格式 YYYY-MM-DD)、q(可选,按标题或描述搜索)。返回活动的日期、时间和描述。
使用方式
- 从国家公园管理局开发者门户获取免费 API 密钥,并安全存储,用于请求认证。
- 可通过 Smithery 自动安装到 Claude Desktop。
- 在 Claude Desktop 中使用时,将相应配置添加到 claude_desktop_config.json。
典型使用场景包括:查找某州的公园、获取特定公园的详情、检查警报或关闭情况、查找游客中心、寻找露营地、查找即将举办的活动、根据活动规划旅行。
适用场景
- 旅行规划:根据州、活动或关键词搜索公园,并获取开放时间、费用和联系方式。
- 实时信息查询:获取公园的当前警报、关闭和危险信息。
- 设施查询:查找游客中心、露营地的位置、时间、设施和预订详情。
- 活动发现:按日期范围查找公园活动。
限制
- 需要 NPS API 密钥才能使用。
- 数据来源于 NPS API,仅覆盖美国国家公园相关数据。
- 项目采用 MIT 许可证,详见 LICENSE 文件。
- 附录中列出了热门国家公园及其代码,完整列表可访问 NPS 网站。