{"id":"shawn996-mcp-ha-xiaozhi","name":"mcp_ha_xiaozhi","homepage":null,"repo_url":"https://github.com/shawn996/mcp_ha_xiaozhi","category":"automation","subcategories":[],"tags":["mcp","home-assistant","docker","python","automation","home-automation","agent-integration"],"what_it_does":"A Docker-deployable MCP proxy/service that connects “XiaoZhi (小智) official server” to a Home Assistant MCP server, using environment variables to specify the XiaoZhi MCP endpoint, the Home Assistant MCP server endpoint, and a long-lived Home Assistant access token.","use_cases":["Connect an XiaoZhi official MCP endpoint to Home Assistant’s MCP server via an intermediary MCP proxy","Enable agents to control/query Home Assistant through MCP while originating from XiaoZhi’s side","Bridge existing XiaoZhi example code to a Home Assistant MCP integration"],"not_for":["Direct interaction with Home Assistant’s REST API (it’s described as MCP-based proxying)","Production deployments requiring well-specified, first-party API contracts (limited documentation provided here)"],"best_when":"You already have Home Assistant’s MCP Server integration configured and you want a simple bridge to XiaoZhi’s MCP endpoint using Docker.","avoid_when":"You need strong guarantees about interface stability, error semantics, rate limiting behavior, or documented authentication/authorization scope granularity beyond the provided token.","alternatives":["Use Home Assistant’s MCP server integration directly with your agent/tooling","Build a custom MCP proxy/gateway using official MCP libraries and Home Assistant integration primitives","If available, use any vendor-supported MCP bridging/proxy solution for XiaoZhi and Home Assistant"],"af_score":38.2,"security_score":51.2,"reliability_score":31.2,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:22:39.188943+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":false,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Long-lived Home Assistant access token (API_ACCESS_TOKEN)"],"oauth":false,"scopes":false,"notes":"README indicates using a Home Assistant long-lived access token to authorize access to the Home Assistant instance. No OAuth or explicit MCP auth scheme details are provided in the provided content."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing information provided in the supplied README/metadata."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":38.2,"security_score":51.2,"reliability_score":31.2,"mcp_server_quality":35.0,"documentation_accuracy":45.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":70.0,"rate_limit_clarity":10.0,"tls_enforcement":70.0,"auth_strength":55.0,"scope_granularity":20.0,"dependency_hygiene":50.0,"secret_handling":60.0,"security_notes":"TLS is not explicitly stated in the provided README. Authentication appears to rely on a long-lived Home Assistant access token, likely with broad permissions; no evidence of fine-grained scopes or explicit MCP-level authorization controls in the provided content. Docker env var usage suggests operational convenience, but secret-handling practices (logging/redaction) are not documented here.","uptime_documented":0.0,"version_stability":50.0,"breaking_changes_history":50.0,"error_recovery":25.0,"idempotency_support":"false","idempotency_notes":"Not documented; MCP calls may be non-idempotent depending on underlying Home Assistant actions.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["No documented MCP tool list, schemas, or error codes in the provided content; agent integration may require inspecting runtime behavior.","Token is a long-lived Home Assistant token; treat as high-privilege credential.","Rate limits and backoff/retry guidance are not described in the provided content."]}}