鸟类观察助手

整合eBird API与MCP服务器,通过自然语言查询鸟类观察数据,构建个人鸟类观察助手。

  • by birdingkit
  • Python
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 siansiansu/ebird-mcp-server

使用说明

eBird MCP服务器

将eBird与AI相结合:构建您的个人鸟类观察助手

该项目将eBird API与MCP(模型上下文协议)服务器集成在一起,使您能够直接在Claude的聊天窗口中通过自然语言查询鸟类观察数据。

入门指南

先决条件

安装

克隆存储库

 git clone git@github.com:siansiansu/ebird-mcp-server.git
 cd ebird-mcp-server

安装依赖项

pip install -r requirements.txt

配置

配置Claude桌面

  1. 打开克劳德桌面。
  2. 导航到设置>开发人员>编辑配置>编辑 claude_desktop_config.json 文件。
  3. 将配置替换为您的路径和API密钥:
{
  "mcpServers": {
    "ebird-api": {
      "command": "/absolute/path/to/python",
      "args": [
        "/absolute/path/to/ebird-mcp-server/server.py"
      ],
      "env": {
        "EBIRD_API_KEY": "your-ebird-api-key"
      }
    }
  }
}

重要提示:

  • command:Python可执行文件的绝对路径。
  • args:绝对路径 server.py.
  • EBIRD_API_KEY:您的eBird API密钥。

重新启动克劳德

保存配置后,重新启动Claude Desktop应用程序。它将自动启动和管理MCP服务器。

用法

在Claude中打开聊天,使用任何示例提示(或您自己的)查询eBird数据。

特性

以下是可用于查询数据的示例提示。AI将决定何时调用eBird MCP服务器,或者您可以明确指示它这样做。

观察

查询某个位置的最近观察结果

What birds have been seen recently in Budai, Chiayi?

查询最近对一个物种的观察结果

Are there any recent records of Black-faced Spoonbill in Tainan?

查询显著(罕见)观察结果

What rare birds have been reported recently in Hsinchu?

检查清单

主要贡献者

List the top 100 eBird contributors in Taipei on June 26, 2025.

日期上的所有清单

Show all checklists submitted in Kaohsiung on June 15, 2024.

最近的检查表

Provide the latest checklists submitted in Tainan.

汇总统计

Summarize all observation checklists in New Taipei on June 20, 2024.

检查表详细信息

Show details for checklist ID S12345678.

热点

列出某个位置的热点

List all eBird hotspots in Tainan.

附近热点

List birding hotspots within 5 km of my current location.

分类学

官方分类

Provide the eBird taxonomy data for Black-faced Spoonbill.

列出亚种

List all subspecies of White-breasted Waterhen.

许可证

该项目根据MIT许可证获得许可。