diff --git a/xiaozhi-mcp-server/CHANGELOG.md b/xiaozhi-mcp-server/CHANGELOG.md
new file mode 100644
index 0000000..e046dcf
--- /dev/null
+++ b/xiaozhi-mcp-server/CHANGELOG.md
@@ -0,0 +1,3 @@
+###  1.0-beta（2025-05-20）
+
+- 首次推出
\ No newline at end of file
diff --git a/xiaozhi-mcp-server/DOCS.md b/xiaozhi-mcp-server/DOCS.md
new file mode 100644
index 0000000..63436c6
--- /dev/null
+++ b/xiaozhi-mcp-server/DOCS.md
@@ -0,0 +1,24 @@
+# 小智 Mcp Server
+
+## 安装
+1. 安装本addons
+2. 安装Mcp Server 服务器插件
+3. 登录小智平台，获取Mcp接入点
+
+## 使用说明:  
+### 参数说明
+1.  **小智 MCP 接入点：** 登录[小智官方]( https://xiaozhi.me/console/agents )服务器即可获取。
+2.  **HA MCP SERVER 地址：** 直接安装MCP Server集成。
+    * 点击此链接：[Home Assistant MCP Server 集成](https://my.home-assistant.io/redirect/config_flow_start?domain=mcp_server)直达安装
+    * 或 在 Home Assistant 中，前往 **设置 > 设备和服务 > 添加集成 > Model Context Protocol Server**。
+    * 默认直接确认或从列表中选择“**模型上下文协议服务器**”，并按照屏幕上的说明完成设置。
+3.  **HA长效 API 令牌：** 用于授权访问你的 Home Assistant 实例。
+    * 访问你的 [Home Assistant 账户配置文件设置](https://my.home-assistant.io/redirect/profile)，进入“**安全**”选项卡。
+    * 创建**长期访问令牌**。
+4.  **备注：** ha中的服务器地址为域写法，可以不用更改。
+
+
+
+——————————————————————————
+
+作者原帖：[小智AI和Ha无缝对接：官方 MCP 接入点的最佳实践](https://bbs.hassbian.com/thread-29314-1-1.html)
\ No newline at end of file
diff --git a/xiaozhi-mcp-server/README.md b/xiaozhi-mcp-server/README.md
new file mode 100644
index 0000000..7c045b0
--- /dev/null
+++ b/xiaozhi-mcp-server/README.md
@@ -0,0 +1,14 @@
+# 冬瓜甄选Addons: 小智 Mcp Server
+
+
+
+## 关于
+
+本addons由瀚思彼岸论坛shay的docker生成。小智官方服务器(虾哥)对接home assistant的mcp server
+
+## 原理
+
+利用ha的mcp server集成与小智官方平台的mcp接口进行对接，快速实现AI语音设备控制
+
+## 来源
+Github: https://github.com/shawn996/mcp_ha_xiaozhi
\ No newline at end of file
diff --git a/xiaozhi-mcp-server/config.yaml b/xiaozhi-mcp-server/config.yaml
new file mode 100644
index 0000000..acd2aad
--- /dev/null
+++ b/xiaozhi-mcp-server/config.yaml
@@ -0,0 +1,25 @@
+name: "小智 Mcp Server"
+version: "1.0"
+slug: "mcp_ha_xiaozhi"
+description: "小智官方服务器(虾哥)对接home assistant的mcp server"
+url: "https://gitcode.com/waxgourd/addons"
+arch:
+  - aarch64
+  - amd64
+startup: application
+boot: manual
+translations: true
+init: false
+environment:
+  XIAOZHI_MCP_ENDPOINT: "wss://api.xiaozhi.me/mcp/?token="
+  HA_MCP_ENDPOINT: "http://homeassistant.local:8123/mcp_server/sse"
+  API_ACCESS_TOKEN: ""
+options:
+  XIAOZHI_MCP_ENDPOINT: "wss://api.xiaozhi.me/mcp/?token="
+  HA_MCP_ENDPOINT: "http://homeassistant.local:8123/mcp_server/sse"
+  API_ACCESS_TOKEN:
+schema:
+  XIAOZHI_MCP_ENDPOINT: str
+  HA_MCP_ENDPOINT: str
+  API_ACCESS_TOKEN: str
+image: "r.hassbus.com/wghaos/xiaozhi-mcp-server"
diff --git a/xiaozhi-mcp-server/icon.png b/xiaozhi-mcp-server/icon.png
new file mode 100644
index 0000000..e934656
Binary files /dev/null and b/xiaozhi-mcp-server/icon.png differ
diff --git a/xiaozhi-mcp-server/logo.png b/xiaozhi-mcp-server/logo.png
new file mode 100644
index 0000000..e934656
Binary files /dev/null and b/xiaozhi-mcp-server/logo.png differ
diff --git a/xiaozhi-mcp-server/translations/en.yaml b/xiaozhi-mcp-server/translations/en.yaml
new file mode 100644
index 0000000..559c97d
--- /dev/null
+++ b/xiaozhi-mcp-server/translations/en.yaml
@@ -0,0 +1,10 @@
+configuration:
+  XIAOZHI_MCP_ENDPOINT:
+    name: XIAOZHI_MCP_ENDPOINT
+    description: Your XiaoZhi MCP access point
+  HA_MCP_ENDPOINT:
+    name: HA_MCP_ENDPOINT
+    description: Your HA MCP server address
+  API_ACCESS_TOKEN:
+    name: API_ACCESS_TOKEN
+    description: Your HA MCP server address
diff --git a/xiaozhi-mcp-server/translations/zh-Hans.yaml b/xiaozhi-mcp-server/translations/zh-Hans.yaml
new file mode 100644
index 0000000..7185f1b
--- /dev/null
+++ b/xiaozhi-mcp-server/translations/zh-Hans.yaml
@@ -0,0 +1,10 @@
+configuration:
+  XIAOZHI_MCP_ENDPOINT:
+    name: XIAOZHI_MCP_ENDPOINT
+    description: 你的小智 MCP 接入点
+  HA_MCP_ENDPOINT:
+    name: HA_MCP_ENDPOINT
+    description: 你的 HA MCP SERVER 地址
+  API_ACCESS_TOKEN:
+    name: API_ACCESS_TOKEN
+    description: 你的长效 API 令牌
\ No newline at end of file