eBird MCP Server

结合eBird与AI：构建个人鸟类观察助手

本项目将eBird API与MCP（模型上下文协议）服务器集成，使您能够通过自然语言查询鸟类观察数据，直接在Claude聊天窗口内进行。

开始使用

预备条件

• eBird API密钥：创建一个eBird账户并请求API密钥。
• Claude桌面应用：下载并安装Claude桌面应用程序。
• 安装Python（参见此tutorial）。

安装

克隆仓库

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

安装依赖项

pip install -r requirements.txt

配置

配置Claude桌面应用

1. 打开Claude桌面应用。
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

保存配置后，重启Claude桌面应用。它会自动启动并管理MCP服务器。

使用方法

在Claude中打开一个聊天，并使用示例提示（或您自己的提示）来查询eBird数据。

功能

这里是一些您可以使用的查询示例。AI将决定何时调用eBird MCP服务器，或者您可以明确指示其这样做。

观察记录

查询地点的最近观察记录

最近在嘉义布袋有哪些鸟类被观察到？

查询物种的最近观察记录

台南最近有黑面琵鹭的记录吗？

查询罕见（稀有）观察记录

最近在新竹有哪些稀有鸟类被报告？

检查清单

顶级贡献者

列出2025年6月26日在台北的前100名eBird贡献者。

特定日期的所有检查清单

显示2024年6月15日在高雄提交的所有检查清单。

最近的检查清单

提供台南最近提交的检查清单。

总结统计

汇总2024年6月20日在新北的所有观察检查清单。

检查清单详情

显示检查清单ID S12345678的详细信息。

热点

列出地点的热点

列出台南的所有eBird热点。

附近的热点

列出距离当前位置5公里内的观鸟热点。

分类学

官方分类学

提供黑面琵鹭的eBird分类学数据。

列出亚种

列出所有白胸苦恶鸟的亚种。

许可证

本项目采用MIT许可证。