eBird MCP Server

eBird MCP Server

eBird API と連携するための Model Context Protocol（MCP）サーバーです。このサーバーを使うと、Claude などの AI アシスタントが eBird の野鳥観察データ、ホットスポット、分類情報にアクセスできます。

Claude Desktop のクイックセットアップ

この設定を Claude Desktop の設定ファイル（~/Library/Application Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "ebird-api": {
      "command": "npx",
      "args": [
        "ebird-mcp-server",
        "--api-key",
        "YOUR_EBIRD_API_KEY"
      ]
    }
  }
}

次の点を確認してください。

1. YOUR_EBIRD_API_KEY を実際の eBird API キーに置き換えます
2. 設定ファイルが存在しない場合は作成します
3. まだインストールしていない場合は、npm install -g ebird-mcp-server でパッケージをグローバルにインストールします
4. 変更を保存した後、Claude Desktop を再起動します

注：eBird API キーは eBird API キーの申請 から取得できます。

機能

eBird MCP サーバーでは、次の eBird データにアクセスできます。

• 地域の最近の野鳥観察情報
• 特定の野鳥種の最近の観察情報
• 地域の注目すべき野鳥観察情報
• 場所の近くでの観察情報
• 場所の近くでの注目すべき観察情報
• 地域のバードウォッチング用ホットスポット
• 場所の近くのホットスポット
• eBird の分類情報

前提条件

• Node.js（v14 以降）
• eBird API キー（eBird API キーの申請 から取得できます）

インストール

Claude Desktop の場合

1. このリポジトリをクローンするか、ファイルをダウンロードします
2. Claude Desktop のセットアップスクリプトを実行します。

chmod +x claude_setup.sh
./claude_setup.sh YOUR_EBIRD_API_KEY

3. Claude Desktop を再起動します

その他の MCP クライアントの場合

1. このリポジトリをクローンするか、ファイルをダウンロードします
2. インストールスクリプトを実行します。

chmod +x install.sh
./install.sh YOUR_EBIRD_API_KEY

3. サーバーがインストールされ、次のコマンドで実行できるようになります。

./run-ebird-mcp-server.sh

手動インストール

1. このリポジトリをクローンするか、ファイルをダウンロードします
2. 依存関係をインストールします。

npm install

3. サーバーを実行します。

node index.js --api-key YOUR_EBIRD_API_KEY

利用可能なツール

ebird_get_recent_observations

地域または場所の最近の野鳥観察情報を取得します。

パラメーター：

• regionCode（必須）：地域コード（例：US、US-NY、L123456）
• back：観察情報を検索する過去の日数（デフォルト：14）
• maxResults：返す結果の最大数（デフォルト：100）
• includeProvisional：暫定的な観察情報を含めるかどうか（デフォルト：true）
• hotspot：ホットスポットからの観察情報のみを含めるかどうか（デフォルト：false）
• detail：結果の詳細レベル（'simple' または 'full'、デフォルト：'simple'）

ebird_get_recent_observations_for_species

地域内における特定の野鳥種の最近の観察情報を取得します。

パラメーター：

• regionCode（必須）：地域コード（例：US、US-NY、L123456）
• speciesCode（必須）：eBird の種コード（例：アメリカガラスの場合は amecro）
• back：観察情報を検索する過去の日数（デフォルト：14）
• maxResults：返す結果の最大数（デフォルト：100）
• includeProvisional：暫定的な観察情報を含めるかどうか（デフォルト：true）
• hotspot：ホットスポットからの観察情報のみを含めるかどうか（デフォルト：false）

ebird_get_notable_observations

地域の注目すべき野鳥観察情報を取得します。

パラメーター：

• regionCode（必須）：地域コード（例：US、US-NY、L123456）
• back：観察情報を検索する過去の日数（デフォルト：14）
• maxResults：返す結果の最大数（デフォルト：100）
• detail：結果の詳細レベル（'simple' または 'full'、デフォルト：'simple'）

ebird_get_nearby_observations

場所の近くでの最近の野鳥観察情報を取得します。

パラメーター：

• lat（必須）：緯度座標
• lng（必須）：経度座標
• dist：緯度・経度で指定した地点からの距離（キロメートル、デフォルト：25）
• back：観察情報を検索する過去の日数（デフォルト：14）
• maxResults：返す結果の最大数（デフォルト：100）
• includeProvisional：暫定的な観察情報を含めるかどうか（デフォルト：true）
• hotspot：ホットスポットからの観察情報のみを含めるかどうか（デフォルト：false）
• detail：結果の詳細レベル（'simple' または 'full'、デフォルト：'simple'）

ebird_get_nearby_notable_observations

場所の近くで報告された注目すべき鳥の観察情報を取得します。

パラメーター：

• lat（必須）：緯度座標
• lng（必須）：経度座標
• dist：緯度・経度の地点からの距離（キロメートル単位。デフォルト：25）
• back：観察情報を検索する過去の日数（デフォルト：14）
• maxResults：返す結果の最大数（デフォルト：100）
• detail：結果の詳細レベル（'simple' または 'full'、デフォルト：'simple'）

ebird_get_nearby_observations_for_species

場所の近くで報告された特定の鳥種の最近の観察情報を取得します。

パラメーター：

• lat（必須）：緯度座標
• lng（必須）：経度座標
• speciesCode（必須）：eBird の種コード（例：アメリカガラスの場合は amecro）
• dist：緯度・経度の地点からの距離（キロメートル単位。デフォルト：25）
• back：観察情報を検索する過去の日数（デフォルト：14）
• maxResults：返す結果の最大数（デフォルト：100）
• includeProvisional：暫定的な観察情報を含めるかどうか（デフォルト：true）

ebird_get_hotspots

地域内のバードウォッチングのホットスポットを取得します。

パラメーター：

• regionCode（必須）：地域コード（例：US、US-NY）
• back：ホットスポットの活動を検索する過去の日数（デフォルト：14）
• includeProvisional：暫定的な観察情報を含めるかどうか（デフォルト：true）

ebird_get_nearby_hotspots

場所の近くにあるバードウォッチングのホットスポットを取得します。

パラメーター：

• lat（必須）：緯度座標
• lng（必須）：経度座標
• dist：緯度・経度の地点からの距離（キロメートル単位。デフォルト：25）
• back：ホットスポットの活動を検索する過去の日数（デフォルト：14）
• includeProvisional：暫定的な観察情報を含めるかどうか（デフォルト：true）

ebird_get_taxonomy

eBird の分類情報を取得します。

パラメーター：

• locale：一般名の言語（デフォルト：'en'）
• cat：絞り込む分類カテゴリー（デフォルト：'species'）
• fmt：レスポンスの形式（デフォルト：'json'）

ebird_get_taxonomy_forms

特定の種の eBird 分類フォームを取得します。

パラメーター：

• speciesCode（必須）：eBird の種コード

テスト

eBird MCP サーバーをテストするには、eBird API キーを環境変数として設定し、テストスクリプトを実行します。

export EBIRD_API_KEY=your_api_key
node test-ebird.js

デバッグモード

デバッグモードを有効にして、詳細なログを確認するには：

node index.js --api-key YOUR_EBIRD_API_KEY --debug

ライセンス

MIT

謝辞

• API を提供している eBird に感謝します
• 鳥類保護に関する取り組みを行っている Cornell Lab of Ornithology に感謝します
• API 統合フレームワークを提供している Model Context Protocol に感謝します