Skip to main content
Glama
AniruddhaShukla

NPS MCP Server

NPS MCP Server

Сервер Model Context Protocol (MCP), который предоставляет Claude (или любому другому AI-клиенту, совместимому с MCP) доступ к API Службы национальных парков (NPS). Задавайте вопросы о парках, оповещениях, кемпингах, мероприятиях, парковках и многом другом — и все это на естественном языке.


Предварительные требования


Related MCP server: National Parks MCP Server

Установка

# 1. Clone the repository
git clone https://github.com/AniruddhaShukla/nps-mcp.git
cd nps-mcp

# 2. Create and activate a virtual environment
python3 -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# 3. Install dependencies
pip install -r requirements.txt

Конфигурация

# Copy the example env file
cp .env.example .env

# Open .env and replace the placeholder with your real API key
# NPS_API_KEY=your_api_key_here

Ваш файл .env указан в .gitignore и никогда не будет зафиксирован в системе контроля версий.


Запуск сервера

python server.py

Сервер взаимодействует через stdio (стандартный транспорт MCP) и продолжает работать до тех пор, пока вы его не остановите. Вы не взаимодействуете с ним напрямую — это делает ваш MCP-клиент.


Подключение к Claude Desktop

  1. Откройте файл конфигурации Claude Desktop:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Добавьте этот блок внутри объекта "mcpServers" (создайте объект, если он еще не существует):

