MeteoControl MCP 服务器

一个用于 MeteoControl VCOM API v2 的模型上下文协议 (MCP) 服务器。此扩展允许您通过 Gemini CLI 使用自然语言监控太阳能阵列、检索能源生产数据并执行系统健康检查。

功能

• 系统发现： 列出与您的账户关联的所有太阳能系统。

• 能源监控： 检索历史能源生产数据 (Wh/kWh/MWh)。

• 资产信息： 获取有关面板、逆变器和站点容量的技术细节。

• 实时功率： 检查瞬时交流功率输出。

• 多传输支持： 通过 Stdio 本地运行或通过 SSE 远程托管。

• 多租户 (BYOC)： 在共享环境中支持“自带凭据”。

安装

通过 Gemini CLI（推荐）

直接从 GitHub 安装扩展：

gemini extensions add https://github.com/your-org/meteocontrol-mcp

手动安装

1. 克隆仓库：

   git clone https://github.com/your-org/meteocontrol-mcp.git
   cd meteocontrol-mcp

2. 安装依赖并构建：

   npm install
   npm run build

使用方法

安装完成后，您可以向 Gemini 询问有关您的太阳能系统的问题：

• “列出我的太阳能系统。”

• “系统 [systemKey] 过去 24 小时的能源产量是多少？”

• “向我展示系统 [systemKey] 中 INV1 的技术细节。”

多租户使用 (BYOC)

如果您使用的是共享 MCP 服务器，则可以直接在提示词中提供您自己的凭据，或在本地进行配置。这些工具接受可选的 apiKey、user 和 password 参数。

预配置命令

• /health [systemKey]：执行全面的站点健康检查。

• /yield [systemKey]：检索并汇总能源生产数据。

部署与托管

该服务器支持多种运行模式：

1. 本地模式 (Stdio)

这是 Gemini CLI 使用的默认模式。

• 命令： node dist/index.js

• 设置： 在 gemini-extension.json 中使用 command 和 args 定义。

2. 远程模式 (SSE)

使用此模式可在中央服务器上为多个用户托管 MCP 服务器。

安全性：生成访问令牌

远程模式出于安全考虑需要强制使用 MCP_SERVER_TOKEN。您可以使用以下命令生成安全令牌：

openssl rand -base64 32

服务器配置

• 环境变量：

  • MCP_TRANSPORT=sse

  • MCP_SERVER_TOKEN=your_generated_token (必需)

  • PORT=3000 (可选，默认为 3000)

• 运行命令：

  MCP_TRANSPORT=sse MCP_SERVER_TOKEN=your_token node dist/index.js

3. Docker 模式

您可以将服务器作为容器运行，以便于部署。

用于 Stdio 模式 (CLI 使用)：

docker run -i --rm \
  -e METEOCONTROL_API_KEY=your_key \
  -e METEOCONTROL_USER=your_user \
  -e METEOCONTROL_PASSWORD=your_password \
  ghcr.io/your-org/meteocontrol-mcp:latest

用于 SSE 模式 (托管使用)：

docker run -d \
  -p 3000:3000 \
  -e MCP_TRANSPORT=sse \
  -e MCP_SERVER_TOKEN=your_token \
  -e METEOCONTROL_API_KEY=your_key \
  -e METEOCONTROL_USER=your_user \
  -e METEOCONTROL_PASSWORD=your_password \
  ghcr.io/your-org/meteocontrol-mcp:latest

客户端配置 (针对 SSE)

在您的本地 .gemini/settings.json 中，添加 url 和 Authorization 标头：

{
  "mcpServers": {
    "meteocontrol": {
      "url": "https://your-mcp-server.com/sse",
      "headers": {
        "Authorization": "Bearer your_generated_token"
      }
    }
  }
}

配置

服务器与 MeteoControl 通信需要以下环境变量（除非在每个请求中提供了凭据）：

• METEOCONTROL_API_KEY：您的 VCOM API 密钥。

• METEOCONTROL_USER：您的 VCOM 用户名（电子邮件）。

• METEOCONTROL_PASSWORD：您的 VCOM 密码。

许可证

Apache License 2.0