【亲测免费】 Model Context Protocol C SDK 使用教程

1. 项目介绍

Model Context Protocol C# SDK 是一个开源项目，为 .NET 应用程序、服务和库提供了与 Model Context Protocol (MCP) 进行交互的能力。MCP 是一个开放协议，它标准化了应用程序向大型语言模型（LLMs）提供上下文的方式，实现了 LLMs 与各种数据源和工具的安全集成。

2. 项目快速启动

安装

首先，您需要通过 NuGet 安装 MCP C# SDK 包：

dotnet add package ModelContextProtocol --prerelease

创建客户端

以下是一个创建 MCP 客户端并连接到服务器的示例：

var client = await McpClientFactory.CreateAsync(new McpClientOptions
{
    Id = "everything",
    Name = "Everything",
    TransportType = TransportTypes.StdIo,
    TransportOptions = new Dictionary<string, object>
    {
        ["command"] = "npx",
        ["arguments"] = "-y @modelcontextprotocol/server-everything"
    }
});

// 打印服务器提供的工具列表
foreach (var tool in await client.ListToolsAsync())
{
    Console.WriteLine($"{tool.Name} ({tool.Description})");
}

// 调用一个工具（通常由 LLM 工具调用驱动）
var result = await client.CallToolAsync("echo", new Dictionary<string, object?>
{
    ["message"] = "Hello MCP!"
}, CancellationToken.None);

// echo 总是返回一个文本内容对象
Console.WriteLine(result.Content.First(c => c.Type == "text").Text);

创建服务器

以下是一个创建 MCP 服务器并注册应用程序中所有工具的示例：

var builder = Host.CreateApplicationBuilder(args);
builder.Logging.AddConsole(consoleLogOptions =>
{
    // 配置所有日志输出到 stderr
    consoleLogOptions.LogToStandardErrorThreshold = LogLevel.Trace;
});

builder.Services.AddMcpServer()
    .WithStdioServerTransport()
    .WithToolsFromAssembly();

await builder.Build().RunAsync();

注册工具

这里是一个注册工具的例子，包括一个简单的 Echo 工具：

[McpServerToolType]
public static class EchoTool
{
    [McpServerTool, Description("Echoes the message back to the client.")]
    public static string Echo(string message) => $"Hello {message}";
}

3. 应用案例和最佳实践

在这一部分，您将学习如何在实际应用中使用 MCP C# SDK。我们将提供案例代码和最佳实践，帮助您更好地集成和使用 SDK。

4. 典型生态项目

在这一部分，我们将介绍一些使用 MCP C# SDK 的典型生态项目，包括它们的功能和如何与这些项目进行交互。

请注意，以上代码和说明仅为快速启动示例，实际使用时可能需要根据具体需求进行调整。随着项目的进展，我们将提供更多详细文档和示例代码。