MCP.Market

Aiseg2 MCP server

by chanyou0311·io.github.chanyou0311/aiseg2-mcp·v0.1.0
No reviews yet

Unofficial read-only MCP server for the Panasonic AiSEG2 HEMS controller.

B83/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
New

0 stars13 downloads/wk

Reviews

Write one

Nobody has reviewed Aiseg2 yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Aiseg2 tools (6)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • get_circuit_breakdown

    Read-only. Get the instantaneous power draw of every measured circuit, ranked highest first.

  • get_cost_history

    Read-only. Query the AiSEG2's long-term energy-cost history from the SD-card export (JPY).

  • get_daily_totals

    Read-only. Get today's cumulative energy totals (kWh) as of the AiSEG2's current day.

  • get_history

    Read-only. Query the AiSEG2's long-term energy history from its SD-card export (values in Wh).

  • get_power_flow

    Read-only. Get the AiSEG2's instantaneous whole-home power flow right now.

  • list_circuits

    Read-only. List the registered measurement circuits with their stable ids and names.

Public scan report

scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it

no findings
  • Code scan14 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 3 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Aiseg2 compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
83/100
higher than 65% of 48,255 servers
Tools
6
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
13
more than 4% of 12,191 servers with a package

What its tools let an agent do: 6 read

Install Aiseg2 in Claude Code, Cursor or VS Code

claude mcp add aiseg2-mcp -- uvx aiseg2-mcp
Add to Cursor

What the publisher says

From the Aiseg2 repository's README, as published. We do not edit it. Read it on GitHub

<!-- mcp-name: io.github.chanyou0311/aiseg2-mcp -->

aiseg2-mcp

日本語版は README.ja.md をご覧ください。

An unofficial, read-only Model Context Protocol server for the Panasonic AiSEG2 home energy management (HEMS) controller. It lets an MCP client (e.g. Claude) read your home's live power flow, per-circuit consumption, circuit names, and daily energy totals from the AiSEG2's local web interface.

This project is not affiliated with or endorsed by Panasonic. "AiSEG" is a Panasonic trademark.

Verified environment

Developed and tested against:

  • AiSEG2 model MKN713 series
  • Firmware Ver.2.97I-01

The AiSEG2 web interface is undocumented and changes between firmware revisions. On a different model or firmware the pages this server scrapes may differ and some tools may not work. If you hit a parse error, please open an issue with your model / firmware version.

Tools

All tools are read-only (annotated readOnlyHint, non-destructive). The server only issues GETs and the display-only refresh POSTs the web UI itself uses; it never touches settings or any /action/ endpoint.

The two history tools require an SD card inserted in the AiSEG2 — they read the device's SD-card CSV export. The export is downloaded once and cached (see AISEGCACHEDIR / AISEGCACHETTL), so the first call is slow and later calls are fast.

Install & run

Three ways to run it, depending on your setup.

1. uvx (PyPI — once published)

The simplest option for a local (stdio) MCP client. Requires uv.

AISEG_URL=http://192.168.0.216 AISEG_PASSWORD=... uvx aiseg2-mcp

Add it to Claude Code:

claude mcp add aiseg2 \
  --env AISEG_URL=http://192.168.0.216 \
  --env AISEG_PASSWORD=your-digest-password \
  -- uvx aiseg2-mcp

2. docker run (GHCR)

The container defaults to the streamable-http transport (long-lived network service). Only expose it behind an authenticating proxy — see Security.

docker run --rm -p 8000:8000 \
  -e AISEG_URL=http://192.168.0.216 \
  -e AISEG_PASSWORD=your-digest-password \
  ghcr.io/chanyou0311/aiseg2-mcp:latest

3. From source

Requires Python 3.12+ and uv.

uv sync
AISEG_URL=http://192.168.0.216 AISEG_PASSWORD=... uv run aiseg2-mcp

Remote (authenticated claude.ai Custom Connector)

To reach the server from claude.ai while your AiSEG2 stays on your LAN, see examples/remote/ — a Docker Compose stack (MCP + GitHub-OAuth proxy + Cloudflare Tunnel).

Running the image

This repo's job ends at pushing the image to GHCR. Where and how it actually runs (Kubernetes manifests, etc.) is defined elsewhere — for the maintainer's own deployment, in fumo-infra. The table below is the contract another system builds against to run this image.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Aiseg2: common questions

Is Aiseg2 MCP server safe?
Mostly: it is graded B (83/100). Read the Aiseg2 safety report
How do I install Aiseg2?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Aiseg2 need an API key?
Yes. The registry entry asks for AISEG_PASSWORD.
Is Aiseg2 maintained?
The last commit was 43 days ago (2026-09-22). The latest release is v0.1.0.
How does Aiseg2 compare with other MCP servers?
safety score 83/100 (higher than 65% of 48,255 servers); tools 6 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.