跳至主要内容

1 篇文章 含有標籤「eBird」

檢視所有標籤

結合 eBird 與 AI:使用 MCP Server 打造個人鳥類資料助理

· 閱讀時間約 3 分鐘

demo

這是一個結合 eBird 與 Model Context Protocol (MCP) Server 的工具,讓使用者可以透過自然語言,直接在 Claude 的對話視窗中查詢鳥類觀測資料。

功能特色

本工具目前支援以下的功能:

  • 觀測資料 (Observations)
    • 查詢特定地區的近期鳥類觀測紀錄。
    • 查詢特定地區、特定鳥種的近期觀測紀錄。
    • 查詢特定地區的近期稀有鳥種(Notable)觀測紀錄。
    • 查詢座標附近的鳥類觀測紀錄。
    • 查詢座標附近的稀有鳥種觀測紀錄。
    • 查詢座標附近、特定鳥種的觀測紀錄。
  • 賞鳥紀錄 (Checklists)
    • 查詢特定賞鳥紀錄(Checklist)的詳細內容。
  • 熱點與物種 (Hotspots & Taxonomy)
    • 查詢特定地區的賞鳥熱點(Hotspots)。
    • 查詢座標附近的賞鳥熱點。
    • 查詢 eBird 的官方鳥類分類名錄。
    • 查詢特定物種的所有可識別亞種(Taxonomy Forms)。

前置準備

在開始之前,請完成以下準備工作。

1. 取得 eBird API 金鑰

您必須擁有一個 eBird 帳號,並前往以下網址申請 API 金鑰:

https://ebird.org/api/keygen

申請完成後,請將您的金鑰複製下來,稍後會用到。

2. 安裝 Claude 桌面應用程式

本工具需要搭配 Claude 桌面應用程式使用。請至官網下載並安裝:

https://claude.ai/download

安裝完成後,登入您的 Claude 帳號。

3. 安裝 Python

請參考給自學者的Python教學(0) : 如何安裝Python(Mac/Windows)

安裝與執行

1. 設定 Python 環境

# Clone 專案或點選下方連結手動下載
git clone git@github.com:siansiansu/ebird-mcp-server.git

# 進入專案目錄
cd /path/to/ebird-mcp-server

# 安裝專案依賴套件
pip install -r requirements.txt

2. 設定 Claude 桌面應用程式

  1. 打開 Claude 桌面應用程式。

  2. 將滑鼠移到導覽列,點選 Settings

image

  1. 找到 Developer 區塊,點擊 Edit Config,修改 claude_desktop_config.json 檔案。
  2. 將以下 JSON 內容貼入,並替換成您自己的設定:
{
"mcpServers": {
"ebird-api": {
"command": "/path/to/ebird-mcp-server/.venv/bin/python",
"args": [
"/path/to/Workspace/ebird-mcp-server/server.py"
],
"env": {
"EBIRD_API_KEY": "你的 eBird API 金鑰"
}
}
}
}

image

請務必修改以下路徑與金鑰

  • command: python 執行檔絕對路徑。
  • args: server.py 的絕對路徑。
  • EBIRD_API_KEY: 您在第一步取得的 eBird API 金鑰。

3. 執行 MCP Server

設定完成後重新啟動 Claude 桌面版,Claude 會自動啟動並管理這個 MCP Server。

進入先前的設定頁面可以看到關於 eBird MCP Server 的設定。

之後回到聊天頁面就可以使用囉!