Emporia MCP

Emporia能源MCP服务器

Emporia Energy MCP服务器为LLM应用程序提供了一种安全的方式来访问您的Emporia能源设备数据。此MCP服务器实现处于测试阶段，未来可能会发生变化。

此MCP服务器支持多种传输方法：本地stdio（需要类似于命令行程序的本地执行）、传统服务器发送事件（SSE）和流式HTTP。对于远程传输，身份验证使用与API相同的承载令牌。OAuth也支持远程传输（请参阅 使用远程MCP 在......下面

此MCP服务器针对Emporia Energy客户云，不支持与合作伙伴相关的行为。

Emporia Energy希望听取您对该工具（或我们正在开发的任何其他工具）的任何反馈或建议。如有任何问题/想法，请随时通过电子邮件联系 info@emporiaenergy.com.

如需了解更多关于Emporia Energy和我们正在建设的内容，请随时访问我们的网站 www.emporiaenergy.com。我们在这里还拥有相当广泛的产品和平台知识库： help.emporiaenergy.com.

特性

• 通过自动令牌刷新进行安全身份验证
• 包含全面设备信息的设备列表
• 使用可配置的时间尺度和能量单位进行能量和功率测量/使用数据检索
• 具有上下文信息的结构良好的API响应
• 用于会话/报告详细信息的其他电动汽车充电器相关工具

请参阅下面的功能状态，了解有关设备特定实施状态的更多详细信息以及未来的实施情况。

⚠️ 重要提示

• 对于此MCP服务器的BETA实现，您必须拥有一个本地Emporia Energy帐户。如果您使用谷歌或苹果作为第三方身份验证提供商创建了Emporia帐户，则无法使用。短期内，您可以创建一个新帐户（使用电子邮件/密码），然后 _分享_ 通过Emporia Energy将您的Emporia设备添加到新帐户 网络 或 移动应用我们预计，此MCP服务器程序的未来版本将为这些第三方提供商帐户提供额外的灵活性。
• 具有许多关联设备（>20）的Emporia帐户可能存在短上下文窗口和长API响应的问题。类似地，请求大量的测量数据可能会产生过大的API响应，这可能会给一些客户端和上下文受限的LLM带来问题。
• 法学硕士可能不可靠。虽然此MCP服务器程序将从云端提供准确的Emporia数据，但LLM对这些数据的解释（和请求）有时可能不正确。

例子

全部

提示/技巧

• 在请求测量数据的具体日期/时间时，请详细说明。一些客户端/LLM可能不会在提示过程中提供最新的时间戳，因此指定确切的时间框架通常会有所帮助。

- 请尝试“显示2025年5月1日至5月10日的使用情况”，而不是“显示上周的使用情况。”

• 明确你是否在寻找电力或能源测量/使用数据，因为它们有单独的端点/工具（根据你的目标，它们将用于不同的目的）。

- 与其“显示使用情况”，不如尝试“显示……的能耗”或“显示…的功率测量值”

发布说明

• 2025年5月23日-首次发布
• 2025年8月26日-远程MCP发布（SSE和流式HTTP）

先决条件

