Victron TCP 服务器

Victron TCP-MCP服务器

将人工智能助手连接到Victron Energy系统。从本地网络读取实时太阳能、电池、电网和逆变器数据，无需云。

32个工具|23个提示|2个资源|900+个寄存器|Modbus TCP+MQTT

我想要哪个包裹？

这是 本地/LAN 半双。远程/云的一半是 victron-vrm-mcp.

在以下情况下使用此软件包： 您与GX设备位于同一局域网内，需要具有原始寄存器支持的实时、低延迟读取访问。 使用 victron-vrm-mcp 什么时候： 您需要远程访问，您正在通过MCP连接器构建一个API支持的应用程序，或者您不想在局域网上暴露任何内容。

你可以使用 两者 同时，它们服务于不同的用例，并具有不同的风险特征。

安装

克劳德代码

claude mcp add-json victron-tcp '{"type":"stdio","command":"npx","args":["-y","victron-tcp"]}'

克劳德桌面/光标/风帆

{
  "mcpServers": {
    "victron-tcp": {
      "command": "npx",
      "args": ["-y", "victron-tcp"],
      "env": {
        "VICTRON_HOST": "192.168.1.50",
        "VICTRON_TRANSPORT": "mqtt",
        "VICTRON_PORTAL_ID": "your-portal-id"
      }
    }
  }
}

不知道您的设备IP？

只需询问AI：

Find my Victron GX device on the network and set it up.

它将扫描您的网络，测试连接，并为您生成配置。

需求

• Victron GX设备 在您的本地网络上（Ekrano、Cerbo、Venus GX等）
• 消息队列遥测传输 （在Venus OS上默认启用）或 Modbus TCP （设置→ 服务→ Modbus TCP）
• Node.js 18+

你能做什么

能源报告

能量优化

监控和故障排除

设备发现

对于安装人员

集成

工具参考

资源

配置

环境变量

全部可选。设置它们以避免在每次工具调用时重复参数。

远程使用（MCP连接器API）

这个包裹说话 标准，其中 人类MCP连接器API 无法直接访问（连接器需要HTTPS）。对于云支持的远程访问，请使用兄弟包 victron-vrm-mcp.

如果您真的需要连接器API 这 包（例如，远程使用原始寄存器读取），您可以将其放在自己的HTTPS网关后面，该网关向上游传输可流HTTP并生成 victron-tcp 下游——不建议用于典型用途。

调试

这 MCP检查员 是交互式戳服务器的最快方法。

# Inspect a locally-built server
npm run inspect

# Inspect the published npm package as users would run it
npm run inspect:npm

两者都打开了一个基于浏览器的UI，您可以在其中调用工具、查看结构化内容和观看通知流。日志转到 标准错误 （stdout是为stdio传输上的JSON-RPC流保留的——永远不要写入stdout）。

特别是对于Claude Desktop，MCP服务器登录 ~/Library/Logs/Claude/mcp-server-victron-tcp.log （macOS）或 %APPDATA%\Claude\logs\mcp-server-victron-tcp.log （Windows）。请参阅规格 调试指南 以获得完整的演练。

文档

路线图

• [ ] 撰写支持 --ESS模式控制、电网设定点、充电电流限制、继电器控制（通过MQTT W/ 主题）
• [x] MCP资源-寄存器列表+单元ID映射（VRM API规范移动到 victron-vrm-mcp)
• [x] MCP提示——23个指导性工作流程
• [x] NPM包(npx victron-tcp)
• [x] VRM云访问的兄弟包-- victron-vrm-mcp

参考文献

• Victron Modbus TCP常见问题
• CCGX寄存器列表（Excel）
• 金星OS | MQTT文档
• VRM API | MCP协议

许可证

麻省理工学院