项目简介
Bird Stats MCP 服务器插件是一个用于分析鸟类观测数据的工具。它连接 BirdNET-Pi 和 eBird 数据,使用户可以通过自然语言查询来分析鸟类检测结果,并结合 eBird 的广泛数据库进行交叉引用。
主要功能点
- 自然语言查询: 支持使用自然语言查询 BirdNET-Pi/BirdWeather 和 eBird 数据。
- 数据交叉引用: 将 BirdWeather 检测结果与 eBird 观测数据进行交叉比对分析。
- 数据可视化: 提供基于 React artifacts 的数据驱动可视化功能。(仓库代码中未直接体现React artifacts,此描述可能来自项目规划或未来功能)
安装步骤
- 克隆仓库到本地:
git clone https://github.com/DMontgomery40/mcp-server-birdstats.git - 进入项目目录:
cd mcp-server-birdstats - 安装依赖:
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与计算