Stroomr Mcp

StroomR MCP

一次调用即可帮助 AI 助手回答“什么时候用电最合适？”——提供实时 Nord Pool 电价、本地太阳能预报，以及可直接使用的负荷转移建议。

由 StroomR 构建。专为欧洲日前能源市场和家庭能源用电时段规划打造，并非通用天气或金融 API。

---

你的 Agent 可以做什么

任务	不使用此服务	使用 StroomR MCP
电动汽车充电建议	Agent 只能猜测，或让用户查看多个应用	一次工具调用 → 获取最佳时段、预计节省金额和应避开的时段
热泵／电池用电时机	手动查询电价并查看天气	在结构化输出中整合电价与太阳能发电时段
“明天会晴吗？”＋“电价低吗？”	分别查询两次，再由 Agent 整合上下文	一次获取完整快照，为负荷转移决策提供依据

**关注结果，而非底层实现：**你的 Agent 能以更少的步骤完成能源时段规划任务，获取预先整合的上下文和结构化字段（recommendedWindows、avoidWindows、estimatedSavingsVsAvgEur），而非原始 API 数据。

---

最适用场景

1. “明天什么时候给电动汽车充电合适？”——最便宜的连续时段、相较平均价格的预计节省金额，以及应避开的晚间高峰。
2. “今天热泵的最佳运行时段是什么？”——按电价排序的时段，并标出适合自发自用的太阳能重叠时段。
3. “明天会晴吗？电价低吗？”——天气与 Nord Pool 快照，助你决定太阳能和负荷安排。
4. “本周哪些时段用电最便宜？”——今天和明天的日前时段。
5. “今天日照时间有多长？”——指定地点的日照时长、日照时段和降雨时段。

**范围：**欧洲 Nord Pool 日前市场（NL、GER、DK1、SE3 等）。不适用于实时交易、电网运营商数据或非欧洲公用事业公司。

---

支持的客户端

适用于任何兼容 MCP 的助手，包括：

• Cursor（本地 stdio——此仓库中包含配置）
• Claude Desktop（添加到 claude_desktop_config.json）
• 支持 stdio 服务的其他 MCP 宿主（ChatGPT 桌面集成、自定义 Agent 等）

需要 Node.js 20+。在你的设备上本地运行——使用 MCP 无需 StroomR 账户。

---

身份验证与安全

运行方式	通过 stdio 在本地运行（node dist/index.js）
凭据	无——无需 API 密钥，无需登录 StroomR
网络	仅向 Open-Meteo（天气）和 Nord Pool 公开的日前 API（电价）发起只读的出站调用
写入操作	无——不会控制设备、电表或你的住宅
发送的数据	位置（城市或坐标）和 Nord Pool 区域——仅限你在工具参数或环境变量配置中传入的信息

在环境变量中设置默认位置，这样 Agent 就不必每次都询问：

"env": {
  "STROOMR_CITY": "Amsterdam",
  "STROOMR_PRICE_AREA": "NL"
}

---

示例

示例 1 — 电动汽车充电（主要使用场景）

用户提示词：

明天什么时候给我的电动汽车充电合适？

Agent 操作：get_load_shift_advice · { "device": "ev", "day": "tomorrow" }

Agent 回复（根据结构化输出）：

明天 10:00–14:00 充电。对于以 11 kW 充电 4 小时的情况，预计比平均批发电价节省 €3.73。避免在 17:00–23:00 充电（晚间高峰）。此时段预计有日照，适合太阳能自发自用。

---

示例 2 — 今天运行热泵

用户提示词：

今天热泵的最佳运行时段是什么？

Agent 操作：get_load_shift_advice · { "device": "heat_pump", "day": "today" }

Agent 回复：

今天 14:00–18:00 进行集中供暖（12 kWh 的费用预计比平均价格低约 €0.68）。避免在 19:00–23:00 运行。

---

示例 3 — 一步查询天气和电价

用户提示词：

明天适合低价充电和利用太阳能吗？

Agent 操作：get_weather_and_prices · { "days": 2 }

Agent 回复：

明天：日照约 15 小时（07:00–21:00），日前电价在午间接近零。适合将负荷转移到午间。

---

工具（5 个，专为特定用途打造）

工具	Agent 任务
get_load_shift_advice	主要工具。 为电动汽车、热泵或电池提供最佳和应避免的时段；估算节省金额；查看与太阳能的重叠情况
get_weather_and_prices	当 Agent 需要同时了解日照和价格情况时，提供综合快照
get_energy_prices	获取当前及明天的 Nord Pool 日前时段，以及最便宜和最贵的时段
get_weather_forecast	获取日照时段、降雨时段和降水情况——适用于关注太阳能的场景
resolve_location	验证城市或坐标，并确定 Nord Pool 价格区域

