逆变器数据检索服务

一个基于FoxESS云API的MCP服务器,用于检索逆变器的日、月、年报告数据,并提供设备和电站管理功能。

  • by asped
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 asped/mcp-foxess-server

使用说明

这里有一个更新 README.md 列出了所有工具、API密钥设置说明和版权/许可证部分。


FoxESS逆变器数据检索MCP服务器

该存储库包含用于构建模型上下文协议(MCP)服务器的文件,该服务器从FoxESS Cloud API检索数据。该服务器提供工具,用于获取指定逆变器的每日、每月和年度报告,以及其他设备和工厂管理功能。

包含的工具

  • get_plant_list:检索植物列表。
  • get_plant_detail:获取特定植物的详细信息。
  • get_device_list:列出所有设备。
  • get_device_detail:获取特定设备的详细信息。
  • get_device_variables:检索设备变量。
  • query_device_history:查询历史设备数据。
  • get_device_generation:获取设备生成统计信息。
  • get_battery_soc:检索电池充电状态。
  • set_battery_soc:设置电池充电状态。
  • get_force_charge_time:获取强制充电时间设置。
  • set_force_charge_time:设置强制充电时间。
  • get_module_list:列出所有模块。
  • get_access_count:获取用户访问计数。

它是如何工作的

这 server.py 该脚本使用FastMCP框架来包装向FoxESS Cloud API发出已验证请求的函数。您的API密钥是从环境变量安全加载的,防止它在代码中暴露。

API密钥设置

  1. 复制 env.example 到 .env:
    cp env.example .env
    
  2. 编辑 .env 并添加您的FoxESS API密钥:
    FOXESS_API_KEY=your_actual_api_key_here
    

您将需要一个有效的API密钥从您的FoxESS云帐户。 服务器为其他服务提供了一个干净的API来请求数据。

Docker设置

  1. 构建Docker镜像:
    docker build -t mcp-foxess-server .
    
  2. 现在,您可以在任何LLM中创建docker镜像:

版权和许可

版权所有©2025 asped

该项目根据MIT许可证获得许可。请参阅 LICENSE 文件以获取详细信息。