# miguelg719
## 基本信息
- Slug: `miguelg719-home-assistant-mcp`
- Source: modelscope
- Publisher: @miguelg719/home-assistant-mcp
- Categories: home-automation-and-iot / os-automation
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@miguelg719/home-assistant-mcp
## 简介
暂无描述。
## MCP Server 详情

# <img src="./img/ha.png" height="30" style="border-radius: 250%; margin: 0 5px;"> 🤝 <img src="./img/mcp.png" height="30" style="border-radius: 20%; margin: 0 5px;"> Home Assistant MCP 服务器

这是一个与 Home Assistant 集成的 Model Context Protocol (MCP) 服务器项目，旨在提供智能家居控制功能。

### 提示

该服务器为每个域的工具集提供了提示。

### 工具

该服务器实现了对各种 Home Assistant 域的控制。目前支持：
- 💡 灯光：开关、亮度控制
- 🌡️ 气候：温度控制、暖通空调模式
- 🔒 锁：锁定/解锁功能
- 🚨 报警控制面板：布防/撤防安全系统
- 💧 加湿器：湿度控制

示例工具包括：


light-turn_on()
climate-turn_off()
alarm_control_panel-disarm()
lock-lock()
humidifier-turn_off()


## 配置

### 环境变量

在根目录下创建一个 `.env` 文件，并添加以下内容：


HOMEASSISTANT_TOKEN=your_long_lived_access_token_here # 从您的 Home Assistant 实例中获取
HOMEASSISTANT_BASE_URL=your_home_assistant_url_here # 例如 http://homeassistant.local:8123


## 快速开始

### 安装

请按照说明安装 Home Assistant 并获取长期访问令牌。
- [Home Assistant 入门指南](https://www.home-assistant.io/getting-started/)

#### Claude Desktop

在 MacOS 上：`~/Library/Application Support/Claude/claude_desktop_config.json`
在 Windows 上：`%APPDATA%/Claude/claude_desktop_config.json`

<details>
  <summary>开发/未发布的服务器配置</summary>
  
  "mcpServers": {
    "home-assistant-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/home-assistant-server",
        "run",
        "home-assistant-server"
      ]
    }
  }
  
</details>

<details>
  <summary>已发布的服务器配置</summary>
  
  "mcpServers": {
    "home-assistant-server": {
      "command": "uvx",
      "args": [
        "home-assistant-server"
      ]
    }
  }
  
</details>

## 开发

### 构建和发布

准备分发包：

1. 同步依赖项并更新锁文件：
bash
uv sync


2. 构建包分发：
bash
uv build


这将在 `dist/` 目录中创建源码和 wheel 分发。

3. 发布到 PyPI：
bash
uv publish


注意：您需要通过环境变量或命令标志设置 PyPI 凭证：
- 令牌：`--token` 或 `UV_PUBLISH_TOKEN`
- 或用户名/密码：`--username`/`UV_PUBLISH_USERNAME` 和 `--password`/`UV_PUBLISH_PASSWORD`

### 调试

由于 MCP 服务器通过 stdio 运行，调试可能会比较困难。为了获得最佳调试体验，我们强烈建议使用 [MCP Inspector](https://github.com/modelcontextprotocol/inspector)。

您可以使用 [`npm`](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) 通过以下命令启动 MCP Inspector：

bash
npx @modelcontextprotocol/inspector uv --directory /Users/miguel/Documents/home-assistant-server/home-assistant-server run home-assistant-server


启动后，Inspector 将显示一个 URL，您可以在浏览器中访问该 URL 以开始调试。

## 贡献

感谢您对本项目的贡献感兴趣！

请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 获取指南。

## 许可

MIT 许可 - 详情请参见 [LICENSE](LICENSE)。