Semantic Kernel开启MCP

177 阅读1分钟

Semantic Kernel开启MCP

MCP越来越火了,各大模型公司也在陆陆续续支持MCP了,OpenAI在前不久声明对MCP的支持,同时社区的SDK也来了,今天就用ModelContextProtocol来创建服务端和客户端,并且找通他们。与此同时,也不能落下SK,看看SK怎么使用MCP。 先看Server端: 项目文件如下: ```

net10.0 enable enable ``` Program.cs: ``` using ModelContextProtocol;

var builder = WebApplication.CreateBuilder(args); builder.Services.AddMcpServer()
.WithStdioServerTransport() .WithToolsFromAssembly(); var app = builder.Build(); app.MapGet("/", () => "Hello World!"); app.MapMcpSse(); app.Run();

 工具定义: ```
using ModelContextProtocol.Server;
using System.ComponentModel;

namespace MCPOrderTool.Tools;

[McpServerToolType]
public static class OrderTool
{
    [McpServerTool("queryOrder"), Description("按开始日期和结速日期查询订单")]
    public static List<Order> QueryList(DateTime? beginTime, DateTime? endTime)
    {
        Console.WriteLine("-------------参数-------------");
        Console.ForegroundColor = ConsoleColor.Green;
        Console.WriteLine($"BeginTime:{beginTime},EndTime:{endTime}");
        Console.ResetColor();
        Console.WriteLine("-------------参数-------------");
        if (beginTime is null || endTime is null)
        {
            beginTime = DateTime.Now;
            endTime = DateTime.Now;
        }
        return new List<Order>
        {
            new Order("NO000001", "Order1", DateTime.Now.ToString("yyyy-MM-dd"), "Pending"),
            new Order("NO000002", "Order2", DateTime.Now.ToString("yyyy-MM-dd"), "Completed"),
            new Order("NO000003", "Order3", DateTime.Now.ToString("yyyy-MM-dd"), "Pending"),
            new Order("NO000004", "Order4", DateTime.Now.ToString("yyyy-MM-dd"), "Completed"),
            new Order("NO000005", "Order5", DateTime.Now.ToString("yyyy-MM-dd"), "Pending"),
            new Order("NO000006", "Order6", DateTime.Now.ToString("yyyy-MM-dd"), "Completed"),
            new Order("NO000007", "Order7", DateTime.Now.ToString("yyyy-MM-dd"), "Pending"),
            new Order("NO000008", "Order8", DateTime.Now.ToString("yyyy-MM-dd"), "Completed"),
            new Order("NO000009", "Order9", DateTime.Now.ToString("yyyy-MM-dd"), "Pending"),
            new Order("NO000010", "Order10",  DateTime.Now.ToString("yyyy-MM-dd"), "Completed"),
        };
    }
}

public record Order(string OrderId, string OrderName, string OrderTime, string OrderStatus);

MCP服务端Map定义: ``` using ModelContextProtocol.Protocol.Messages; using ModelContextProtocol.Server; using ModelContextProtocol.Utils.Json; using Microsoft.Extensions.Options; using ModelContextProtocol.Protocol.Transport;

public static class McpEndpointRouteBuilderExtensions { public static IEndpointConventionBuilder MapMcpSse(this IEndpointRouteBuilder endpoints) { IMcpServer? server = null; SseResponseStreamTransport? transport = null; var loggerFactory = endpoints.ServiceProvider.GetRequiredService(); var mcpServerOptions = endpoints.ServiceProvider.GetRequiredService<IOptions>();

    var routeGroup = endpoints.MapGroup("");

    routeGroup.MapGet("/sse", async (HttpResponse response, CancellationToken requestAborted) =>
    {        
        await using var localTransport = transport = new SseResponseStreamTransport(response.Body);
        await using var localServer = server = McpServerFactory.Create(transport, mcpServerOptions.Value, loggerFactory, endpoints.ServiceProvider);

        await localServer.StartAsync(requestAborted);
        response.Headers.ContentType = "text/event-stream";
        response.Headers.CacheControl = "no-cache";
        try
        {
            await transport.RunAsync(requestAborted);
        }
        catch (OperationCanceledException) when (requestAborted.IsCancellationRequested)
        {               
            Console.WriteLine("closed");
        }
    });

    routeGroup.MapPost("/message", async context =>
    {           
        if (transport is null)
        {
            await Results.BadRequest("Connect to the /sse endpoint before sending messages.").ExecuteAsync(context);
            return;
        }
        var message = await context.Request.ReadFromJsonAsync<IJsonRpcMessage>(McpJsonUtilities.DefaultOptions, context.RequestAborted);
        if (message is null)
        {
            await Results.BadRequest("No message in request body.").ExecuteAsync(context);
            return;
        }
        await transport.OnMessageReceivedAsync(message, context.RequestAborted);
        context.Response.StatusCode = StatusCodes.Status202Accepted;
        await context.Response.WriteAsync("Accepted");
    });
    return routeGroup;
}

}

 下面是Client使用: 项目文件: ```
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.Extensions.AI.OpenAI" Version="9.3.0-preview.1.25161.3" />
    <PackageReference Include="Microsoft.Extensions.Logging.Debug" Version="10.0.0-preview.2.25163.2" />
    <PackageReference Include="Microsoft.SemanticKernel" Version="1.44.0" />
    <PackageReference Include="Microsoft.SemanticKernel.Plugins.Core" Version="1.44.0-alpha" />
    <PackageReference Include="ModelContextProtocol" Version="0.1.0-preview.2" />
    <PackageReference Include="ModelContextProtocol-SemanticKernel" Version="0.0.1-preview-03" />
  </ItemGroup>
