解决Raycast中hass-mcp集成配置问题

解决Raycast中hass-mcp集成配置问题

hass-mcp Home Assistant MCP Server 项目地址: https://gitcode.com/gh_mirrors/ha/hass-mcp

在使用Raycast与Home Assistant的MCP服务器集成时，许多用户遇到了环境变量配置无效的问题。本文将深入分析问题原因并提供完整的解决方案。

问题现象

用户在Raycast中安装MCP服务器时，系统持续报错提示缺少Home Assistant的访问令牌(ha_token)。尽管用户已通过Raycast前端界面正确设置了ha_token和URL环境变量，但配置似乎未被正确识别。

根本原因分析

经过技术验证，发现问题的核心在于Raycast默认使用了npx命令来运行MCP服务器，而正确的运行方式应该是通过Docker容器。这种执行方式的差异导致了环境变量传递机制失效。

解决方案

要正确配置Raycast与MCP服务器的集成，需要手动调整运行参数：

1. 将执行命令(command)改为docker
2. 设置运行参数(arguments)为：

   run -i --rm -e HA_URL=http://homeassistant.local:8123 -e HA_TOKEN=YOURTOKEN voska/hass-mcp
   

配置详解

• run: 启动一个新容器
• -i: 保持STDIN打开，即使没有连接
• --rm: 容器退出后自动删除
• -e: 设置环境变量(可设置多个)
  • HA_URL: Home Assistant实例的访问地址
  • HA_TOKEN: Home Assistant的长期访问令牌
• voska/hass-mcp: 使用的Docker镜像名称

最佳实践建议

1. 对于本地Home Assistant实例，建议使用内部网络地址而非公网地址
2. 令牌权限应设置为最小必要权限原则
3. 定期轮换访问令牌以增强安全性
4. 考虑使用环境变量管理工具来统一管理敏感信息

通过以上配置调整，Raycast与MCP服务器的集成将能够正常工作，实现与Home Assistant系统的无缝对接。

hass-mcp Home Assistant MCP Server 项目地址: https://gitcode.com/gh_mirrors/ha/hass-mcp