家庭助理MCP服务器
🌟 赞助商
| 网站 | 描述 |
|---|---|
| ProductDirs.com | AI工具目录和发布平台-免费提交服务，用于发现和推广AI SaaS产品、初创公司和开发人员工具，并提供社区驱动的排名 |
| This Tools.app | AI SaaS发现平台-人工智能软件、自动化工具和生产力应用程序的免费列表目录，包含精心策划的集合 |
| AIImgCombiner.com | AI驱动的图像融合工具-免费在线服务，使用人工智能和预设风格以及自定义提示合并和组合照片，以获得专业效果 |
用于与家庭助理交互的模型上下文协议（MCP）服务器。此服务器提供工具，通过启用MCP的应用程序控制和监视您的家庭助理设备。
该项目是人工智能模型上下文协议（MCP）生态系统的一部分。有关MCP工具的更多信息和文档，请访问 www.aimcp.info.
特性
- 获取设备状态
- 控制装置状态（开/关）
- 触发自动
- 列出可用实体
安装
通过Smithery安装
通过以下方式自动安装Claude Desktop的家庭助理MCP服务器 史密瑟里:
npx -y @smithery/cli install @hekmon8/Homeassistant-server-mcp --client claude手动安装
- 克隆此存储库：
git clone https://github.com/yourusername/homeassistant-server-mcp.git
cd homeassistant-server-mcp- 安装依赖项：
npm install- 构建项目：
npm run build- 通过将以下内容添加到MCP设置文件（通常位于
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json对于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"
}
}
}
}替换 your-homeassistant-url 和 your-long-lived-access-token 使用您的家庭助理实例URL和访问令牌。
用法
服务器提供以下工具：
1.获取设备状态
// Example usage
use_mcp_tool({
server_name: "homeassistant",
tool_name: "get_state",
arguments: {
entity_id: "light.living_room"
}
});2.切换设备状态
// Example usage
use_mcp_tool({
server_name: "homeassistant",
tool_name: "toggle_entity",
arguments: {
entity_id: "switch.bedroom",
state: "on" // or "off"
}
});3.触发自动化
// Example usage
use_mcp_tool({
server_name: "homeassistant",
tool_name: "trigger_automation",
arguments: {
automation_id: "automation.morning_routine"
}
});4.列出实体
// Example usage
use_mcp_tool({
server_name: "homeassistant",
tool_name: "list_entities",
arguments: {
domain: "light" // optional, filters by domain
}
});贡献
欢迎投稿！以下是您可以提供帮助的方式：
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add some amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
请确保根据需要更新测试，并遵循现有的代码风格。
文档
有关MCP工具和生态系统的详细文档：
- 访问 www.aimcp.info
- 查看网站上的MCP工具目录
- 阅读集成指南和最佳实践
许可证
该项目根据麻省理工学院许可证获得许可，详情见下文：
MIT License
Copyright (c) 2024 homeassistant-mcp
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.安全
要安全地使用此服务器，请执行以下操作：
- 始终为您的家庭助理实例使用HTTPS
- 确保您的访问令牌安全，永远不要将其提交给版本控制
- 定期轮换您的访问令牌
- 对敏感信息使用环境变量
支持
如果您遇到任何问题或有疑问，请：
- 检查存储库中的现有问题
- 如果您的问题尚未报告，则创建新问题
- 在报告问题时提供尽可能多的背景信息
- 访问 www.aimcp.info 获取额外的支持资源