{
  "mcpServers": {
    "national-parks": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": ["/absolute/path/to/nps-mcp/server.py"],
      "env": {
        "NPS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Замените пути на фактические абсолютные пути на вашем компьютере. Использование блока env здесь означает, что вам даже не нужен файл .env — ключ передается напрямую.

  1. Перезапустите Claude Desktop. Чтобы убедиться, что все работает, нажмите на значок скрепки / вложения в строке ввода чата, затем выберите Connectors — вы должны увидеть national-parks в списке с синим переключателем, указывающим на то, что он запущен. Оттуда вы можете включать или отключать его для каждого диалога.


Подключение к Claude Code

claude mcp add national-parks -- /absolute/path/to/.venv/bin/python /absolute/path/to/nps-mcp/server.py

Затем установите переменную окружения в вашей оболочке перед запуском Claude Code:

export NPS_API_KEY=your_api_key_here
claude

Тестирование с помощью MCP Inspector

npx @modelcontextprotocol/inspector python server.py

Это откроет веб-интерфейс, где вы сможете вызывать каждый инструмент вручную и проверять ответы.


Доступные инструменты

Инструмент

Описание

list_known_parks

Список всех кодов парков и полных названий, известных этому серверу

search_parks

Поиск парков по названию или ключевому слову, с возможностью фильтрации по штату

get_park

Получение полной информации о конкретном парке по коду

get_park_alerts

Текущие закрытия, опасности и уведомления для парка

get_visitor_centers

Часы работы центров для посетителей и контактная информация

get_parking_lots

Вместимость парковок, доступность и текущая заполняемость

get_campgrounds

Информация о кемпингах, сборах и бронировании

get_events

Предстоящие программы рейнджеров и мероприятия в парках

get_things_to_do

Рекомендуемые виды деятельности (пешие прогулки, рыбалка, наблюдение за звездами и т. д.)

get_tours

Экскурсии с гидом, доступные в парке

get_webcams

Прямые трансляции с веб-камер

get_fees_passes

Информация о входных билетах и пропусках

get_news_releases

Последние пресс-релизы парка

get_road_events

Перекрытия дорог и зоны дорожных работ

get_places

Известные достопримечательности и места в парке

get_people

Исторические личности и защитники природы, связанные с парком

get_articles

Образовательные статьи, опубликованные парком

get_lesson_plans

Планы уроков для учителей, связанные с парком

get_passport_stamp_locations

Где собрать штампы паспорта национального парка

get_activities

Просмотр всех категорий деятельности в NPS

get_topics

Просмотр всех тематических категорий (история, геология и т. д.)


Известные коды парков

Все 63 официально назначенных национальных парка США предварительно добавлены в базу. Для любого другого объекта NPS (памятники, морские побережья, зоны отдыха и т. д.) используйте search_parks, чтобы найти его код.

Северо-Восток

Код

Парк

acad

Национальный парк Акадия

neri

Национальный парк и заповедник Нью-Ривер-Гордж

shen

Национальный парк Шенандоа

viis

Национальный парк Виргинских островов

Юго-Восток

Код

Парк

bisc

Национальный парк Бискейн

cong

Национальный парк Конгари

drto

Национальный парк Драй-Тортугас

ever

Национальный парк Эверглейдс

grsm

Национальный парк Грейт-Смоки-Маунтинс

hosp

Национальный парк Хот-Спрингс

maca

Национальный парк Мамонтова пещера

Средний Запад

Код

Парк

cuva

Национальный парк Кайахога-Вэлли

indu

Национальный парк Индиана-Дюнс

isro

Национальный парк Айл-Ройал

jeff

Национальный парк Гейтуэй-Арч

voya

Национальный парк Вояжеры

Великие равнины

Код

Парк

badl

Национальный парк Бэдлендс

thro

Национальный парк Теодор Рузвельт

wica

Национальный парк Уинд-Кейв

Скалистые горы

Код

Парк

blca

Национальный парк Блэк-Каньон-оф-те-Ганнисон

brca

Национальный парк Брайс-Каньон

cany

Национальный парк Каньонлендс

care

Национальный парк Кэпитол-Риф

grsa

Национальный парк и заповедник Грейт-Санд-Дюнс

grte

Национальный парк Гранд-Титон

meve

Национальный парк Меса-Верде

romo

Национальный парк Роки-Маунтин

yell

Национальный парк Йеллоустон

zion

Национальный парк Зайон

Юго-Запад

Код

Парк

arch

Национальный парк Арчес

bibe

Национальный парк Биг-Бенд

cave

Национальный парк Карлсбадские пещеры

deva

Национальный парк Долина Смерти

grca

Национальный парк Гранд-Каньон

grba

Национальный парк Грейт-Бейсин

gumo

Национальный парк Гуадалупе-Маунтинс

pefo

Национальный парк Петрифайд-Форест

sagu

Национальный парк Сагуаро

whsa

Национальный парк Уайт-Сэндс

Калифорния

Код

Парк

chis

Национальный парк Чаннел-Айлендс

jotr

Национальный парк Джошуа-Три

kica

Национальный парк Кингс-Каньон

lavo

Национальный парк Лассен-Волканик

pinn

Национальный парк Пиннаклс

redw

Национальный парк и парки штата Редвуд

sequ

Национальный парк Секвойя

yose

Национальный парк Йосемити

Тихоокеанский Северо-Запад

Код

Парк

crla

Национальный парк Крейтер-Лейк

mora

Национальный парк Маунт-Рейнир

noca

Национальный парк Норт-Каскейдс

olym

Национальный парк Олимпик

Гавайи

Код

Парк

hale

Национальный парк Халеакала

havo

Национальный парк Гавайские вулканы

Аляска

Код

Парк

dena

Национальный парк и заповедник Денали

gaar

Национальный парк и заповедник Гейтс-оф-те-Арктик

glba

Национальный парк и заповедник Глейшер-Бей

katm

Национальный парк и заповедник Катмай

kefj

Национальный парк Кенай-Фьордс

kova

Национальный парк Кобук-Вэлли

lacl

Национальный парк и заповедник Лейк-Кларк

wrst

Национальный парк и заповедник Рангел-Сент-Элайас

Другое

Код

Парк

glac

Национальный парк Глейшер (Монтана)

npsa

Национальный парк Американского Самоа


Примеры запросов

После подключения к Claude попробуйте спросить:

  • "Какие сейчас оповещения в Йеллоустоне?"

  • "Найди кемпинги в национальном парке Йосемити."

  • "Какова стоимость входных билетов в Гранд-Каньон?"

  • "Покажи мне парковки в Йеллоустоне и их текущую заполняемость."

  • "Есть ли перекрытия дорог в национальном парке Глейшер?"

  • "Какие мероприятия проходят в Акадии на этой неделе?"

  • "Что можно сделать в национальном парке Зайон?"

  • "Найди национальные парки в Юте."


Лицензия

Этот проект является открытым исходным кодом. API NPS — это бесплатная государственная услуга, предоставляемая Службой национальных парков США.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Facilitates retrieval of National Park Services data using the NPS API, allowing users to list national parks by state and access detailed information about specific parks.
    44,731 npm
    3
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    Provides real-time information about U.S. National Parks through the NPS API, enabling users to search parks, check details, alerts, visitor centers, campgrounds, and upcoming events.
    6
    142 npm
    41
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides LLM context on U.S. national parks by integrating National Park Service, Recreation.gov, and weather APIs, enabling queries about park info, trails, alerts, events, weather forecasts, and more via tool calls.
    3
    MIT