hekmon8/homeassistant-server-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

48 stars 7 forks 质量 76 趋势 13MIT

Repository Install

一台用于与Home Assistant交互的模型上下文协议（MCP）服务器。该服务器提供通过支持MCP的应用程序控制和监控Home Assistant设备的工具。

概览

一台用于与Home Assistant交互的模型上下文协议（MCP）服务器。该服务器提供通过支持MCP的应用程序控制和监控Home Assistant设备的工具。该项目是AI模型上下文协议（MCP）生态系统的一部分。欲了解更多关于MCP工具的信息和文档，请访问 www.aimcp.info。 - 获取设备状态 - 控制设备状态（开/关） - 触发自动化 - 列出可用实体通过Smithery自动安装Home Assistant MCP Server用于Claude Desktop： 4. 通过在 MCP 设置文件中添加以下内容来配置 MCP 服务器（通常位于 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json for VSCode ）：将your-homeassistant-url和your-long-lived-access-token替换为Home Assistant实例URL和访问令牌。服务器提供以下工具：欢迎大家贡献！以下是您可以提供帮助的方式：

概述（AI 翻译）

🌟 赞助商

网站	简介
ProductDirs.com	AI工具目录与发布平台——免费提交服务，用于发现和推广具有社区驱动排名的AI软件即服务产品、初创企业及开发者工具
ThisTools.app	AI SaaS 发现平台——人工智能软件、自动化工具和生产力应用的免费目录，包含精选收藏
AIImgCombiner.com	AI驱动图像融合工具——免费在线服务，利用人工智能结合预设样式和自定义提示，实现专业效果

一台用于与Home Assistant交互的模型上下文协议（MCP）服务器。该服务器提供通过支持MCP的应用程序控制和监控Home Assistant设备的工具。

该项目是AI模型上下文协议（MCP）生态系统的一部分。欲了解更多关于MCP工具的信息和文档，请访问 www.aimcp.info。

特色

获取设备状态
控制设备状态（开/关）
触发自动化
列出可用实体

安装

通过Smithery安装

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

Home Assistant MCP Server

🌟 Sponsors

Website	Description
ProductDirs.com	AI Tools Directory & Launch Platform - Free submission service for discovering and promoting AI SaaS products, startups, and developer tools with community-driven rankings
ThisTools.app	AI SaaS Discovery Platform - Free listing directory for artificial intelligence software, automation tools, and productivity applications with curated collections
AIImgCombiner.com	AI-Powered Image Fusion Tool - Free online service for merging and combining photos using artificial intelligence with preset styles and custom prompts for professional results

A Model Context Protocol (MCP) server for interacting with Home Assistant. This server provides tools to control and monitor your Home Assistant devices through MCP-enabled applications.

This project is part of the AI Model Context Protocol (MCP) ecosystem. For more information and documentation about MCP tools, visit www.aimcp.info.

Features

Get device states
Control device states (on/off)
Trigger automations
List available entities

Installation

Installing via Smithery

To install Home Assistant MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @hekmon8/Homeassistant-server-mcp --client claude

Manual Installation

Clone this repository:

git clone https://github.com/yourusername/homeassistant-server-mcp.git
cd homeassistant-server-mcp

Install dependencies:

npm install

Build the project:

npm run build

Configure the MCP server by adding the following to your MCP settings file (typically located at ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json for VSCode):

{
  "mcpServers": {
    "homeassistant": {
      "command": "node",
      "args": ["/path/to/homeassistant-mcp/homeassistant-server/build/index.js"],
      "env": {
        "HA_URL": "http://your-homeassistant-url:8123",
        "HA_TOKEN": "your-long-lived-access-token"
      }
    }
  }
}

Replace your-homeassistant-url and your-long-lived-access-token with your Home Assistant instance URL and access token.

Usage

The server provides the following tools:

1. Get Device State

// Example usage
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "get_state",
  arguments: {

在 GitHub 查看完整 README

安装

npx -y @smithery/cli install @hekmon8/Homeassistant-server-mcp --client claude

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "homeassistant": {
      "command": "node",
      "args": ["/path/to/homeassistant-mcp/homeassistant-server/build/index.js"],
      "env": {
        "HA_URL": "http://your-homeassistant-url:8123",
        "HA_TOKEN": "your-long-lived-access-token"
      }
    }
  }
}