• Node.js 18+（未来可能会提供基于Docker的安装选项）
• Emporia能源账户(_本地的_ 帐户，不是谷歌/苹果创建的）
• 支持MCP的AI客户端程序（Claude Desktop、Cursor/Windsurf/VS Code、LM Studio/OpenWebUI等）

- 看见 由官方MCP项目编制的示例客户列表

用法

在本地生成MCP服务器文件

您必须在本地创建一个JavaScript服务器文件。您的MCP客户端将运行此文件，您不需要让服务器继续运行。有关Windows安装，请参阅下面的选项3。

# Clone the repository
git clone https://github.com/emporiaenergy/emporia-mcp.git
cd emporia-mcp

# Install dependencies and build project
npm install && npm run build

MCP客户端中的配置

要在MCP客户端中使用本地MCP服务器，请将其添加到客户端的MCP配置文件中——建议使用NPX（有关本地运行的详细信息，请参阅下文）。\ 必须通过环境变量或.env文件提供身份验证凭据（用于您的Emporia Energy帐户）。

选项1：直接环境变量

{
  "mcpServers": {
    "emporia-mcp": {
      "command": "npx",
      "args": ["@emporiaenergy/emporia-mcp"],
      "env": {
        "EMPORIA_ACCOUNT": "",
        "EMPORIA_PASSWORD": ""
      }
    }
  }
}

选项2：使用.env文件

您可以在.env文件中提供凭据，并使用 ENV_FILE 环境变量：

{
  "mcpServers": {
    "emporia-mcp": {
      "command": "npx",
      "args": ["@emporiaenergy/emporia-mcp"],
      "env": {
        "ENV_FILE": "/path/to/your/.env"
      }
    }
  }
}

示例 .env 文件内容：

EMPORIA_ACCOUNT=example@email.com
EMPORIA_PASSWORD=examplepassword1234

选项3：在Windows上使用节点

有一个 Windows上的NPX错误，因此请改用Node。

{
  "mcpServers": {
    "emporia-mcp": {
      "command": "node",
      "args": ["C:\\dev\\emporia-mcp-server\\build\\index.js"],
      "env": {
        "EMPORIA_ACCOUNT": "",
        "EMPORIA_PASSWORD": "",
        "DEBUG": "*"
      }
    }
  }
}

使用远程MCP

要使用远程MCP服务器，您必须使用支持通过SSE或Streamable HTTP传输的远程MCP的MCP客户端，例如通过Anthropic API或Claude Desktop的Claude（仅限高级计划）。 Emporia Remote MCP服务器可通过以下方式访问https://mcp.emporiaenergy.com/streamable（流式HTTP）或https://mcp.emporiaenergy.com/sse（苏格兰和南方能源公司）。根据使用的客户端，您可以使用 OAuth用于验证您的MCP请求。请注意，某些客户端可能只支持OAuth身份验证的Streamable传输。对于API客户，如Claude通过Anthropic API，您必须通过 从请求中的OAuth流中检索到的身份验证令牌。

功能状态

可用工具

服务器提供以下工具来帮助AI助手与您的Emporia Energy数据进行交互：

1. list设备\

*获取所有连接的Emporia Energy设备的概览*\ 此工具提供设备的全面清单，包括客户信息、设备详细信息（型号、固件版本）、连接状态和位置数据。使用此功能可发现可用于监视或控制的设备。

*示例响应：* 列出所有Vue能量监测器、电动汽车充电器和其他Emporia设备的当前状态和配置详细信息。

1. getDeviceDetails\

*获取任何设备类型的实时状态和详细信息*\ 此工具通过传递一个或多个设备序列号来返回有关您的任何Emporia设备（电动汽车充电器、能量监测器、智能插头、电池等）的详细信息。响应包括每种设备类型的相关详细信息，如连接状态、当前状态、充电率、固件等。

*示例响应：* 对于电动汽车充电器，显示您的车辆是否已连接、是否正在充电、当前充电速率（以安培为单位）和最大可用充电速率。对于能量监测器，显示固件版本、通道计数和设备状态。对于智能插头，显示开/关状态和连接状态。对于电池，显示充电状态、容量和功率流。

1. 获取设备通道\

*获取有关设备通道和电路配置的详细信息*\ 此工具提供有关能源监测设备所有通道的全面信息，包括主电路和分支电路。对于了解电气系统的结构至关重要。

*示例响应：* 返回设备通道配置，显示可在其他API调用中引用的主分支电路、组合电路和通道命名/编号。

1. getDeviceEnergyUsage\

*分析任何设备或电路随时间的能耗*\ 此工具可检索任何设备（电动汽车充电器、能量监测器、智能插头、电池等）的历史能源使用数据，并可自定义时间段和分辨率。对于具有多个电路/通道的设备（如能量监测器或电池），您可以指定要查询的电路。

*示例响应：* 返回指定设备和（可选）电路的时间序列能量数据（单位：kWh），其中包含所选分辨率（从分钟到年）的时间戳和消耗值。

1. 获取设备电源使用情况\

*监控任何设备或电路的实时功耗*\ 此工具提供用电量数据，显示您的设备或特定电路在不同时间消耗的电量。有助于了解整个电气系统的功耗模式。

*示例响应：* 返回指定设备和（可选）电路的时间序列功率数据（单位为瓦），包括时间戳和以分钟或15分钟为间隔的平均功率值。

1. 获取电池充电状态\

*追踪家电池随时间的充电水平*\ 该工具为您的家用电池存储系统提供历史充电状态（SoC）数据，并具有可定制的时间段和分辨率。了解电池电量在一天、一周或一个月内的波动情况至关重要。重要提示-仅适用于家用电池系统，不适用于EVSE/电动汽车SoC

*示例响应：* 返回电池系统的时间序列充电状态数据（以0-100%的百分比值），包括时间戳和所选分辨率（分钟、小时或天）的平均充电状态值。

1. getEV充电报告\

*获取电动汽车充电活动的全面报告*\ 此工具提供有关您的电动汽车充电模式、成本和指定时间段内潜在节省的详细报告。对于了解充电习惯和优化成本节约至关重要。

*示例响应：* 返回一份综合报告，包括每日充电总量、单个充电时段、能源使用量（kWh）、充电成本以及基于公用事业费率计划的潜在节省。

1. getEVChargerSessions\

*跟踪电动汽车充电器的插入和充电事件*\ 此工具提供有关车辆何时连接到电动汽车充电器以及在这些连接期间发生的充电会话的详细信息。有助于了解车辆连接时间和实际充电时间。

*示例响应：* 返回每个充电器的插入/拔出事件列表，包括这些连接时段内每个充电会话的时间戳和能耗数据。