NPS MCP Server
NPS MCP Server
Сервер Model Context Protocol (MCP), который предоставляет Claude (или любому другому AI-клиенту, совместимому с MCP) доступ к API Службы национальных парков (NPS). Задавайте вопросы о парках, оповещениях, кемпингах, мероприятиях, парковках и многом другом — и все это на естественном языке.
Предварительные требования
Python 3.11+
API-ключ NPS — бесплатно, можно получить на сайте https://www.nps.gov/subjects/developer/get-started.htm
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
Откройте файл конфигурации Claude Desktop:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Добавьте этот блок внутри объекта
"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 — ключ передается напрямую.
Перезапустите 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Это откроет веб-интерфейс, где вы сможете вызывать каждый инструмент вручную и проверять ответы.
Доступные инструменты
Инструмент | Описание |
| Список всех кодов парков и полных названий, известных этому серверу |
| Поиск парков по названию или ключевому слову, с возможностью фильтрации по штату |
| Получение полной информации о конкретном парке по коду |
| Текущие закрытия, опасности и уведомления для парка |
| Часы работы центров для посетителей и контактная информация |
| Вместимость парковок, доступность и текущая заполняемость |
| Информация о кемпингах, сборах и бронировании |
| Предстоящие программы рейнджеров и мероприятия в парках |
| Рекомендуемые виды деятельности (пешие прогулки, рыбалка, наблюдение за звездами и т. д.) |
| Экскурсии с гидом, доступные в парке |
| Прямые трансляции с веб-камер |
| Информация о входных билетах и пропусках |
| Последние пресс-релизы парка |
| Перекрытия дорог и зоны дорожных работ |
| Известные достопримечательности и места в парке |
| Исторические личности и защитники природы, связанные с парком |
| Образовательные статьи, опубликованные парком |
| Планы уроков для учителей, связанные с парком |
| Где собрать штампы паспорта национального парка |
| Просмотр всех категорий деятельности в NPS |
| Просмотр всех тематических категорий (история, геология и т. д.) |
Известные коды парков
Все 63 официально назначенных национальных парка США предварительно добавлены в базу. Для любого другого объекта NPS (памятники, морские побережья, зоны отдыха и т. д.) используйте search_parks, чтобы найти его код.
Северо-Восток
Код | Парк |
| Национальный парк Акадия |
| Национальный парк и заповедник Нью-Ривер-Гордж |
| Национальный парк Шенандоа |
| Национальный парк Виргинских островов |
Юго-Восток
Код | Парк |
| Национальный парк Бискейн |
| Национальный парк Конгари |
| Национальный парк Драй-Тортугас |
| Национальный парк Эверглейдс |
| Национальный парк Грейт-Смоки-Маунтинс |
| Национальный парк Хот-Спрингс |
| Национальный парк Мамонтова пещера |
Средний Запад
Код | Парк |
| Национальный парк Кайахога-Вэлли |
| Национальный парк Индиана-Дюнс |
| Национальный парк Айл-Ройал |
| Национальный парк Гейтуэй-Арч |
| Национальный парк Вояжеры |
Великие равнины
Код | Парк |
| Национальный парк Бэдлендс |
| Национальный парк Теодор Рузвельт |
| Национальный парк Уинд-Кейв |
Скалистые горы
Код | Парк |
| Национальный парк Блэк-Каньон-оф-те-Ганнисон |
| Национальный парк Брайс-Каньон |
| Национальный парк Каньонлендс |
| Национальный парк Кэпитол-Риф |
| Национальный парк и заповедник Грейт-Санд-Дюнс |
| Национальный парк Гранд-Титон |
| Национальный парк Меса-Верде |
| Национальный парк Роки-Маунтин |
| Национальный парк Йеллоустон |
| Национальный парк Зайон |
Юго-Запад
Код | Парк |
| Национальный парк Арчес |
| Национальный парк Биг-Бенд |
| Национальный парк Карлсбадские пещеры |
| Национальный парк Долина Смерти |
| Национальный парк Гранд-Каньон |
| Национальный парк Грейт-Бейсин |
| Национальный парк Гуадалупе-Маунтинс |
| Национальный парк Петрифайд-Форест |
| Национальный парк Сагуаро |
| Национальный парк Уайт-Сэндс |
Калифорния
Код | Парк |
| Национальный парк Чаннел-Айлендс |
| Национальный парк Джошуа-Три |
| Национальный парк Кингс-Каньон |
| Национальный парк Лассен-Волканик |
| Национальный парк Пиннаклс |
| Национальный парк и парки штата Редвуд |
| Национальный парк Секвойя |
| Национальный парк Йосемити |
Тихоокеанский Северо-Запад
Код | Парк |
| Национальный парк Крейтер-Лейк |
| Национальный парк Маунт-Рейнир |
| Национальный парк Норт-Каскейдс |
| Национальный парк Олимпик |
Гавайи
Код | Парк |
| Национальный парк Халеакала |
| Национальный парк Гавайские вулканы |
Аляска
Код | Парк |
| Национальный парк и заповедник Денали |
| Национальный парк и заповедник Гейтс-оф-те-Арктик |
| Национальный парк и заповедник Глейшер-Бей |
| Национальный парк и заповедник Катмай |
| Национальный парк Кенай-Фьордс |
| Национальный парк Кобук-Вэлли |
| Национальный парк и заповедник Лейк-Кларк |
| Национальный парк и заповедник Рангел-Сент-Элайас |
Другое
Код | Парк |
| Национальный парк Глейшер (Монтана) |
| Национальный парк Американского Самоа |
Примеры запросов
После подключения к Claude попробуйте спросить:
"Какие сейчас оповещения в Йеллоустоне?"
"Найди кемпинги в национальном парке Йосемити."
"Какова стоимость входных билетов в Гранд-Каньон?"
"Покажи мне парковки в Йеллоустоне и их текущую заполняемость."
"Есть ли перекрытия дорог в национальном парке Глейшер?"
"Какие мероприятия проходят в Акадии на этой неделе?"
"Что можно сделать в национальном парке Зайон?"
"Найди национальные парки в Юте."
Лицензия
Этот проект является открытым исходным кодом. API NPS — это бесплатная государственная услуга, предоставляемая Службой национальных парков США.
This server cannot be deployed
Maintenance
Related MCP Connectors
Plan US National Park Service trips — parks, alerts, campgrounds, things to do, events.
NPS MCP — US National Park Service (free key, generous limits)
Recreation.gov MCP — wraps the Recreation Information Database (RIDB) API v1
Provide real-time and forecast weather information for locations in the United States using natura…
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceFacilitates 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 npm3MIT
- AlicenseBqualityDmaintenanceProvides 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.6142 npm41MIT
- AlicenseNot gradedqualityDmaintenanceProvides access to the National Park Service API to search for U.S. national parks, view park details, check alerts and closures, find visitor centers, campgrounds, and upcoming events.142 npmMIT
- AlicenseNot gradedqualityDmaintenanceProvides 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.3MIT