使用说明
eBird MCP服务器
将eBird与AI相结合:构建您的个人鸟类观察助手
该项目将eBird API与MCP(模型上下文协议)服务器集成在一起,使您能够直接在Claude的聊天窗口中通过自然语言查询鸟类观察数据。
入门指南
先决条件
- eBird API密钥:创建eBird帐户并请求API密钥。
- Claude桌面应用程序:下载并安装Claude Desktop应用程序。
- 安装 python (见此 教程).
安装
克隆存储库
git clone git@github.com:siansiansu/ebird-mcp-server.git
cd ebird-mcp-server
安装依赖项
pip install -r requirements.txt
配置
配置Claude桌面
- 打开克劳德桌面。
- 导航到设置>开发人员>编辑配置>编辑
claude_desktop_config.json文件。 - 将配置替换为您的路径和API密钥:
{
"mcpServers": {
"ebird-api": {
"command": "/absolute/path/to/python",
"args": [
"/absolute/path/to/ebird-mcp-server/server.py"
],
"env": {
"EBIRD_API_KEY": "your-ebird-api-key"
}
}
}
}
重要提示:
command:Python可执行文件的绝对路径。args:绝对路径server.py.EBIRD_API_KEY:您的eBird API密钥。
重新启动克劳德
保存配置后,重新启动Claude Desktop应用程序。它将自动启动和管理MCP服务器。
用法
在Claude中打开聊天,使用任何示例提示(或您自己的)查询eBird数据。
特性
以下是可用于查询数据的示例提示。AI将决定何时调用eBird MCP服务器,或者您可以明确指示它这样做。
观察
查询某个位置的最近观察结果
What birds have been seen recently in Budai, Chiayi?
查询最近对一个物种的观察结果
Are there any recent records of Black-faced Spoonbill in Tainan?
查询显著(罕见)观察结果
What rare birds have been reported recently in Hsinchu?
检查清单
主要贡献者
List the top 100 eBird contributors in Taipei on June 26, 2025.
日期上的所有清单
Show all checklists submitted in Kaohsiung on June 15, 2024.
最近的检查表
Provide the latest checklists submitted in Tainan.
汇总统计
Summarize all observation checklists in New Taipei on June 20, 2024.
检查表详细信息
Show details for checklist ID S12345678.
热点
列出某个位置的热点
List all eBird hotspots in Tainan.
附近热点
List birding hotspots within 5 km of my current location.
分类学
官方分类
Provide the eBird taxonomy data for Black-faced Spoonbill.
列出亚种
List all subspecies of White-breasted Waterhen.
许可证
该项目根据MIT许可证获得许可。
