eBird MCP 服务器

用于与 eBird API 集成的模型上下文协议 (MCP) 服务器。该服务器允许 Claude 等 AI 助手访问 eBird 中的鸟类观察数据、热点和分类信息。

Claude Desktop 的快速设置

将此配置添加到您的 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 ：结果的详细程度（“简单”或“完整”，默认值：“简单”）

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 ：结果的详细程度（“简单”或“完整”，默认值：“简单”）

ebird_get_nearby_observations

获取某个地点附近最近的鸟类观察结果。

参数：

• lat （必填）：纬度坐标

• lng （必填）：经度坐标

• dist ：距纬度/经度点的距离（以公里为单位）（默认值：25）

• back ：回顾观察的天数（默认值：14）

• maxResults ：返回的最大结果数（默认值：100）

• includeProvisional ：包括临时观察（默认值：true）

• hotspot ：仅包含热点的观察结果（默认值：false）

• detail ：结果的详细程度（“简单”或“完整”，默认值：“简单”）

ebird_get_nearby_notable_observations

获取某个地点附近值得注意的鸟类观察结果。

参数：

• lat （必填）：纬度坐标

• lng （必填）：经度坐标

• dist ：距纬度/经度点的距离（以公里为单位）（默认值：25）

• back ：回顾观察的天数（默认值：14）

• maxResults ：返回的最大结果数（默认值：100）

• detail ：结果的详细程度（“简单”或“完整”，默认值：“简单”）

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 ：要过滤的分类类别（默认值：'物种'）

• 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

执照

麻省理工学院

致谢

• eBird提供 API

• 康奈尔鸟类学实验室在鸟类保护方面的工作

• API 集成框架的模型上下文协议