负载转移建议的默认值：

设备	device	功率	持续时间
电动汽车充电器	ev	11 kW	4 h
热泵	heat_pump	3 kW	4 h
家用电池	battery	5 kW	2 h

使用 power_kw 和 duration_hours 覆盖默认值。

---

安装

从 npm 安装（发布后）

{
  "mcpServers": {
    "stroomr": {
      "command": "npx",
      "args": ["-y", "@nixman2/stroomr-mcp"],
      "env": {
        "STROOMR_CITY": "Amsterdam",
        "STROOMR_PRICE_AREA": "NL"
      }
    }
  }
}

从源代码安装

npm install
npm run build

Cursor（本地开发）

.cursor/mcp.json：

{
  "mcpServers": {
    "stroomr": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "STROOMR_CITY": "Amsterdam",
        "STROOMR_PRICE_AREA": "NL",
        "STROOMR_OUTPUT_FORMAT": "structured"
      }
    }
  }
}

更改 MCP 配置后，重启 Cursor。

Claude Desktop

{
  "mcpServers": {
    "stroomr": {
      "command": "node",
      "args": ["/absolute/path/to/stroomr-mcp/dist/index.js"],
      "env": {
        "STROOMR_CITY": "Amsterdam",
        "STROOMR_PRICE_AREA": "NL"
      }
    }
  }
}

---

配置

变量	描述
STROOMR_CITY	默认城市（通过地理编码获取）
STROOMR_LAT / STROOMR_LON	默认坐标
STROOMR_PRICE_AREA	Nord Pool 区域（例如 NL）
STROOMR_CURRENCY	默认值为 EUR
STROOMR_TIMEZONE	时区覆盖值
STROOMR_OUTPUT_FORMAT	friendly（默认）或 structured

优先级： 工具参数 → 环境变量 → 明确报错（不会静默使用默认城市）。

结构化响应包含 stroomr 品牌信息块，以及经过优化、便于 Agent 解析的字段（recommendedWindows、cheapestSlot、summary_nl）。

---

验证

npm run smoke-test

---

关于 StroomR

这个 MCP 是 StroomR 中负载转移逻辑的免费演示版。StroomR 是一款能源管理工具，可根据动态电价和太阳能发电情况，自动安排电动汽车充电、热泵运行和电池充放电时间。

想要无需询问助手即可全天候运行？ 加入免费试点 →

---

数据来源与免责声明

• 天气：Open-Meteo（CC BY 4.0）
• 价格：Nord Pool Group 日前价格，通过社区记录的公共 API 获取（非官方；可能会变更）

负载转移建议使用批发日前价格。零售电费包含税费、电网费用和供应商加价，因此节省金额估算仅供参考，不作保证。

支持的 Nord Pool 区域： DK1、DK2、FI、NO1–NO5、SE1–SE4、EE、LT、LV、AT、BE、FR、GER、NL、PL、BG、TEL

---

发布到 MCP Registry

已准备好用于官方 MCP Registry 快速入门指南：

步骤	状态
1. 在 package.json 中填写 mcpName	✅ io.github.nixman2/stroomr-mcp
2. 发布到 npm	⏳ 在本地运行（需要登录 npm）
3. 安装 mcp-publisher	✅
4. 创建 server.json	✅ 已验证
5. mcp-publisher login github	—
6. mcp-publisher publish	—

步骤 2——发布到 npm：

npm adduser          # if not logged in
npm publish --access public

步骤 5–6——发布 Registry 元数据：

mcp-publisher login github
mcp-publisher publish

验证条目：

curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.nixman2/stroomr-mcp"

Registry 名称：io.github.nixman2/stroomr-mcp · npm：@nixman2/stroomr-mcp

---

提交到 Cursor Directory

cursor.directory 会扫描仓库根目录中的 Open Plugins 组件。本仓库包含：

路径	用途
mcp.json	MCP 服务配置（目录扫描必需）
.cursor-plugin/plugin.json	插件清单
skills/stroomr-energy/SKILL.md	用于能源时机问题的 Agent 技能

推送到 GitHub 后，请在 Submit a Plugin → Auto (GitHub) 中使用 https://github.com/nixman2/stroomr-mcp 重新扫描。

注意：mcp.json 使用 npx @nixman2/stroomr-mcp——必须先成功发布到 npm。本地开发仍使用 .cursor/mcp.json。