星战科技xingzhan.cloud
返回市场
鸣禽-MCP服务器

鸣禽-MCP服务器

作者：moonbirdai3 星标更新：2025-05-03
安装使用来源：spider==github.com

项目介绍

eBird MCP Server

这是一个用于与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密钥

功能

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

  • 某区域内的近期鸟类观察记录
  • 某特定鸟类种类的近期观察记录
  • 某区域内的显著鸟类观察记录
  • 靠近某地点的观察记录
  • 靠近某地点的显著观察记录
  • 某区域内的观鸟热点
  • 靠近某地点的观鸟热点
  • eBird分类信息

先决条件

安装

对于Claude Desktop

  1. 克隆此仓库或下载文件
  2. 运行Claude Desktop设置脚本：
chmod +x claude_setup.sh
./claude_setup.sh YOUR_EBIRD_API_KEY
  1. 重启Claude Desktop

对于其他MCP客户端

  1. 克隆此仓库或下载文件
  2. 运行安装脚本：
chmod +x install.sh
./install.sh YOUR_EBIRD_API_KEY
  1. 服务器现在已安装，可以使用以下命令运行：
./run-ebird-mcp-server.sh

手动安装

  1. 克隆此仓库或下载文件
  2. 安装依赖项：
npm install
  1. 运行服务器：
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物种代码（例如，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

致谢