--- bezeichner: "io.github.claymore666/ccu-mcp" art: "mcp_server" slug: "io-github-claymore666-ccu-mcp" paketkoordinate: "npm:ccu-mcp" status: "aktiv" homepage: "https://github.com/claymore666/ccu-mcp" erhebungsstand: "2026-10-10T01:17:01.464Z" namensraum: "io.github.claymore666" registerseite: "https://tracevero.de/mcp/io-github-claymore666-ccu-mcp" abgerufen_am: "2026-10-10" zugangsdaten_erforderlich: true ausfuehrungsort: "lokal" dateisystem_pfadargument: false quelloffen_einsehbar: true roh_beschreibung: "MCP server for controlling HomeMatic smart home devices via the CCU JSON-RPC API" version: "1.11.4" roh_umgebungsvariablen: "CCU_HOST, CCU_PASSWORD, CCU_USER, CCU_HTTPS, CCU_PORT, CACHE_DIR, MCP_ALLOWED_ORIGINS, MCP_ALLOWED_HOSTS, CCU_PROFILES, CCU_DEFAULT_PROFILE, CCU_TLS_VERIFY, CCU_TLS_FINGERPRINT, CCU_CA_CERT, CCU_TIMEOUT, CCU_SCRIPT_TIMEOUT, CACHE_TTL, CCU_RATE_LIMIT_BURST, CCU_RATE_LIMIT_RATE, RESOURCE_POLL_INTERVAL, LOG_LEVEL" roh_geheime_pflichtvariablen: "CCU_PASSWORD" roh_transportarten: "stdio" roh_pfadargumente: "" roh_repository_url: "https://github.com/claymore666/ccu-mcp" roh_paketquellen: "npm" roh_geheime_pflichtkopfzeilen: "" roh_pfad_umgebungsvariablen: "" roh_remote_adressen: "" roh_remote_hosts: "" roh_statusmeldung: "" roh_veroeffentlicht_am: "2026-10-07" roh_aktualisiert_am: "2026-10-07" roh_schemafassung: "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json" roh_bereitstellungsform: "paket" roh_repository_quelle: "github" roh_repository_unterordner: "" roh_paketbezeichner: "ccu-mcp" roh_paketversionen: "1.11.4" roh_laufzeithinweise: "npx" roh_umgebungsformate: "boolean, number, string" roh_umgebungsbeschreibungen: "CACHE_DIR=Directory for the device type cache and session persistence · CACHE_TTL=Lifetime of the on-disk device-type schema cache, in SECONDS · CCU_CA_CERT=Path to a PEM file holding the CCU's CA or self-signed certificate. The connection is then validated against it with standard chain verification · CCU_DEFAULT_PROFILE=Which profile from CCU_PROFILES is active at startup (default: the first listed) · CCU_HOST=Hostname or IP of your HomeMatic CCU (debmatic, CCU3, or OpenCCU/RaspberryMatic) · CCU_HTTPS=Connect to the CCU via HTTPS (self-signed certificates supported) · CCU_PASSWORD=CCU admin password (same as the WebUI login). Must be set; the value may be empty for a CCU with no password · CCU_PORT=CCU API port (80 for HTTP, 443 for HTTPS) · CCU_PROFILES=Comma-separated names of multiple CCU targets (e.g. 'prod,dev'). Each profile takes the flat CCU_* settings prefixed CCU__ (CCU_PROD_HOST, ...), plus policy flags CCU__PROTECTED (writes need confirm:true) and CCU__READONLY. Unset = single default profile from the flat CCU_* vars · CCU_RATE_LIMIT_BURST=Token-bucket burst size for CCU requests — how many may be issued back to back · CCU_RATE_LIMIT_RATE=Sustained CCU request rate, in requests per second · CCU_SCRIPT_TIMEOUT=Timeout for HomeMatic Script execution (ReGa), in MILLISECONDS — scripts are slower than plain API calls · CCU_TIMEOUT=Timeout for a CCU JSON-RPC call, in MILLISECONDS · CCU_TLS_FINGERPRINT=Pin the CCU's self-signed leaf certificate by its SHA-256 fingerprint (hex, colons optional). The strongest option for an appliance: the connection is rejected unless the presented certificate matches. Takes precedence over CCU_CA_CERT · CCU_TLS_VERIFY=Verify the CCU's TLS certificate against the system trust store. Only meaningful with CCU_HTTPS=true. Default false, because a CCU ships a self-signed certificate — prefer CCU_TLS_FINGERPRINT or CCU_CA_CERT to verify one of those · CCU_USER=CCU username · LOG_LEVEL=error | warn | info | debug. Logs are structured JSON on stderr · MCP_ALLOWED_HOSTS=Extra Host header values accepted by DNS-rebinding protection (comma-separated host:port); add your hostname when behind a proxy or container DNS name · MCP_ALLOWED_ORIGINS=Comma-separated allowlist of browser origins. Unset = no cross-origin browser access (default-deny). An allowlisted origin is reflected exactly in Access-Control-Allow-Origin (never '*'); the list also drives DNS-rebinding origin checks · RESOURCE_POLL_INTERVAL=How often MCP resources are polled for change notifications, in SECONDS" roh_symbolformate: "" roh_verbindungswege: "{\"packages\":[{\"registryType\":\"npm\",\"identifier\":\"ccu-mcp\",\"version\":\"1.11.4\",\"runtimeHint\":\"npx\",\"transport\":\"stdio\",\"environment\":[{\"name\":\"CCU_HOST\",\"description\":\"Hostname or IP of your HomeMatic CCU (debmatic, CCU3, or OpenCCU/RaspberryMatic)\",\"format\":\"string\",\"required\":true,\"secret\":false},{\"name\":\"CCU_PASSWORD\",\"description\":\"CCU admin password (same as the WebUI login). Must be set; the value may be empty for a CCU with no password\",\"format\":\"string\",\"required\":true,\"secret\":true},{\"name\":\"CCU_USER\",\"description\":\"CCU username\",\"format\":\"string\",\"required\":false,\"secret\":false},{\"name\":\"CCU_HTTPS\",\"description\":\"Connect to the CCU via HTTPS (self-signed certificates supported)\",\"format\":\"boolean\",\"required\":false,\"secret\":false},{\"name\":\"CCU_PORT\",\"description\":\"CCU API port (80 for HTTP, 443 for HTTPS)\",\"format\":\"number\",\"required\":false,\"secret\":false},{\"name\":\"CACHE_DIR\",\"description\":\"Directory for the device type cache and session persistence\",\"format\":\"string\",\"required\":false,\"secret\":false},{\"name\":\"MCP_ALLOWED_ORIGINS\",\"description\":\"Comma-separated allowlist of browser origins. Unset = no cross-origin browser access (default-deny). An allowlisted origin is reflected exactly in Access-Control-Allow-Origin (never '*'); the list also drives DNS-rebinding origin checks\",\"format\":\"string\",\"required\":false,\"secret\":false},{\"name\":\"MCP_ALLOWED_HOSTS\",\"description\":\"Extra Host header values accepted by DNS-rebinding protection (comma-separated host:port); add your hostname when behind a proxy or container DNS name\",\"format\":\"string\",\"required\":false,\"secret\":false},{\"name\":\"CCU_PROFILES\",\"description\":\"Comma-separated names of multiple CCU targets (e.g. 'prod,dev'). Each profile takes the flat CCU_* settings prefixed CCU__ (CCU_PROD_HOST, ...), plus policy flags CCU__PROTECTED (writes need confirm:true) and CCU__READONLY. Unset = single default profile from the flat CCU_* vars\",\"format\":\"string\",\"required\":false,\"secret\":false},{\"name\":\"CCU_DEFAULT_PROFILE\",\"description\":\"Which profile from CCU_PROFILES is active at startup (default: the first listed)\",\"format\":\"string\",\"required\":false,\"secret\":false},{\"name\":\"CCU_TLS_VERIFY\",\"description\":\"Verify the CCU's TLS certificate against the system trust store. Only meaningful with CCU_HTTPS=true. Default false, because a CCU ships a self-signed certificate — prefer CCU_TLS_FINGERPRINT or CCU_CA_CERT to verify one of those\",\"format\":\"boolean\",\"required\":false,\"secret\":false},{\"name\":\"CCU_TLS_FINGERPRINT\",\"description\":\"Pin the CCU's self-signed leaf certificate by its SHA-256 fingerprint (hex, colons optional). The strongest option for an appliance: the connection is rejected unless the presented certificate matches. Takes precedence over CCU_CA_CERT\",\"format\":\"string\",\"required\":false,\"secret\":false},{\"name\":\"CCU_CA_CERT\",\"description\":\"Path to a PEM file holding the CCU's CA or self-signed certificate. The connection is then validated against it with standard chain verification\",\"format\":\"string\",\"required\":false,\"secret\":false},{\"name\":\"CCU_TIMEOUT\",\"description\":\"Timeout for a CCU JSON-RPC call, in MILLISECONDS\",\"format\":\"number\",\"required\":false,\"secret\":false},{\"name\":\"CCU_SCRIPT_TIMEOUT\",\"description\":\"Timeout for HomeMatic Script execution (ReGa), in MILLISECONDS — scripts are slower than plain API calls\",\"format\":\"number\",\"required\":false,\"secret\":false},{\"name\":\"CACHE_TTL\",\"description\":\"Lifetime of the on-disk device-type schema cache, in SECONDS\",\"format\":\"number\",\"required\":false,\"secret\":false},{\"name\":\"CCU_RATE_LIMIT_BURST\",\"description\":\"Token-bucket burst size for CCU requests — how many may be issued back to back\",\"format\":\"number\",\"required\":false,\"secret\":false},{\"name\":\"CCU_RATE_LIMIT_RATE\",\"description\":\"Sustained CCU request rate, in requests per second\",\"format\":\"number\",\"required\":false,\"secret\":false},{\"name\":\"RESOURCE_POLL_INTERVAL\",\"description\":\"How often MCP resources are polled for change notifications, in SECONDS\",\"format\":\"number\",\"required\":false,\"secret\":false},{\"name\":\"LOG_LEVEL\",\"description\":\"error | warn | info | debug. Logs are structured JSON on stderr\",\"format\":\"string\",\"required\":false,\"secret\":false}],\"additional_arguments_declared\":true}],\"remotes\":[]}" --- # io.github.claymore666/ccu-mcp ## Gemessene Werte | Merkmal | Wert | Quelle | Erhoben am | Vertrauensgrad | Rohangabe | | --- | --- | --- | --- | --- | --- | | Pflicht-Geheimnisse deklariert | true | MCP-Register | 2026-08-06T13:57:41.838Z | abgeleitet | roh_geheime_pflichtvariablen: CCU_PASSWORD; roh_geheime_pflichtkopfzeilen: | | Ausführungsort | lokal | MCP-Register | 2026-08-06T13:57:41.838Z | abgeleitet | roh_transportarten: stdio | | Pfadargument vorhanden | false | MCP-Register | 2026-08-06T13:57:41.838Z | abgeleitet | roh_pfadargumente: ; roh_pfad_umgebungsvariablen: | | Repository-Adresse geführt | true | MCP-Register | 2026-08-06T13:57:41.838Z | abgeleitet | roh_repository_url: https://github.com/claymore666/ccu-mcp | | Beschreibung (Rohangabe) | MCP server for controlling HomeMatic smart home devices via the CCU JSON-RPC API | MCP-Register | 2026-08-26T16:45:01.514Z | selbstauskunft | | | Deklarierte Version | 1.11.4 | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft | | | Umgebungsvariablen (Rohangabe) | CCU_HOST, CCU_PASSWORD, CCU_USER, CCU_HTTPS, CCU_PORT, CACHE_DIR, MCP_ALLOWED_ORIGINS, MCP_ALLOWED_HOSTS, CCU_PROFILES, CCU_DEFAULT_PROFILE, CCU_TLS_VERIFY, CCU_TLS_FINGERPRINT, CCU_CA_CERT, CCU_TIMEOUT, CCU_SCRIPT_TIMEOUT, CACHE_TTL, CCU_RATE_LIMIT_BURST, CCU_RATE_LIMIT_RATE, RESOURCE_POLL_INTERVAL, LOG_LEVEL | MCP-Register | 2026-08-06T13:57:41.838Z | selbstauskunft | | | Geheime Pflichtvariablen (Rohangabe) | CCU_PASSWORD | MCP-Register | 2026-08-06T13:57:41.838Z | selbstauskunft | | | Transportarten (Rohangabe) | stdio | MCP-Register | 2026-08-06T13:57:41.838Z | selbstauskunft | | | Pfadargumente (Rohangabe) | | MCP-Register | 2026-08-06T13:57:41.838Z | selbstauskunft | | | Repository (Rohangabe) | https://github.com/claymore666/ccu-mcp | MCP-Register | 2026-08-06T13:57:41.838Z | selbstauskunft | | | Paketquellen (Rohangabe) | npm | MCP-Register | 2026-08-06T13:57:41.838Z | selbstauskunft | | | Geheime Pflichtkopfzeilen (Rohangabe) | | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft | | | Pfad-Umgebungsvariablen (Rohangabe) | | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft | | | Remote-Adressen (Rohangabe) | | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft | | | Remote-Hosts (Rohangabe) | | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft | | | Statusmeldung des Registers (Rohangabe) | | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft | | | Im Register eingetragen am (Rohangabe) | 2026-10-07 | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft | | | Im Register geändert am (Rohangabe) | 2026-10-07 | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft | | | Schemafassung des Rohsatzes (Rohangabe) | https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft | | | Bereitstellungsform (Rohangabe) | paket | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft | | | Repository-Plattform (Rohangabe) | github | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft | | | Repository-Unterordner (Rohangabe) | | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft | | | Paketbezeichner (Rohangabe) | ccu-mcp | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft | | | Paketversionen (Rohangabe) | 1.11.4 | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft | | | Laufzeithinweise (Rohangabe) | npx | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft | | | Formate der Umgebungsvariablen (Rohangabe) | boolean, number, string | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft | | | Beschreibungen der Umgebungsvariablen (Rohangabe) | CACHE_DIR=Directory for the device type cache and session persistence · CACHE_TTL=Lifetime of the on-disk device-type schema cache, in SECONDS · CCU_CA_CERT=Path to a PEM file holding the CCU's CA or self-signed certificate. The connection is then validated against it with standard chain verification · CCU_DEFAULT_PROFILE=Which profile from CCU_PROFILES is active at startup (default: the first listed) · CCU_HOST=Hostname or IP of your HomeMatic CCU (debmatic, CCU3, or OpenCCU/RaspberryMatic) · CCU_HTTPS=Connect to the CCU via HTTPS (self-signed certificates supported) · CCU_PASSWORD=CCU admin password (same as the WebUI login). Must be set; the value may be empty for a CCU with no password · CCU_PORT=CCU API port (80 for HTTP, 443 for HTTPS) · CCU_PROFILES=Comma-separated names of multiple CCU targets (e.g. 'prod,dev'). Each profile takes the flat CCU_* settings prefixed CCU__ (CCU_PROD_HOST, ...), plus policy flags CCU__PROTECTED (writes need confirm:true) and CCU__READONLY. Unset = single default profile from the flat CCU_* vars · CCU_RATE_LIMIT_BURST=Token-bucket burst size for CCU requests — how many may be issued back to back · CCU_RATE_LIMIT_RATE=Sustained CCU request rate, in requests per second · CCU_SCRIPT_TIMEOUT=Timeout for HomeMatic Script execution (ReGa), in MILLISECONDS — scripts are slower than plain API calls · CCU_TIMEOUT=Timeout for a CCU JSON-RPC call, in MILLISECONDS · CCU_TLS_FINGERPRINT=Pin the CCU's self-signed leaf certificate by its SHA-256 fingerprint (hex, colons optional). The strongest option for an appliance: the connection is rejected unless the presented certificate matches. Takes precedence over CCU_CA_CERT · CCU_TLS_VERIFY=Verify the CCU's TLS certificate against the system trust store. Only meaningful with CCU_HTTPS=true. Default false, because a CCU ships a self-signed certificate — prefer CCU_TLS_FINGERPRINT or CCU_CA_CERT to verify one of those · CCU_USER=CCU username · LOG_LEVEL=error \| warn \| info \| debug. Logs are structured JSON on stderr · MCP_ALLOWED_HOSTS=Extra Host header values accepted by DNS-rebinding protection (comma-separated host:port); add your hostname when behind a proxy or container DNS name · MCP_ALLOWED_ORIGINS=Comma-separated allowlist of browser origins. Unset = no cross-origin browser access (default-deny). An allowlisted origin is reflected exactly in Access-Control-Allow-Origin (never '*'); the list also drives DNS-rebinding origin checks · RESOURCE_POLL_INTERVAL=How often MCP resources are polled for change notifications, in SECONDS | MCP-Register | 2026-09-03T01:17:02.023Z | selbstauskunft | | | Symbolformate (Rohangabe) | | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft | | | Verbindungswege (Quellstruktur) | {"packages":[{"registryType":"npm","identifier":"ccu-mcp","version":"1.11.4","runtimeHint":"npx","transport":"stdio","environment":[{"name":"CCU_HOST","description":"Hostname or IP of your HomeMatic CCU (debmatic, CCU3, or OpenCCU/RaspberryMatic)","format":"string","required":true,"secret":false},{"name":"CCU_PASSWORD","description":"CCU admin password (same as the WebUI login). Must be set; the value may be empty for a CCU with no password","format":"string","required":true,"secret":true},{"name":"CCU_USER","description":"CCU username","format":"string","required":false,"secret":false},{"name":"CCU_HTTPS","description":"Connect to the CCU via HTTPS (self-signed certificates supported)","format":"boolean","required":false,"secret":false},{"name":"CCU_PORT","description":"CCU API port (80 for HTTP, 443 for HTTPS)","format":"number","required":false,"secret":false},{"name":"CACHE_DIR","description":"Directory for the device type cache and session persistence","format":"string","required":false,"secret":false},{"name":"MCP_ALLOWED_ORIGINS","description":"Comma-separated allowlist of browser origins. Unset = no cross-origin browser access (default-deny). An allowlisted origin is reflected exactly in Access-Control-Allow-Origin (never '*'); the list also drives DNS-rebinding origin checks","format":"string","required":false,"secret":false},{"name":"MCP_ALLOWED_HOSTS","description":"Extra Host header values accepted by DNS-rebinding protection (comma-separated host:port); add your hostname when behind a proxy or container DNS name","format":"string","required":false,"secret":false},{"name":"CCU_PROFILES","description":"Comma-separated names of multiple CCU targets (e.g. 'prod,dev'). Each profile takes the flat CCU_* settings prefixed CCU__ (CCU_PROD_HOST, ...), plus policy flags CCU__PROTECTED (writes need confirm:true) and CCU__READONLY. Unset = single default profile from the flat CCU_* vars","format":"string","required":false,"secret":false},{"name":"CCU_DEFAULT_PROFILE","description":"Which profile from CCU_PROFILES is active at startup (default: the first listed)","format":"string","required":false,"secret":false},{"name":"CCU_TLS_VERIFY","description":"Verify the CCU's TLS certificate against the system trust store. Only meaningful with CCU_HTTPS=true. Default false, because a CCU ships a self-signed certificate — prefer CCU_TLS_FINGERPRINT or CCU_CA_CERT to verify one of those","format":"boolean","required":false,"secret":false},{"name":"CCU_TLS_FINGERPRINT","description":"Pin the CCU's self-signed leaf certificate by its SHA-256 fingerprint (hex, colons optional). The strongest option for an appliance: the connection is rejected unless the presented certificate matches. Takes precedence over CCU_CA_CERT","format":"string","required":false,"secret":false},{"name":"CCU_CA_CERT","description":"Path to a PEM file holding the CCU's CA or self-signed certificate. The connection is then validated against it with standard chain verification","format":"string","required":false,"secret":false},{"name":"CCU_TIMEOUT","description":"Timeout for a CCU JSON-RPC call, in MILLISECONDS","format":"number","required":false,"secret":false},{"name":"CCU_SCRIPT_TIMEOUT","description":"Timeout for HomeMatic Script execution (ReGa), in MILLISECONDS — scripts are slower than plain API calls","format":"number","required":false,"secret":false},{"name":"CACHE_TTL","description":"Lifetime of the on-disk device-type schema cache, in SECONDS","format":"number","required":false,"secret":false},{"name":"CCU_RATE_LIMIT_BURST","description":"Token-bucket burst size for CCU requests — how many may be issued back to back","format":"number","required":false,"secret":false},{"name":"CCU_RATE_LIMIT_RATE","description":"Sustained CCU request rate, in requests per second","format":"number","required":false,"secret":false},{"name":"RESOURCE_POLL_INTERVAL","description":"How often MCP resources are polled for change notifications, in SECONDS","format":"number","required":false,"secret":false},{"name":"LOG_LEVEL","description":"error \| warn \| info \| debug. Logs are structured JSON on stderr","format":"string","required":false,"secret":false}],"additional_arguments_declared":true}],"remotes":[]} | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft | | ## Verweise - Namensraum: [[namensraum/io-github-claymore666|io.github.claymore666]] --- - Registerseite: - Abgerufen am: 2026-10-10