nps_mcp

🚀 国家公园服务数据的 MCP 服务器

本 MCP 服务器提供了一个便捷接口，用于检索国家公园服务 (NPS) 数据。用户可以轻松获取给定美国州份中的国家公园列表，还能查看特定国家公园的详细信息。它借助国家公园管理局 API 来获取所需数据。

🚀 快速开始

此 MCP 服务器可让你方便地获取国家公园服务数据。下面为你介绍具体的使用步骤。

✨ 主要特性

• 国家公园列表获取：能够获取给定美国州份中的国家公园列表。
• 公园详细信息查看：支持查看特定国家公园的详细信息。

📦 安装指南

要求

• Node.js（推荐 v18+）
• npm 或 yarn
• 有效的 NPS API 密钥（可在 https://www.nps.gov/subjects/developer/get-started.htm 获取）
• 安装了 Claude Desktop（用于运行 MCP 服务器）

设置步骤

1. 克隆此仓库：

   git clone <repository-url>
   cd <repository-folder>
   

2. 安装依赖项：

   npm install
   

3. 在根目录创建一个 .env 文件，并添加您的 NPS API 密钥：

   API_KEY=your_nps_api_key_here
   

💻 使用示例

运行服务器

启动 MCP 服务器

npm run build
node ./build/server.js

使用 Claude Desktop

1. 将此 MCP 服务器添加到 claude_desktop_config.json 中的 mcpServers 部分。

{
    "mcpServers": {
        "nps": {
            "command": "node",
            "args": [
                "/<Path to Server>/build/index.js"
            ],
            "env": {
                "API_KEY": "Your NPS API Key"
            }
        }
    }
}

2. 启动或重新启动 Claude Desktop。
3. 确保您的 MCP 服务器已识别并正在运行，方法是点击 Claude 聊天窗口底部的工具图标。
4. 使用 Claude 的界面查询国家公园服务数据。

📚 详细文档

API 接口

按州获取国家公园列表

• 工具名称：park-list
• 参数：
  • stateCode (字符串) – 两位美国州代码
• 响应示例：

[
  {
    "fullName": "黄石国家公园",
    "description": "美国的第一个国家公园。",
    "parkCode": "yell"
  }
]

获取国家公园的详细信息

• 工具名称：park-details
• 参数：
  • parkCode (字符串) – 国家公园查询代码
• 响应示例：

[
  {
    "fullName": "黄石国家公园",
    "description": "美国的第一个国家公园。",
    "states": "WY, MT, ID"
  }
]

提示

按州检索公园

• 提示名称：parks-by-state
• 参数：
  • stateCode (字符串)
• 示例：

请问美国 CA 州有哪些国家公园？

获取公园详情

• 提示名称：details-for-park
• 参数：
  • park (字符串)
• 示例：

给我黄石国家公园的详细信息。