# xiaozhi

**Repository Path**: ppx2013/xiaozhi

## Basic Information

- **Project Name**: xiaozhi
- **Description**: 原生mcp版小智
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-08
- **Last Updated**: 2026-08-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 小智 AI 聊天机器人

（中文 | [English](README.md)）

## 介绍

小智 AI 聊天机器人是一个基于 ESP32 的语音交互设备，利用 Qwen / DeepSeek 等大模型的 AI 能力，通过 MCP 协议实现多端控制。

## ⚡ 普通用户快速上手

### 1. 下载固件

从 [Releases](../../releases) 页面下载对应板型的 `merged-flash.bin` 文件。

### 2. 烧录固件

**工具：** [ESP32 Flash Download Tool](https://www.espressif.com/en/support/download/other-tools)

1. 打开烧录工具，芯片型号选择 **ESP32-S3**
2. 烧录方式选择 **USB**（串口）
3. 点击 `...` 选择下载好的 `merged-flash.bin`，地址填写 `0x0`
4. 点击 **START** 开始烧录
5. 烧录完成后，按一下开发板上的 **RESET** 按钮重启

### 3. 连接设备

1. 设备启动后，手机会搜索到名为 **Xiaozhi-XXXX** 的 Wi-Fi 热点（无需密码）
2. 连接该热点
3. 手机会自动弹出配网页，或浏览器打开 **http://192.168.4.1**

### 4. 配网 + MCP 配置

在配网页中：

1. **WiFi SSID**：选择或输入你家路由器的 Wi-Fi 名称
2. **WiFi 密码**：输入 Wi-Fi 密码
3. **MCP JSON 配置**（可选）：粘贴 MCP 服务器配置，格式如下：
```json
{
  "mcpServers": {
    "server-name": {
      "type": "streamable_http",
      "url": "https://your-mcp-server.com/mcp"
    }
  }
}
```
> 支持添加多个 MCP 服务器，点击配网页中的 **+** 按钮即可添加更多输入框。

4. 点击 **保存并连接**，设备会自动连接 Wi-Fi 并加载 MCP 工具

### 5. 使用

设备连接成功后，说出唤醒词（默认"你好小智"）即可开始对话。AI 会自动调用你配置的 MCP 工具来执行各种任务。

---

## 📚 开发者指南

> 完整的开发者文档请见 [Wiki](https://gitee.com/ppx2013/xiaozhi/wikis)

Wiki 包含以下内容：

- 开发环境搭建
- 编译指南
- 自定义开发板
- MCP 工具开发
- 故障排查

---

## 相关开源项目

- [xinnan-tech/xiaozhi-esp32-server](https://github.com/xinnan-tech/xiaozhi-esp32-server) Python 服务器
- [joey-zhou/xiaozhi-esp32-server-java](https://github.com/joey-zhou/xiaozhi-esp32-server-java) Java 服务器
- [AnimeAIChat/xiaozhi-server-go](https://github.com/AnimeAIChat/xiaozhi-server-go) Golang 服务器
- [hackers365/xiaozhi-esp32-server-golang](https://github.com/hackers365/xiaozhi-esp32-server-golang) Golang 服务器

## 关于项目

本项目以 MIT 许可证发布，允许任何人免费使用、修改或用于商业用途。

如果你有任何想法或建议，请提出 Issues 或加入 QQ 群：1011329060