Model Context Protocol (MCP) - 尝试创建和测试一下MCP Server

1.简单介绍

MCP是Model Context Protocol的缩写，是Anthropic开源的一个标准协议。MCP使得大语言模型可以和外部的数据源，工具进行集成。当前MCP在社区逐渐地流行起来了。同时official C# SDK(仓库是csharp-sdk) 也在不断更新中，目前最新版本是0.1.0-preview.7，相对之前的版本还是在不断更新的(发现最新版的McpClientFactory.CreateAsync方法好像有变更)。关于MCP的具体信息可以参考官方网站。

MCP使用的是client-server架构，下图为官网上面的一张图片

目前MCP client和MCP server交互使用的TransportType有两种，一种是Stdio(标准输入输出)，另外一种是SSE(Server Sent Event)，http目前还未支持。在集成本地command-line tool或者Shell脚本场景方面，Stdio可能适合些。SSE支持Server-to-Client streaming。

这边简单尝试一个MCP server去获取Microsoft 365 Planner中的Plan, Task信息，然后使用MCP Inspector去调用一下看看，

2.具体说明

2.1 准备阶段

假定存在一个Microsoft 365 Planner

在Microsoft 365 Planer中，一个Microsoft 365 Group对应多个Plan, 一个Plan对应多个Task的。

2.2 创建WebApi项目

创建一个基于.NET9的Asp.NET Core WebApi项目
添加nuget package ModelContextProtocol.AspNetCore (版本是0.1.0-preview.7)

添加了这个package，就不需要再为IEndpointRouteBuilder添加拓展方法了(MapMcpSse)

3)由于要获取Microsoft 365 Planer的信息，需要使用Microsfot Graph Rest Api，添加一下Microsoft Graph nuget package

program.cs的代码如下

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddMcpServer().WithToolsFromAssembly();
var app = builder.Build();
app.MapMcp();
app.Run();

note, 其中WithToolsFromAssembly方法会扫描程序集当中标注了 $McpServerToolType$ attribute的类进行注册的

5）在项目中添加一个Tools文件夹，然后添加一个静态类

复制代码

[McpServerToolType]
public static class M365PlannerInfoQueryTool
{
	...
	[McpServerTool, Description("List the Microsoft 365 Groups the user belong to")]
	public static string[] ListAllGroupsTheUserBelongTo()
	{
		...
		GraphServiceClient graphClient = _appClient!;
		var groupResponse = graphClient?.Groups.GetAsync().Result;
		var groups = groupResponse?.Value;
		List<string> groupList = new List<string>();

		foreach (var group in groups!)
		{
			Console.WriteLine($"Group Display Name: {group.DisplayName} - Group Id: {group.Id}");
			groupList.Add($"Group Name: {group.DisplayName} - Group Id: {group.Id}");

		}
		return groupList.ToArray();
	}
	...
}