鸟类观测数据服务

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"
      ]
    }
  }
}

确保：

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密钥请求)

安装

适用于克劳德桌面

1. 克隆此存储库或下载文件
2. 运行Claude Desktop安装脚本：

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

3. 重新启动克劳德桌面

对于其他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 （必填）：地区代码（例如，美国、美国纽约州、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

许可证

麻省理工学院

致谢

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