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

news2025/4/15 10:35:12

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项目

1) 创建一个基于.NET9的Asp.NET Core WebApi项目

2) 添加nuget package ModelContextProtocol.AspNetCore (版本是0.1.0-preview.7)

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

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

4) 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();
	}
	...
}