---

---

🌟 在线服务

立即体验，无需安装！

🔗 在线平台（主入口）: https://hub.verdure-hiro.cn/

🔗 兼容入口（旧域名，持续可用）: https://xiaozhi.verdure-hiro.cn/

• ✅ 免费注册，即刻使用
• ✅ 无需部署，云端托管
• ✅ 稳定可靠，持续更新

---

🎬 视频教程

📺 B站视频演示

小智 MCP 转接服务上线与开源 🎬 点击观看 适合小智商家和小智爱好者

私有化部署与米家智能家居控制 🎬 点击观看 手把手教你部署和玩转米家

---

📖 项目介绍

Verdure MCP Platform 是一个基于 .NET 10 和 Blazor WebAssembly 构建的企业级多租户 SaaS 平台，面向多种 AI 助手提供统一的 Model Context Protocol (MCP) 服务管理与接入能力。

核心功能：

• 🔐 多租户身份认证系统（基于 Keycloak OpenID Connect）
• 🌐 每个用户可配置自己的 AI 助手连接（如小智、涂鸦等）
• 🔗 将不同的 MCP 服务绑定到指定助手节点
• 🚀 通过 WebSocket 连接提供对应的 MCP 服务
• 💾 仓储模式 (Repository Pattern) 实现数据访问层
• 🗄️ 支持 PostgreSQL 和 SQLite 多数据库

🆕 最新进展

• ✅ 在线域名已升级为统一入口: https://hub.verdure-hiro.cn/
• ✅ 旧域名保持兼容可用: https://xiaozhi.verdure-hiro.cn/
• ✅ 连接层已从单一小智扩展为多助手兼容（包含 Tuya 连接类型）
• ✅ 已向 Tuya 官方生态贡献 C# SDK 项目: tuya/tuya-mcp-sdk

✨ 核心特性

🔐 多租户支持 基于 Keycloak 的 OpenID Connect 认证 每个用户独立配置 MCP 服务和小智连接 完整的权限管理和数据隔离 支持多种认证方式（Bearer、Basic、OAuth2、API Key） 🌐 灵活的服务绑定 支持多种 MCP 服务配置 动态绑定服务到小智节点 实时 WebSocket 连接管理 自动故障恢复和重连机制

🚀 现代化技术栈 .NET 10 后端 API + Blazor WebAssembly 前端 MudBlazor UI 组件库（Material Design 3） .NET Aspire 云原生应用编排 Entity Framework Core 10.0 数据访问 🏛️ 优秀的架构设计 领域驱动设计 (DDD) 仓储模式 (Repository Pattern) 前后端分离架构 完整的国际化 (i18n) 支持（中文/英文）

🏗️ 项目架构

verdure-mcp-for-xiaozhi/
├── src/
│   ├── Verdure.McpPlatform.AppHost/           # Aspire 应用宿主
│   ├── Verdure.McpPlatform.ServiceDefaults/   # 共享服务配置
│   ├── Verdure.McpPlatform.Api/               # Web API 项目
│   ├── Verdure.McpPlatform.Web/               # Blazor WebAssembly 前端
│   ├── Verdure.McpPlatform.Domain/            # 领域层
│   ├── Verdure.McpPlatform.Infrastructure/    # 基础设施层
│   ├── Verdure.McpPlatform.Application/       # 应用服务层
│   └── Verdure.McpPlatform.Contracts/         # 共享契约
└── tests/                                      # 测试项目

详细架构说明请参考 AGENTS.md

🚀 快速开始

🎯 三种使用方式，任你选择

🌐 在线使用 最快捷的方式 访问 在线平台（旧域名 https://xiaozhi.verdure-hiro.cn/ 也可访问） ✅ 无需安装 ✅ 即开即用 ✅ 云端托管 立即体验 →

🐳 Docker 部署 最简单的本地部署 一键启动完整环境 ✅ 包含所有依赖 ✅ 3-5分钟启动 ✅ 适合私有部署 查看教程 ↓

💻 开发环境 适合二次开发 .NET 10 开发环境 ✅ 完整源码 ✅ 灵活定制 ✅ 适合开发者 查看教程 ↓

---

方式一：本地 Docker 一键启动 (推荐⭐)

最简单的方式，包含完整环境：PostgreSQL + Redis + Keycloak + 应用

前置要求

• Docker Desktop (Windows/Mac) 或 Docker + Docker Compose (Linux)
• PowerShell 5.1+ 或 PowerShell Core 7+

一键启动

# 克隆仓库
git clone https://github.com/maker-community/verdure-mcp-for-xiaozhi.git
cd verdure-mcp-for-xiaozhi

# 启动所有服务（首次启动约需 3-5 分钟）
.\scripts\start-local.ps1

访问应用

• 应用: http://localhost:5241
• Keycloak 管理: http://localhost:8080 (admin / admin)

演示账号

• 管理员: admin / admin123
• 普通用户: demo / demo123

其他命令

# 查看服务状态
.\scripts\health-check.ps1

