AI导哈

代理AI服务架构

一个基于.NET 8.0的清洁、SOLID、面向对象的架构，用于实现模型上下文协议（MCP）的代理AI服务。

  • by floradu88
  • C#
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 floradu88/mcp-server-arch-dotnet

使用说明

MCP架构-代理人工智能服务

一个干净的、固态的、面向对象的架构，用于实现模型上下文协议（MCP），并在此基础上构建代理AI服务。网8.0。

架构概述

该解决方案遵循清洁架构原则，明确分离关注点：

  • 域层：核心模型、接口和业务逻辑
  • 应用层：用例和应用程序服务
  • 基础设施层：外部服务实现（HTTP客户端、数据访问）
  • API层：ASP。NET核心Web API与REST端点

项目结构

McpArchitecture/
├── McpArchitecture.Domain/          # Core domain models and interfaces
├── McpArchitecture.Application/     # Application services and use cases
├── McpArchitecture.Infrastructure/  # Infrastructure implementations
├── McpArchitecture.Api/             # ASP.NET Core Web API
├── scripts/                         # PowerShell setup scripts
└── README.md

先决条件

  • .NET 8.0 SDK或更高版本
  • Visual Studio 2022（或更高版本）
  • PowerShell 5.1或更高版本

安装说明

选项1：使用PowerShell脚本（推荐）

  1. 在项目根目录中打开PowerShell

  2. 运行安装脚本：

    .\scripts\Setup-Project.ps1

  3. 添加NuGet包：

    .\scripts\Add-Packages.ps1

选项2：手动设置

  1. 创建解决方案：

    dotnet new sln -n McpArchitecture

  2. 创建项目：

    dotnet new classlib -n McpArchitecture.Domain
dotnet new classlib -n McpArchitecture.Application
dotnet new classlib -n McpArchitecture.Infrastructure
dotnet new webapi -n McpArchitecture.Api

  3. 将项目添加到解决方案：

    dotnet sln add McpArchitecture.Domain/McpArchitecture.Domain.csproj
dotnet sln add McpArchitecture.Application/McpArchitecture.Application.csproj
dotnet sln add McpArchitecture.Infrastructure/McpArchitecture.Infrastructure.csproj
dotnet sln add McpArchitecture.Api/McpArchitecture.Api.csproj

  4. 添加项目引用（引用结构请参见Setup-project.ps1）

运行应用程序

选项1：使用启动脚本（推荐）

Windows（PowerShell）：

.\start.ps1

Linux/Mac（Bash）：

chmod +x start.sh
./start.sh

使用自定义选项：

# Run in Production environment
.\start.ps1 -Environment Production

# Run on custom port
.\start.ps1 -Port 5002

# Show help
.\start.ps1 -Help

选项2：使用Visual Studio 2022

  1. 在Visual Studio 2022中打开解决方案
  2. 集 McpArchitecture.Api 作为启动项目
  3. 按F5运行

选项3：使用。NET-CLI

cd McpArchitecture.Api
dotnet run

访问API

启动后，导航到：

  • Swagger用户界面: https://localhost:5001/swagger
  • API基地: https://localhost:5001

API终点

标准MCP端点

  • POST /api/mcp/request -处理MCP请求
  • POST /api/mcp/message -处理MCP消息
  • GET /api/mcp/resources -获取所有可用资源
  • GET /api/mcp/resources/{id} -获取特定资源
  • POST /api/mcp/resources -注册新资源

文件服务器MCP（JSON-RPC 2.0）

  • POST /api/mcp/json -处理JSON-RPC 2.0 MCP请求
    • filesystem/list_files -列出文件和目录
    • filesystem/read_file -读取文件内容
    • filesystem/write_file -写入文件内容
    • filesystem/get_file_info -获取文件/目录信息
    • filesystem/create_directory -创建目录
    • filesystem/delete_file -删除文件或目录

MCP检验员测试

使用MCP检查器以交互方式测试API：

.\test-mcp\start-inspector.ps1

这将启动一个基于网络的检查器工具。看 test-mcp/README.md 了解详情。

设计原则

本项目遵循SOLID原则：

  • 单一责任：每个班都有一个改变的原因
  • 打开/关闭：打开以进行扩展，关闭以进行修改
  • 利斯科夫替补：可以在不破坏功能的情况下交换接口
  • 接口隔离：小而专注的界面
  • 依赖倒置：取决于抽象，而不是具体

特性

  • ✅ 分层分离的干净建筑
  • ✅ 全程依赖注入
  • ✅ 使用Serilog进行结构化日志记录
  • ✅ Swagger/OpenAPI文档
  • ✅ RESTful API设计
  • ✅ 资源管理系统
  • ✅ MCP协议实现
  • ✅ 与Visual Studio 2022兼容

配置

编辑 appsettings.json 配置：

  • MCP基本URL
  • 超时设置
  • 日志记录级别

测试

要添加测试，请创建测试项目：

dotnet new xunit -n McpArchitecture.Tests
dotnet add reference ../McpArchitecture.Domain/McpArchitecture.Domain.csproj

贡献

这是一个干净的架构模板。根据您的特定要求扩展它，同时保持SOLID原则和干净的架构边界。

许可证

本项目按原样提供，用于教育和商业用途。

相关 MCP