M
MCP Server for HomeAssistant 语音助手
goxofy/mcp-for-ha-conversation-agent
Hosted
0 Stars
79 次浏览
更新于 2026-08-23
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"ha-conversation": {
"args": [
"-y",
"mcp-for-ha-conversation"
],
"command": "npx",
"env": {
"HOME_ASSISTANT_AGENT_ID": "optional_agent_id",
"HOME_ASSISTANT_INSECURE": "true",
"HOME_ASSISTANT_TOKEN": "your_token_here",
"HOME_ASSISTANT_URL": "http://localhost:8123"
}
}
}
}该服务需要配置环境变量：HOME_ASSISTANT_AGENT_ID、HOME_ASSISTANT_INSECURE、HOME_ASSISTANT_TOKEN、HOME_ASSISTANT_URL
可用工具 （1 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
ha_conversation 1 个参数 需填 1 项
Send conversation request to Home Assistant conversation agent
必填参数：text
服务介绍
MCP Server for Home Assistant Conversation Agent
这是一个简单的 MCP 服务器，用于将用户的智能家居控制需求传递给 Home Assistant 的 conversation agent（语音助手）。
功能特性
- 将用户的对话原封不动地传递给 Home Assistant
- 支持 Home Assistant 的 conversation agent API
- 返回语音助手的完整响应结果
安装
- 克隆此仓库
- 安装依赖：
npm install
- 构建项目：
npm run build
作为 CLI 全局安装（从 npm）
npm install -g mcp-for-ha-conversation
安装后可直接运行：
mcp-for-ha-conversation
使用方法
配置 Home Assistant
- 确保您的 Home Assistant 实例正在运行
- 创建一个长期访问令牌（在 Home Assistant 设置 > 长期访问令牌中）
- 提供您的 Home Assistant URL
MCP 工具调用
服务器提供了一个工具 ha_conversation，参数如下：
text(必需): 要发送给 Home Assistant 的对话文本
示例调用
{
"name": "ha_conversation",
"arguments": {
"text": "请打开客厅的灯"
}
}
在 Claude Desktop 中配置
在您的 Claude Desktop 配置文件中添加：
{
"mcpServers": {
"ha-conversation": {
"command": "node",
"args": ["/path/to/your/server/dist/index.js"],
"env": {
"HOME_ASSISTANT_URL": "http://localhost:8123",
"HOME_ASSISTANT_TOKEN": "your_token_here",
"HOME_ASSISTANT_AGENT_ID": "optional_agent_id",
"HOME_ASSISTANT_INSECURE": "true" //(optional)
}
}
}
}
或使用全局安装的可执行文件：
{
"mcpServers": {
"ha-conversation": {
"command": "mcp-for-ha-conversation",
"env": {
"HOME_ASSISTANT_URL": "http://localhost:8123",
"HOME_ASSISTANT_TOKEN": "your_token_here",
"HOME_ASSISTANT_AGENT_ID": "optional_agent_id",
"HOME_ASSISTANT_INSECURE": "true" //(optional)
}
}
}
}
注意事项
- 确保您的 Home Assistant 实例可以从运行此服务器的机器访问
- 建议使用 HTTPS 来保护您的 Home Assistant 连接
- 此服务器会缓存您的 Home Assistant 配置，重启后需要重新提供
