eBird MCP サーバー

eBird APIと統合するためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、ClaudeのようなAIアシスタントはeBirdから鳥類観察データ、ホットスポット、分類情報にアクセスできるようになります。

Claudeデスクトップのクイックセットアップ

この構成を 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"
      ]
    }
  }
}

必ず次の点に注意してください:

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

注: eBird APIキーはeBird APIキーリクエストから取得できます。

特徴

eBird MCP サーバーは、次の eBird データへのアクセスを提供します。

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

前提条件

Node.js (v14以降)
eBird API キー ( eBird API キーリクエストから取得)

インストール

クロードデスクトップ向け

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

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

Claudeデスクトップを再起動します

その他のMCPクライアント向け

このリポジトリをクローンするか、ファイルをダウンロードしてください
インストールスクリプトを実行します。

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

これでサーバーがインストールされ、次のコマンドで実行できます。

./run-ebird-mcp-server.sh

手動インストール

このリポジトリをクローンするか、ファイルをダウンロードしてください
依存関係をインストールします:

npm install

サーバーを実行します。

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

ライセンス

マサチューセッツ工科大学

謝辞

APIを提供してくれたeBird
鳥類保護に関する研究に対してコーネル大学鳥類学研究所
API統合フレームワークのモデルコンテキストプロトコル

eBird MCP Server

Integrations