eBird MCP Server

eBird MCP 服务

用于与 eBird API 集成的模型上下文协议（MCP）服务。该服务允许 AI 助手（如 Claude）访问 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 密钥

功能

eBird MCP 服务可访问以下 eBird 数据：

• 某个区域内近期的鸟类观测记录
• 某个鸟类物种的近期观测记录
• 某个区域内值得关注的鸟类观测记录
• 某个地点附近的观测记录
• 某个地点附近值得关注的观测记录
• 某个区域内的观鸟热点地点
• 某个地点附近的热点地点
• eBird 分类信息

先决条件

• Node.js（v14 或更高版本）
• eBird API 密钥（可通过 eBird API 密钥申请 获取）

安装

用于 Claude Desktop

1. 克隆此仓库或下载这些文件
2. 运行 Claude Desktop 设置脚本：

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

3. 重启 Claude Desktop

用于其他 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：距 lat/lng 坐标点的距离（公里，默认值：25）
• back：向前查询观测记录的天数（默认值：14）
• maxResults：返回结果的最大数量（默认值：100）
• includeProvisional：是否包含暂定观测记录（默认值：true）
• hotspot：是否仅包含来自热点地点的观测记录（默认值：false）
• detail：结果的详细程度（'simple' 或 'full'，默认值：'simple'）

ebird_get_nearby_notable_observations

获取某个地点附近值得关注的鸟类观测记录。

参数：

• lat（必填）：纬度坐标
• lng（必填）：经度坐标
• dist：距 lat/lng 坐标点的距离（公里）（默认值：25）
• back：回溯观测记录的天数（默认值：14）
• maxResults：要返回的结果数量上限（默认值：100）
• detail：结果的详细程度（'simple' 或 'full'，默认值：'simple'）

ebird_get_nearby_observations_for_species

获取某个地点附近特定鸟类的近期观测记录。

参数：

• lat（必填）：纬度坐标
• lng（必填）：经度坐标
• speciesCode（必填）：eBird 物种代码（例如，American Crow 的代码为 amecro）
• dist：距 lat/lng 坐标点的距离（公里）（默认值：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：距 lat/lng 坐标点的距离（公里）（默认值：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

许可证

MIT

致谢

• 感谢 eBird 提供 API
• 感谢 康奈尔鸟类学实验室 在鸟类保护方面所做的工作
• 感谢 模型上下文协议 提供 API 集成框架