Skip to main content
Glama
AniruddhaShukla

NPS MCP Server

NPS MCP サーバー

Model Context Protocol (MCP) サーバーであり、Claude(またはMCP互換のAIクライアント)から国立公園局(NPS)APIへのアクセスを可能にします。公園、アラート、キャンプ場、イベント、駐車場などについて、すべて自然言語で質問できます。


前提条件


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

これによりブラウザUIが開き、各ツールを手動で呼び出してレスポンスを確認できます。


利用可能なツール

ツール

説明

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に接続したら、以下のように質問してみてください:

  • "イエローストーンの現在のアラートは何ですか?"

  • "ヨセミテ国立公園のキャンプ場を探して。"

  • "グランドキャニオンの入園料はいくらですか?"

  • "イエローストーンの駐車場と現在の混雑状況を教えて。"

  • "グレーシャー国立公園で道路閉鎖はありますか?"

  • "今週アカディアでどんなイベントがありますか?"

  • "ザイオン国立公園では何ができますか?"

  • "ユタ州にある国立公園を探して。"


ライセンス

このプロジェクトはオープンソースです。NPS APIは、米国国立公園局が提供する無料の公共サービスです。

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