zc-xiaozhi-tools

本仓库说明（二次开发版）：本项目基于 shenjingnan/xiaozhi-client（MIT）fork 并二次开发，更名为 xiaozhi-client-mcp-2026。在保留上游全部能力（小智客户端、多接入点、Web 配置、MCP 聚合、动态工具可见性）的基础上，新增 mcps/zc-xiaozhi-tools/ 模块——把原 zc-xiaozhi-mcp-tools 的 14 个 Python 工具（网页搜索 / 浏览器控制 opencli / 天气 / 文件剪贴板 / 记忆搜索）模块化迁入，作为外部 stdio MCP server 挂入本客户端。原作者版权与 MIT 许可保持不变（见 LICENSE、NOTICE）。

功能特色

• 支持 小智(xiaozhi.me) 官方服务器接入点

• 支持 作为普通 MCP Server 集成到 Cursor/Cherry Studio 等客户端

• 支持 配置多个小智接入点，实现多个小智设备共享一个 MCP 配置

• 支持 通过标准方式聚合多个 MCP Server

• 支持 动态控制 MCP Server 工具的可见性，避免由于无用工具过多导致的小智服务端异常

• 支持 本地化部署的开源服务端集成，你可以使用和小智官方服务端一样的 RPC 通信或直接使用标准 MCP 集成方式

• 支持 Web 网页可视化配置(允许自定义 IP 和端口，你能将 xiaozhi-client 部署在设备 A，然后在设备 B 通过网页控制 xiaozhi-client)

• 支持 集成 ModelScope 的远程 MCP 服务

• 支持 通过模板创建 xiaozhi-client 项目 (xiaozhi create <my-app> --template <template-name>)

• 支持 后台运行(xiaozhi start -d)

Related MCP server: Sentinel Core Agent

快速上手

你可以阅读文档 xiaozhi-client.shenjingnan.com 快速上手！

本地安装

前置条件：请先完成 Node.js >=22（推荐 24）与 pnpm 的安装

# 安装
pnpm install -g xiaozhi-client

# 创建应用
xiaozhi create my-app

# 进入应用目录
cd my-app

# 安装依赖
pnpm install

# 小智AI配置MCP接入点的 [使用说明](https://ccnphfhqs21z.feishu.cn/wiki/HiPEwZ37XiitnwktX13cEM5KnSb)
xiaozhi config set mcpEndpoint "<从小智服务端获取到的接入点地址>"

# 启动服务
xiaozhi start

# 浏览器打开 http://localhost:9999 如果你使用的是NAS部署请使用 http://<部署设备的IP地址>:9999

使用 Docker 运行

我们提供了预配置的 Docker 镜像，可以快速启动 xiaozhi-client 环境。

前置要求

• 已安装 Docker

• 已获取小智接入点地址（参见小智 AI 配置 MCP 接入点的使用说明）

快速启动

方式一：使用启动脚本（推荐）

curl -fsSL https://raw.githubusercontent.com/shenjingnan/xiaozhi-client/main/docker/scripts/start.sh | bash

无法访问 Github 可以使用 Gitee 替代

curl -fsSL https://gitee.com/shenjingnan/xiaozhi-client/raw/main/docker/scripts/start.sh | bash

方式二：使用 Docker Compose

获取 docker-compose.yml 文件：

curl -O https://raw.githubusercontent.com/shenjingnan/xiaozhi-client/main/docker/docker-compose.yml

无法访问 Github 可以使用 Gitee 替代

curl -O https://gitee.com/shenjingnan/xiaozhi-client/raw/main/docker/docker-compose.yml

# 使用 Docker Compose 启动
docker-compose up -d

# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down

贡献者