鸟类网络Pi MCP服务器是一个基于Python的模型上下文协议(MCP)服务器,专为鸟类网络Pi集成而设计。它能够帮助用户高效地管理和分析鸟类检测数据,提供丰富的功能和便捷的操作体验。
git clone https://github.com/YourUsername/mcp-server.git
cd mcp-server
python -m venv venv
source venv/bin/activate # 在Windows上使用:venv\Scripts\activate
pip install -r requirements.txt
mkdir -p data/audio data/reports
服务器可以通过环境变量进行配置:
BIRDNET_DETECTIONS_FILE
:检测JSON文件的路径(默认:'data/detections.json')BIRDNET_AUDIO_DIR
:音频文件目录的路径(默认:'data/audio')BIRDNET_REPORT_DIR
:报告目录的路径(默认:'data/reports')启动服务器:
python server.py
服务器将在http://localhost:8000
上运行。
以下是调用getBirdDetections
函数的示例:
import requests
url = 'http://localhost:8000/invoke'
data = {
"name": "getBirdDetections",
"parameters": {
"startDate": "2024-01-01",
"endDate": "2024-01-31",
"species": "Sparrow"
}
}
response = requests.post(url, json=data)
print(response.json())
以下是调用generateDetectionReport
函数生成HTML报告的示例:
import requests
url = 'http://localhost:8000/invoke'
data = {
"name": "generateDetectionReport",
"parameters": {
"startDate": "2024-01-01",
"endDate": "2024-01-31",
"format": "html"
}
}
response = requests.post(url, json=data)
with open('report.html', 'w') as f:
f.write(response.text)
/functions
- 列出可用函数(GET)/invoke
- 调用一个函数(POST)getBirdDetections
getDetectionStats
getAudioRecording
getDailyActivity
generateDetectionReport
mcp-server/
├── birdnet/
│ ├── __init__.py
│ ├── config.py
│ ├── functions.py
│ └── utils.py
├── data/
│ ├── audio/
│ └── reports/
├── server.py
├── requirements.txt
└── README.md
requirements.txt
中列出的其他依赖项