eBird MCP服务器
用于与eBird API集成的模型上下文协议（MCP）服务器。该服务器允许像Claude这样的人工智能助手访问eBird的鸟类观测数据、热点和分类信息。
Claude桌面的快速设置
将此配置添加到您的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"
]
}
}
}确保：
- 替换
YOUR_EBIRD_API_KEY使用您的实际eBird API密钥 - 如果配置文件不存在，则创建它
- 使用以下命令全局安装软件包
npm install -g ebird-mcp-server如果你还没有 - 保存更改后重新启动Claude Desktop
备注：您可以从获取eBird API密钥 eBird API密钥请求
特性
eBird MCP服务器提供对以下eBird数据的访问：
- 最近在一个地区观察到的鸟类
- 最近对特定鸟类的观察
- 一个地区值得注意的鸟类观察
- 在某一地点附近的观察
- 在某一地点附近的显著观察结果
- 一个地区的观鸟热点
- 地点附近的热点
- eBird分类信息
先决条件
- Node.js（v14或更高版本）
- eBird API密钥（从 eBird API密钥请求)
安装
适用于克劳德桌面
- 克隆此存储库或下载文件
- 运行Claude Desktop安装脚本：
chmod +x claude_setup.sh
./claude_setup.sh YOUR_EBIRD_API_KEY- 重新启动克劳德桌面
对于其他MCP客户端
- 克隆此存储库或下载文件
- 运行安装脚本：
chmod +x install.sh
./install.sh YOUR_EBIRD_API_KEY- 服务器现已安装，可以使用以下方式运行：
./run-ebird-mcp-server.sh手动安装
- 克隆此存储库或下载文件
- 安装依赖项：
npm install- 运行服务器：
node index.js --api-key YOUR_EBIRD_API_KEY可用工具
ebird_get_recent_observations
获取某个地区或地点最近的鸟类观察结果。
参数：
regionCode（必填）：地区代码（例如，美国、美国纽约州、L123456）back：返回以查找观测值的天数（默认值：14）maxResults：要返回的最大结果数（默认值：100）includeProvisional：包括临时观察结果（默认值：true）hotspot：仅包括来自热点的观测值（默认值：false）detail：结果的详细级别（“简单”或“完整”，默认值：“简单”）
ebird_ge_recent_observations_for_species
获取一个地区特定鸟类的最新观察结果。
参数：
regionCode（必填）：地区代码（例如，美国、美国纽约州、L123456）speciesCode（必填）：eBird物种代码（例如，美国乌鸦的amecro）back：返回以查找观测值的天数（默认值：14）maxResults：要返回的最大结果数（默认值：100）includeProvisional：包括临时观察结果（默认值：true）hotspot：仅包括来自热点的观测值（默认值：false）
ebird_get_notable_observations
在一个地区进行引人注目的鸟类观察。
参数：
regionCode（必填）：地区代码（例如，美国、美国纽约州、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_hots
在一个地区找到观鸟热点。
参数：
regionCode（必填）：地区代码（例如，美国、美国纽约州）back：查找热点活动的返回天数（默认值：14）includeProvisional：包括临时观察结果（默认值：true）
ebird_getnearby_hotspots
在附近找到观鸟热点。
参数：
lat（必填）：纬度坐标lng（必填）：经度坐标dist：距离纬度/液化天然气点的距离（默认值：25）back：查找热点活动的返回天数（默认值：14）includeProvisional：包括临时观察结果（默认值：true）
ebird_get分类法
获取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许可证
麻省理工学院