</Project>

Program.cs文件: ``` using Azure.Core; using Microsoft.Extensions.AI; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Logging; using Microsoft.SemanticKernel; using Microsoft.SemanticKernel.Connectors.OpenAI; using ModelContextProtocol.Client; using ModelContextProtocol.Configuration; using ModelContextProtocol.Protocol.Transport; using ModelContextProtocol.Protocol.Types; using ModelContextProtocol.SemanticKernel.Extensions; using ModelContextProtocol.SemanticKernel.Options; using ModelContextProtocol.Server; using OpenAI; using System.ComponentModel; using System.Text.Json; using System.Text.Json.Serialization;

var key = File.ReadAllText("c:/gpt/key.txt");

while (true) { Console.WriteLine("==========================================================="); Console.WriteLine("1、获取工具列表 2、Client调用工具 3、SK调用工具 0、退出"); Console.WriteLine("==========================================================="); var no = Console.ReadLine(); switch (no) { case "1": await MCPClientToolsListAsync(); break; case "2":

        await MCPClientAsync();
        break;
    case "3":
        await SKClientAsync();
        break;
    case "0":
        return;
}

}

async Task MCPClientToolsListAsync() { var serverConfig = new McpServerConfig { Id = "QueryOrder", Name = "QueryOrder", TransportType = TransportTypes.Sse, Location = "http://localhost:3001/sse" }; var clientOptions = new McpClientOptions { ClientInfo = new() { Name = "QueryOrderClient", Version = "0.0.1", } }; var mcpClient = await McpClientFactory.CreateAsync(serverConfig, clientOptions); Console.WriteLine("获取Tools:"); var tools = await mcpClient.ListToolsAsync();

foreach (var tool in tools)
{

    Console.WriteLine($"{tool.Name},{tool.Description}");
}
Console.WriteLine();

}

async Task MCPClientAsync() { var serverConfig = new McpServerConfig { Id = "QueryOrder", Name = "MCPOrderTool", TransportType = TransportTypes.Sse, Location = "http://localhost:3001/sse" }; var clientOptions = new McpClientOptions { ClientInfo = new() { Name = "QueryOrderClient", Version = "0.0.1", } }; var mcpClient = await McpClientFactory.CreateAsync(serverConfig, clientOptions); var functions = await mcpClient.ListToolsAsync(); IChatClient chatClient = new OpenAIClient(key).AsChatClient("gpt-4o-mini") .AsBuilder().UseFunctionInvocation().Build(); var response = chatClient.GetStreamingResponseAsync( "查询本周的订单", new() { Tools = [.. functions], }); await foreach (var item in response) { Console.Write(item.Text); } Console.WriteLine(); }

async Task SKClientAsync() { var builder = Kernel.CreateBuilder(); builder.Services.AddLogging(c => c.AddDebug().SetMinimumLevel(LogLevel.Trace));

builder.Services.AddOpenAIChatCompletion(
    serviceId: "openai",
    modelId: "gpt-4o-mini",
    apiKey: key);

var kernel = builder.Build();
kernel.Plugins.AddFromType<TimeInformationPlugin>();
await kernel.Plugins.AddMcpFunctionsFromSseServerAsync("MCPOrderTool", "http://localhost:3001/sse");
var executionSettings = new OpenAIPromptExecutionSettings
{
    Temperature = 0,
    FunctionChoiceBehavior = FunctionChoiceBehavior.Auto()
};
var prompt = "请查询本月的订单";
var result = kernel.InvokePromptStreamingAsync(prompt, new(executionSettings));
await foreach (var item in result)
{
    Console.Write(item.ToString());
}
Console.WriteLine();

}

public class TimeInformationPlugin { [KernelFunction, Description("获取当前的 UTC 时间。")] public string GetCurrentUtcTime() => DateTime.UtcNow.ToString("R"); }

 下面是运行结果:1、列举服务端的工具信息,2、是用普通方式调用MCP服务端,这时注意右边红色的框,时间是2023年,取的是模型时间 3、是用SK的方式调用工具,同时SK还添加当前时间插件,看蓝色框,取的是当前时间,正确。 文章来源微信公众号 想要更快更方便的了解相关知识,可以关注微信公众号

> 原文链接: https://www.cnblogs.com/axzxs2001/p/18809069