mcp-isolarcloud

An MCP server that serves the Sungrow iSolarCloud OpenAPI documentation — the official developer docs, control-parameter reference, device-type dictionary, error codes and measuring-point tables — as searchable tools, resources and how-to "skill" prompts.

The full documentation set is bundled with the package, so the server needs no network access or credentials at runtime.

Why

Building against the iSolarCloud API (e.g. the sungrow-isolarcloud client or the Home Assistant integration) means constantly cross-referencing the developer portal — whose docs live behind a JavaScript app. This server puts them one tool call away for any MCP-capable assistant, including the authoritative Appendix 10: Control Parameter Definitions (param codes, units and value encodings — e.g. SOC is sent as tenths of a percent, power in watts).

Run it

With uv (recommended — no install step):

uvx mcp-isolarcloud

Or add it to an MCP client (Claude Desktop / Claude Code / etc.):

{
  "mcpServers": {
    "isolarcloud": {
      "command": "uvx",
      "args": ["mcp-isolarcloud"]
    }
  }
}

For Claude Code: claude mcp add isolarcloud -- uvx mcp-isolarcloud

As a Claude Code plugin

This repo is also a Claude Code plugin marketplace, so the MCP server auto-registers when the plugin is enabled — no manual MCP config:

/plugin marketplace add KRoperUK/mcp-isolarcloud
/plugin install mcp-isolarcloud@mcp-isolarcloud

The plugin runs the published package via uvx mcp-isolarcloud.

What it exposes

Tools

• list_docs() — every documentation page (slug, title, type)
• read_doc(slug) — the full markdown of one page
• search_docs(query, limit=8) — keyword search, title-weighted, with snippets

Resources

• isolarcloud://docs/{slug} — each page as an MCP resource

Prompts (skills)

• find_control_parameter(what) — locate a dispatch/control parameter and its value encoding
• api_call_walkthrough(endpoint) — walk through calling a specific API endpoint

Updating the docs

The bundled docs are refreshed from the portal with:

pip install cryptography markdownify
python tools/refresh_docs.py

The portal's doc API is public (no login); refresh_docs.py reproduces its request-encryption scheme using the public keys embedded in the portal's own web app.

Development

uv venv && uv pip install -e '.[dev]'
ruff check src/ tests/
pytest

License

MIT