项目简介

Bird Stats MCP 服务器插件是一个用于分析鸟类观测数据的工具。它连接 BirdNET-Pi 和 eBird 数据,使用户可以通过自然语言查询来分析鸟类检测结果,并结合 eBird 的广泛数据库进行交叉引用。

主要功能点

  • 自然语言查询: 支持使用自然语言查询 BirdNET-Pi/BirdWeather 和 eBird 数据。
  • 数据交叉引用: 将 BirdWeather 检测结果与 eBird 观测数据进行交叉比对分析。
  • 数据可视化: 提供基于 React artifacts 的数据驱动可视化功能。(仓库代码中未直接体现React artifacts,此描述可能来自项目规划或未来功能

安装步骤

  1. 克隆仓库到本地:
    git clone https://github.com/DMontgomery40/mcp-server-birdstats.git
  2. 进入项目目录:
    cd mcp-server-birdstats
  3. 安装依赖:
    npm install

服务器配置

要将此 MCP 服务器插件与 MCP 客户端(如 Claude)配合使用,您需要在客户端中配置服务器连接信息。以下是一个示例 JSON 配置,您可能需要在 MCP 客户端的设置中添加类似配置:

{
  "serverName": "mcp-birdstats",  // 服务器名称,用于在客户端中标识
  "command": "npx",              // 启动服务器的命令,这里使用 npx 执行 mcp-birdstats
  "args": ["-y", "mcp-birdstats"] // 传递给命令的参数,-y 可能是为了确认某些操作,mcp-birdstats 可能是启动脚本
}

参数注释:

  • 'serverName': 为服务器指定一个名称,例如 'mcp-birdstats',客户端会使用这个名称来识别和调用该服务器。
  • 'command': 指定用于启动服务器的命令。'npx' 是 npm 包执行器,常用于运行本地安装的 npm 包的可执行文件。
  • 'args': 一个字符串数组,包含了传递给 'command' 的参数。
    • '"-y"': 这个参数的具体作用需要查看 'mcp-birdstats' 脚本的文档,通常 '-y' 或 '--yes' 用于自动确认一些命令行操作,避免交互式提示。
    • '"mcp-birdstats"': 这很可能是实际要执行的脚本或命令,根据 'package.json' 中的 'bin' 字段或者项目文档来确定。

请注意: 确保您的 MCP 客户端支持 Stdio 传输协议,因为此服务器实现使用了 'StdioServerTransport'。

基本使用方法

配置完成后,在 MCP 客户端中,您可以使用自然语言向 Bird Stats 服务器提问,例如:

  • "My BirdNET heard a Swainson's Thrush - is that unusual?" (我的 BirdNET 听到了 Swainson's Thrush - 这寻常吗?)
  • "What's my station's rarest detection this week?" (我的站点本周最稀有的检测是什么?)
  • "Graph my detections by time of day" (按一天中的时间绘制我的检测图表)
  • "Are others seeing these warblers on eBird?" (其他人在 eBird 上也看到了这些莺类吗?)

服务器会处理您的查询,并返回基于 BirdNET-Pi 和 eBird 数据的分析结果。您可能需要在对话中提供您的 BirdWeather 站点 token 以进行数据访问。

信息

分类

AI与计算