AgentHubAgentHub

Home Assistant MCP Server

MCP ServerMCP Registry官方收录

io.github.jarahkon/hass-mcp-server · v1.0.6

MCP server for full Home Assistant control — dashboards, files, automations, add-ons, and more

源仓库 ↗

概览

Home Assistant MCP Server 是一个MCP Server，收录自 官方 MCP Registry。支持 stdio 传输。本页提供 Cursor、Claude Code 等客户端的安装配置片段。

安装

选择你的平台查看安装方式

{
  "mcpServers": {
    "hass-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jarahkon/hass-mcp-server"
      ],
      "env": {
        "HA_URL": "<HA_URL>",
        "HA_TOKEN": "<HA_TOKEN>"
      }
    }
  }
}

环境变量

HA_URL必填

Home Assistant base URL (e.g. http://homeassistant.local:8123)

HA_TOKEN必填secret

Home Assistant long-lived access token

HA_SSH_HOST可选

SSH hostname for file management (optional)

HA_SSH_PORT可选

SSH port (default: 22)

HA_SSH_USER可选

SSH username (must be root)

HA_SSH_KEY_PATH可选

Path to SSH private key

HA_SSH_PASSWORD可选secret

SSH password (alternative to key)

相关资源

统一 Manifest

{
  "id": "io.github.jarahkon/hass-mcp-server",
  "type": "mcp-server",
  "version": "1.0.6",
  "displayName": "Home Assistant MCP Server",
  "description": "MCP server for full Home Assistant control — dashboards, files, automations, add-ons, and more",
  "repository": {
    "url": "https://github.com/jarahkon/hass-mcp-server",
    "source": "github"
  },
  "homepage": "https://github.com/jarahkon/hass-mcp-server",
  "distribution": {
    "packages": [
      {
        "registryType": "npm",
        "identifier": "@jarahkon/hass-mcp-server",
        "version": "1.0.6",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "HA_URL",
            "description": "Home Assistant base URL (e.g. http://homeassistant.local:8123)",
            "isRequired": true
          },
          {
            "name": "HA_TOKEN",
            "description": "Home Assistant long-lived access token",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "HA_SSH_HOST",
            "description": "SSH hostname for file management (optional)"
          },
          {
            "name": "HA_SSH_PORT",
            "description": "SSH port (default: 22)"
          },
          {
            "name": "HA_SSH_USER",
            "description": "SSH username (must be root)"
          },
          {
            "name": "HA_SSH_KEY_PATH",
            "description": "Path to SSH private key"
          },
          {
            "name": "HA_SSH_PASSWORD",
            "description": "SSH password (alternative to key)",
            "isSecret": true
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.jarahkon/hass-mcp-server",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.jarahkon%2Fhass-mcp-server/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}
Home Assistant MCP Server — MCP Server 安装与配置 · AgentHub