# 查看日志
.\scripts\view-logs.ps1

# 停止服务
.\scripts\stop-local.ps1

📖 详细文档: Docker 本地部署指南

---

方式二：.NET 开发环境

适合需要修改代码的开发者

前置要求

• .NET 10 SDK
• PostgreSQL 或 SQLite
• Redis (可选，用于分布式功能)
• Keycloak (可选，用于认证)

安装步骤

1. 克隆仓库

git clone https://github.com/maker-community/verdure-mcp-for-xiaozhi.git
cd verdure-mcp-for-xiaozhi

1. 恢复依赖

dotnet restore

1. 配置数据库

编辑 src/Verdure.McpPlatform.Api/appsettings.json:

{
  "ConnectionStrings": {
    "Redis": "localhost:6379",
    "mcpdb": "",
    "identitydb": ""
  },
}

1. 运行应用（通过 Aspire）

dotnet run --project src/Verdure.McpPlatform.AppHost

或单独运行各服务：

# 运行 API
dotnet run --project src/Verdure.McpPlatform.Api

# 运行 Web 前端
dotnet run --project src/Verdure.McpPlatform.Web

1. 访问应用

• Web UI: https://localhost:5001
• API: https://localhost:5000
• Aspire Dashboard: https://localhost:17181

---

🎯 使用流程

快速上手指南

详细步骤

1. 登录系统 - 使用 Keycloak 账号登录平台，或访问在线服务直接注册（旧域名 https://xiaozhi.verdure-hiro.cn/ 同样可用）
2. 配置助手连接 - 在"助手连接"页面添加你的 AI 助手连接信息（支持小智与 Tuya 等连接类型）
3. 创建 MCP 服务 - 在"MCP 服务"页面配置服务，支持 Bearer Token、Basic Auth、OAuth2、API Key 等多种认证
4. 绑定服务到节点 - 在"服务绑定"页面将 MCP 服务绑定到指定助手节点，选择需要的工具
5. 开始使用 - 在你的 AI 助手中使用绑定 MCP 服务提供的能力

💡 提示: 观看我们的 B站视频教程 获取更详细的操作演示

---

❓ 常见问题

什么是 MCP (Model Context Protocol)？
MCP 是一个开放的 AI 上下文协议标准，它允许 AI 助手通过标准化的接口访问各种外部工具和数据源。通过 MCP，不同助手都可以连接到文件系统、数据库、API 服务等，大大扩展其能力边界。 在线服务是免费的吗？
是的，目前在线服务完全免费提供给所有用户使用。我们也提供开源代码支持私有部署。 支持哪些 MCP 服务？
平台支持所有符合 MCP 标准的服务，包括但不限于：

• 🏠 米家智能家居控制
• 📁 文件系统访问
• 🗄️ 数据库查询
• 🌐 HTTP API 调用
• 🔧 自定义工具集成

查看 米家控制视频教程 了解实际应用案例。 如何获取技术支持？

• 📺 观看 B站视频教程
• 💬 加入 QQ 交流群：1023487000
• 🐛 提交 GitHub Issues

可以商业使用吗？
可以！本项目采用 MIT 开源协议，允许商业使用。你可以：

• ✅ 免费使用在线服务
• ✅ 私有部署用于商业项目
• ✅ 基于源码进行二次开发
• ✅ 集成到你的产品中

唯一要求是保留原始的版权声明。

---

📚 文档

• 架构指南 - 详细的架构设计和开发指南
• 部署指南 - 生产环境部署说明
• API 文档 - API 使用示例
• 前端改进 - 最新的前端更新说明
• 本地 NuGet 包使用 - 使用本地编译的 NuGet 包

---

🌐 社区与支持

📮 联系方式

• 📧 问题反馈: GitHub Issues
• 💡 功能建议: GitHub Discussions
• 🎥 视频教程: B站 @绿荫阿广

🤝 贡献

我们欢迎所有形式的贡献！无论是代码、文档、问题反馈还是建议。

如何贡献

1. 🍴 Fork 本仓库
2. 🌿 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 💾 提交更改 (git commit -m 'Add some AmazingFeature')
4. 📤 推送到分支 (git push origin feature/AmazingFeature)
5. 🔀 创建 Pull Request

贡献指南

• 查看 AGENTS.md 了解项目架构和开发规范
• 遵循现有的代码风格和提交规范
• 为新功能添加相应的测试和文档
• 确保所有测试通过后再提交 PR

贡献者

感谢所有为这个项目做出贡献的开发者！

📄 开源协议

本项目采用 MIT License 开源协议。

🙏 致谢

感谢以下开源项目和技术：

• Microsoft .NET - 强大的跨平台开发框架
• MudBlazor - 优秀的 Blazor UI 组件库
• Keycloak - 开源的身份认证和访问管理解决方案
• Model Context Protocol - AI 上下文协议标准
• Entity Framework Core - 现代化的 ORM 框架
• .NET Aspire - 云原生应用编排框架

特别感谢所有支持和使用本项目的 AI 助手用户和开发者！

---