Verdure MCP For Xiaozhi

MCPAI代理

提供方 maker-community

AI代理 未标注 API Key 社区 / 第三方

开源的多租户MCP服务管理平台,兼容多种AI助手并提供统一的Model Context Protocol服务配置和管理能力。

一句话选型结论

按资料字段整理

Verdure MCP For Xiaozhi 属于AI代理类 MCP 服务器,传输方式未标注,API Key,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权API Key 部署方式未标注
GitHub 星标 49 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

多租户C#本地部署AI助手服务管理WebSocket开源

安装与配置

未标注 API Key
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 基础信息齐全,可以先按官方文档接入试跑。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Verdure MCP For Xiaozhi当前 未标注 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方maker-community上游标注的维护方 maker-community
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.9 KB
来自项目仓库与上游目录的原文,未做删改

Verdure MCP Platform

> 开源的多租户 MCP 服务管理平台,兼容多种 AI 助手并提供统一的 Model Context Protocol 服务配置和管理能力



🌟 在线服务

立即体验,无需安装!

🔗 在线平台(主入口): 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+

#### 一键启动```powershell
# 克隆仓库
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

其他命令```powershell

查看服务状态

.\scripts\health-check.ps1

查看日志

.\scripts\view-logs.ps1

停止服务

.\scripts\stop-local.ps1


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

---

### 方式二:.NET 开发环境

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

#### 前置要求
- .NET 10 SDK
- PostgreSQL 或 SQLite
- Redis (可选,用于分布式功能)
- Keycloak (可选,用于认证)

#### 安装步骤

1. **克隆仓库**```bash
git clone https://github.com/maker-community/verdure-mcp-for-xiaozhi.git
cd verdure-mcp-for-xiaozhi
  1. 恢复依赖```bash
    dotnet restore

3. **配置数据库**

编辑 `src/Verdure.McpPlatform.Api/appsettings.json`:```json
{
"ConnectionStrings": {
"Redis": "localhost:6379",
"mcpdb": "",
"identitydb": ""
},
}
  1. 运行应用(通过 Aspire)```bash
    dotnet run --project src/Verdure.McpPlatform.AppHost

或单独运行各服务:```bash
# 运行 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️⃣ 注册登录

访问平台注册账号

或使用演示账号

2️⃣ 配置小智连接

添加你的小智 AI

服务器 WebSocket 地址

3️⃣ 创建 MCP 服务

配置 MCP 服务

支持多种认证方式

4️⃣ 绑定并使用

将服务绑定到节点

开始享受 MCP 能力

详细步骤

  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 包

🌐 社区与支持

加入我们的社区,获取帮助和分享经验!

💬 QQ 交流群

绿荫DIY硬件交流群

群号:1023487000

讨论 AI、MCP 和硬件 DIY

📺 B站 UP主

绿荫阿广

访问主页

获取更多 AI 和创客教程

🐙 GitHub 社区

Maker Community

访问组织

贡献代码,参与开发

📮 联系方式

  • 📧 问题反馈: 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 助手用户和开发者!


⭐ 如果这个项目对你有帮助,请给我们一个 Star!⭐

Made with ❤️ by 绿荫阿广 and the Maker Community

🏠 返回顶部

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
Verdure MCP For Xiaozhi 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Verdure MCP For Xiaozhi 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Verdure MCP For Xiaozhi 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Verdure MCP For Xiaozhi 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Verdure MCP For Xiaozhi 能提供哪些能力?

资料显示能力标签包括 多租户、C#、开源、WebSocket。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。