eBird MCP 服务器

一个用于与 eBird API 集成的 Model Context Protocol (MCP) 服务器。该服务器允许像 Claude 这样的 AI 助手访问来自 eBird 的鸟类观察数据、热点和分类信息。

Claude 桌面版快速设置

将以下配置添加到您的 Claude 桌面配置文件中（~/Library/Application Support/Claude/claude_desktop_config.json）：

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 Key Request 获取 eBird API 密钥

功能

eBird MCP 服务器提供对以下 eBird 数据的访问：

• 区域内的最近鸟类观察记录
• 特定鸟类物种的最近观察记录
• 区域内的显著鸟类观察记录
• 附近位置的观察记录
• 附近位置的显著观察记录
• 区域内的观鸟热点
• 附近位置的观鸟热点
• eBird 分类信息

前提条件

• Node.js (v14 或更高版本)
• eBird API 密钥（从 eBird API Key Request 获取）

安装

对于 Claude 桌面版

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

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

1. 重启 Claude Desktop

对于其他 MCP 客户端

1. 克隆此仓库或下载文件
2. 运行安装脚本：

bash
chmod +x install.sh
./install.sh YOUR_EBIRD_API_KEY

1. 现在已安装服务器，可以使用以下命令运行：

bash
./run-ebird-mcp-server.sh

手动安装

1. 克隆此仓库或下载文件
2. 安装依赖项：

bash
npm install

1. 运行服务器：

bash
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：从经纬度点起的距离（公里，默认：25）
• back：回溯天数以查找观察记录（默认：14）
• maxResults：返回的最大结果数量（默认：100）
• detail：结果的详细程度（simple 或 full，默认：simple）

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：按分类类别过滤（默认：species）
• fmt：响应格式（默认：json）

ebird_get_taxonomy_forms

获取特定物种的 eBird 分类形式。

参数：

• speciesCode（必需）：eBird 物种代码

测试

要测试 eBird MCP 服务器，请将您的 eBird API 密钥设置为环境变量并运行测试脚本：

bash
export EBIRD_API_KEY=your_api_key
node test-ebird.js

调试模式

要启用调试模式并查看详细的日志记录：

bash
node index.js --api-key YOUR_EBIRD_API_KEY --debug

许可证

MIT

致谢

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