项目简介

本项目是一个为 Home Assistant 设计的附加组件 (Add-on)，它充当 Model Context Protocol (MCP) 服务器的中心枢纽。其主要功能是连接和管理多个后端 MCP 服务器（支持 Stdio 和 SSE 协议），将这些后端服务器提供的工具 (Tools) 和资源 (Resources) 聚合起来，并通过一个统一的接口（Stdio 或 SSE）暴露给 MCP 客户端（通常是大型语言模型 LLM 应用）。这使得 LLM 客户端可以通过一个连接访问来自不同 MCP 服务器的能力。

主要功能点

• 统一接口： 为 MCP 客户端提供一个单一的接入点，方便访问背后多个 MCP 服务器聚合的能力。
• 后端管理： 能够轻松连接、配置、管理和监控多个独立的 MCP 后端服务。
• 网页管理界面： 提供一个直观的网页用户界面，方便用户管理连接的 MCP 服务器及其提供的工具。
• 工具精细控制： 用户可以通过网页界面启用/禁用单个工具，并自定义其在客户端中显示的名称和描述。
• 实时安装监控： 对于通过 Stdio 协议连接的后端服务器，可以在网页界面中实时跟踪其安装或启动进度。
• 可选网页终端： 管理界面中内置可选的命令行终端，方便高级用户进行直接操作和调试。

安装步骤

本项目是 Home Assistant 的一个 Add-on，可以通过 Home Assistant 的 Supervisor 进行安装。

1. 在您的 Home Assistant 界面中，导航到 Supervisor（或 Add-ons）菜单。
2. 点击右上角的 Add-on Store。
3. 再次点击右上角的三个点菜单，选择 Repositories。
4. 在弹出的对话框中，将本仓库的 URL 'https://github.com/ptbsare/home-assistant-addons' 粘贴到输入框中，然后点击 Add。
5. 关闭对话框，刷新 Add-on Store 页面。现在您应该能在页面中看到一个新的分类 ptbsare's Add-ons，其中包含了 MCP Proxy Server 附加组件。
6. 点击 MCP Proxy Server 进入详情页面，然后点击 Install 按钮进行安装。
7. 安装完成后，请根据需要配置附加组件（例如网络端口等），并从 Add-on 页面启动它。

服务器配置

MCP 客户端需要通过配置来连接到 MCP Proxy Server。常见的 MCP 客户端配置通常需要以下信息：

• 服务器名称 (server name)： 一个用于标识此 MCP 服务器的名称，您可以设定为 '"MCP Proxy Server"' 或其他描述性名称。
• 连接方式： MCP Proxy Server 支持 Stdio 或基于网络的连接（如 SSE）。
  • Stdio 模式： 如果您的 MCP 客户端设计为启动一个进程并通过其标准输入/输出进行通信，则需要配置启动 MCP Proxy Server 进程的命令 (command) 和参数 (args)。例如：
    • 'command': MCP Proxy Server 可执行文件在 Home Assistant Add-on 环境内的完整路径（例如 '/path/to/mcp_proxy_server_executable'）。
    • 'args': 传递给可执行文件的命令行参数列表（例如 '["--protocol", "stdio", "...其他参数"]'）。 请注意： 具体的可执行文件路径和所需参数取决于 Add-on 的内部实现和安装路径，这些信息通常需要查阅 Add-on 的日志或详细文档才能确定，无法直接从公开仓库描述中获取准确值。
  • 基于网络的模式 (如 SSE)： 如果客户端通过网络连接（通常是对于 Home Assistant Add-on 更方便的方式），则客户端配置需要指定服务器的主机名/IP 地址 (host)、端口 (port) 以及使用的协议 (protocol)。主机名通常是运行 Home Assistant 的机器地址，端口需要在 Add-on 配置中指定。

重要提示： 上述是 MCP 客户端连接服务器所需配置信息的概念性描述。实际配置格式和具体字段可能因您使用的 MCP 客户端软件不同而有差异。对于 Home Assistant Add-on，网络连接方式可能比 Stdio 方式更常见。请务必参考您所使用的 MCP 客户端软件的文档，并结合 MCP Proxy Server Add-on 的具体配置（例如网络端口）进行设置。

基本使用方法

1. 确保 MCP Proxy Server Add-on 已通过 Home Assistant Supervisor 启动并运行。
2. 通过 Home Assistant 界面访问 MCP Proxy Server Add-on 的网页界面（通常在 Add-on 页面有“Web UI”或类似链接）。
3. 在 MCP Proxy Server 的网页界面中，添加并配置您希望连接的后端 MCP 服务器（指定它们的连接方式和地址）。
4. 配置您的 MCP 客户端（如支持 MCP 的 LLM 应用或代理）连接到 MCP Proxy Server 暴露的接口（根据配置可能是 Stdio 管道或网络地址）。
5. 连接成功后，您的 MCP 客户端即可通过 MCP Proxy Server 统一访问所有已配置和管理的后端 MCP 服务器提供的工具和资源。