# 安装 io.github.homeassistant-ai/ha-mcp

- 类型: MCP 工具
- 说明: 通过 AI 助手连接并管理 Home Assistant 设备、状态与自动化流程。
- 仓库: https://github.com/homeassistant-ai/ha-mcp.git
- ⚠ 安全: 该 MCP 工具材料较少，但从名称与描述看主要用于通过 AI 助手管理 Home Assistant。基于官方 Registry、开源且近期有更新，供应链风险偏低；但其作为 MCP 服务端具备本机执行能力，且可能访问家庭自动化数据与控制面，因此整体以需留意为主。

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "io.github.homeassistant-ai/ha-mcp" MCP 服务：
执行：claude mcp add io-github-homeassistant-ai-ha-mcp -- npx -y ha-mcp
```

### Codex
```
请帮我安装 askskill 上的 "io.github.homeassistant-ai/ha-mcp" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-homeassistant-ai-ha-mcp]
command = "npx"
args = ["-y","ha-mcp"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "io.github.homeassistant-ai/ha-mcp" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-homeassistant-ai-ha-mcp": { "command": "npx", "args": ["-y","ha-mcp"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add io-github-homeassistant-ai-ha-mcp -- npx -y ha-mcp
```

### Codex
```bash
codex mcp add io-github-homeassistant-ai-ha-mcp -- npx -y ha-mcp
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-homeassistant-ai-ha-mcp]
command = "npx"
args = ["-y","ha-mcp"]
```

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-homeassistant-ai-ha-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ha-mcp"
      ]
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-homeassistant-ai-ha-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImhhLW1jcCJdfQ