Mcp Local Server

Mcp Local Server

🚀 鸟类网络Pi MCP服务器

鸟类网络Pi MCP服务器是一个基于Python的模型上下文协议(MCP)服务器,专为鸟类网络Pi集成而设计。它能够帮助用户高效地管理和分析鸟类检测数据,提供丰富的功能和便捷的操作体验。

🚀 快速开始

安装

  1. 克隆仓库:
git clone https://github.com/YourUsername/mcp-server.git
cd mcp-server
  1. 创建虚拟环境并激活它:
python -m venv venv
source venv/bin/activate  # 在Windows上使用:venv\Scripts\activate
  1. 安装依赖项:
pip install -r requirements.txt
  1. 设置您的数据目录:
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)

📚 详细文档

API端点

  • /functions - 列出可用函数(GET)
  • /invoke - 调用一个函数(POST)

可用功能

  1. getBirdDetections

    • 获取经过日期范围和物种过滤的鸟类检测数据
    • 参数:startDate,endDate,species(可选)
  2. getDetectionStats

    • 获取时间段内的检测统计信息
    • 参数:period('day','week','month','all'),minConfidence(可选)
  3. getAudioRecording

    • 获取检测的音频录音
    • 参数:filename,format('base64'或'buffer')
  4. getDailyActivity

    • 获取特定日期的鸟类活动模式
    • 参数:date,species(可选)
  5. generateDetectionReport

    • 生成检测报告
    • 参数:startDate,endDate,format('html'或'json')

🔧 技术细节

目录结构

mcp-server/
├── birdnet/
│   ├── __init__.py
│   ├── config.py
│   ├── functions.py
│   └── utils.py
├── data/
│   ├── audio/
│   └── reports/
├── server.py
├── requirements.txt
└── README.md

要求

  • Python 3.8+
  • FastAPI
  • Uvicorn
  • 其他requirements.txt中列出的其他依赖项
  • 0 关注
  • 0 收藏,9 浏览
  • system 提出于 2025-09-20 21:30

相似服务问题