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"
      ]
    }
  }
}

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

1. YOUR_EBIRD_API_KEY実際のeBird APIキーに置き換えてください。

2. 設定ファイルが存在しない場合は作成する

3. まだインストールしていない場合はnpm install -g ebird-mcp-serverでパッケージをグローバルにインストールします。

4. 変更を保存した後、Claude Desktopを再起動します。

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

Related MCP server: MCP Boilerplate

特徴

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

• 地域における最近の鳥類観察

• 特定の鳥類の最近の観察

• 地域における注目すべき鳥類の観察

• 場所の近くでの観察

• 場所の近くで注目すべき観察

• 地域のバードウォッチングのホットスポット

• 場所の近くのホットスポット

• eBird分類情報

前提条件

• Node.js (v14以降)

• eBird API キー ( eBird API キー リクエストから取得)

インストール

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

1. このリポジトリをクローンするか、ファイルをダウンロードしてください

2. Claude Desktop セットアップ スクリプトを実行します。

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

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

その他の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

ライセンス

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

謝辞

• APIを提供してくれたeBird

• 鳥類保護に関する研究に対してコーネル大学鳥類学研究所

• API統合フレームワークのモデルコンテキストプロトコル