绿意-mcp-晓智

Name: 绿意-mcp-晓智
Author: maker-community

作者：maker-community19 星标更新：2025-11-23

安装使用来源：spider==github.com

项目介绍

技术文档摘要

Verdure MCP 平台

一个开源的多租户MCP服务管理平台，为小知AI助手提供灵活的模型上下文协议服务配置和管理能力。

📖 项目介绍

Verdure MCP 平台是一个基于.NET 9和VNet WebAssembly的企业级多租户SaaS平台，专门为小知AI助手设计，提供完整的模型上下文协议（MCP）服务管理解决方案。

核心功能：

🔐 多租户认证系统（基于Keyclone OpenID Connect）
🌐 每个用户可以配置自己的小知AI服务器地址
🔗 绑定不同的MCP服务到指定节点
🚀 通过WebSocket连接提供相应的MCP服务
💾 使用仓储模式实现数据访问层
🗄️ 支持PostgreSQL和SQLite多数据库

✨ 核心特性

多租户支持

基于Keyclone的OpenID Connect认证
每个用户独立配置MCP服务和小知连接
完整的权限管理和数据隔离

灵活的服务绑定

支持多种MCP服务配置
多种认证方法（Bearer Token、Basic Auth、OAuth2、API Key）
动态绑定服务到小知节点

现代技术栈

.NET 9后端API
FHIR WebAssembly前端（单页应用）
MudLazor UI组件库（Material Design 3）
.NET Aspire云原生应用编排
Entity Framework Core 9.0

架构设计

领域驱动设计（DDD）
仓储模式
前端分离架构
依赖注入
完整国际化（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/       # 应用服务层
│   └── Verd-ure.McpPlatform.Contracts/        # 共享契约
└── tests/                                      # 测试项目

请参阅详细的架构描述 AGENTS.md

🚀 快速开始

方法1：一键本地Docker启动（推荐）⭐）

最简单的方式是包含一个完整的环境：PostgreSQL+Redis+Keyclone+应用

预备条件

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:8080
Keyclone管理: http://localhost:8180 (admin / admin)

演示账号

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

其他命令

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

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

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

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

方法2：.NET开发环境

适用于需要修改代码的开发者

预备条件

.NET 9 SDK
PostgreSQL 或 SQLite
Redis（可选，用于分布式功能）
Keycloak（可选，用于认证）

安装步骤

克隆仓库

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

恢复依赖

dotnet restore

配置数据库

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

{
  "ConnectionStrings": {
    "mcpdb": "Host=localhost;Database=verdure_mcp;Username=postgres;Password=your_password",
    "redis": "localhost:6379"
  },
  "Identity": {
    "Url": "http://localhost:8180/realms/verdure-mcp",
    "ClientId": "verdure-mcp-api"
  }
}

运行应用（通过Aspire）

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

或者分别运行每个服务：

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

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

访问应用

📚 文档

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

🎯 使用流程

登录系统 -使用Keyclone账户登录平台
配置小知连接 -添加您的小知AI服务器地址
创建MCP服务 -配置MCP服务以支持多种认证方法
绑定服务到节点 -将MCP服务绑定到小知节点并开始使用

🌐 社区和支持

GitHub Maker社区

组织地址: https://github.com/maker-community
项目仓库: https://github.com/maker-community/verdure-mcp-for-xiaozhi

Bilibili UP主

绿影阿光
Bilibili主页: https://space.bilibili.com/25228512
关注我获取更多AI和硬件制作教程

QQ交流群

绿影DIY硬件交流群
群号: 一亿二千三百四十八万七千
欢迎加入讨论AI、MCP和硬件DIY

🤝 贡献

欢迎贡献代码、报告问题或提出建议！

叉出自己的仓库
创建功能分支（git checkout -b feature/AmazingFeature）
提交更改（git commit -m 'Add some AmazingFeature'）
推送到分支（git push origin feature/AmazingFeature）
创建Pull Request

📄 开源许可

本项目采用 MIT许可开源协议。

🙏 致谢

Microsoft .NET -强大的跨平台框架
MudBlazor -优秀的VNet UI组件库
Keycloak -开源的身份认证解决方案
模型上下文协议 -AI上下文协议标准

由绿影阿光和 Maker社区制作