.NET文档项目：使用.NET构建最小化MCP服务器快速入门

.NET文档项目：使用.NET构建最小化MCP服务器快速入门

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs

概述

本文将指导您如何使用.NET平台构建一个最小化的模型上下文协议（MCP）服务器。MCP是一种新兴的协议，它允许AI模型与外部服务进行交互，扩展模型的能力边界。通过本教程，您将创建一个能够响应基本请求的MCP服务器，并了解如何将其与AI工具集成。

技术背景

模型上下文协议（MCP）是一种标准化接口，它定义了AI模型如何与外部服务通信。MCP服务器提供了一系列工具（Tools），AI模型可以按需调用这些工具来完成特定任务。这种架构使得AI模型能够突破自身限制，访问外部资源和功能。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

1. 开发工具：

   • .NET 8.0 SDK或更高版本
   • Visual Studio Code编辑器

2. 扩展组件：

   • 安装AI辅助编程工具（如Copilot）的VS Code扩展

项目创建步骤

1. 初始化项目

打开终端，执行以下命令创建新的控制台应用：

dotnet new console -n MinimalMcpServer
cd MinimalMcpServer

2. 添加必要的NuGet包

为项目添加MCP协议支持和相关基础包：

dotnet add package ModelContextProtocol --prerelease
dotnet add package Microsoft.Extensions.Hosting

这些包提供了：

• ModelContextProtocol：MCP协议的C#实现
• Microsoft.Extensions.Hosting：.NET通用的主机构建和服务管理功能

核心代码实现

替换Program.cs文件内容为以下代码：

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using ModelContextProtocol;

var builder = Host.CreateDefaultBuilder(args)
    .ConfigureServices(services =>
    {
        services.AddLogging();
        services.AddModelContextProtocolServer(options =>
        {
            options.UseStdioTransport();
            options.ScanAssemblyForTools(typeof(Program).Assembly);
        });
    });

await builder.Build().RunAsync();

public static class EchoTools
{
    [Tool("Echoes the input value back to the client")]
    public static string Echo(string input) => input;

    [Tool("Reverses the input string and echoes it back")]
    public static string ReverseEcho(string input) 
        => new string(input.Reverse().ToArray());
}

代码解析

1. 主机构建：

   • 使用Host.CreateDefaultBuilder创建通用主机
   • 配置日志服务和MCP服务器

2. MCP服务器配置：

   • UseStdioTransport()：使用标准输入输出作为通信通道
   • ScanAssemblyForTools：扫描程序集查找工具定义

3. 工具定义：

   • Echo：简单的回显工具
   • ReverseEcho：字符串反转工具

开发环境配置

在项目根目录下创建.vscode/mcp.json配置文件：

{
  "inputs": [],
  "servers": {
    "MinimalMcpServer": {
      "type": "stdio",
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "${workspaceFolder}/MinimalMcpServer.csproj"
      ]
    }
  }
}

此配置告诉AI工具如何启动和连接您的MCP服务器。

功能测试

1. 启动AI工具的代理模式
2. 检查工具列表中是否显示您的服务器和两个工具
3. 测试反转功能：
   • 输入："Hello, minimal MCP server!"
   • 预期输出："!revres PCM laminim ,olleH"

最佳实践建议

1. 工具设计原则：

   • 保持工具功能单一且明确
   • 为每个工具添加清晰的描述文档
   • 考虑错误处理和边界条件

2. 性能考虑：

   • 工具实现应尽可能高效
   • 考虑添加缓存机制
   • 避免长时间运行的操作

3. 安全性：

   • 验证所有输入参数
   • 限制敏感操作的访问
   • 考虑添加认证机制

扩展方向

1. 添加更多工具：

   • 计算器功能
   • 数据查询工具
   • 外部API集成

2. 增强功能：

   • 添加状态管理
   • 实现工具组合
   • 支持异步操作

3. 部署选项：

   • 打包为独立服务
   • 添加Docker支持
   • 实现负载均衡

总结

通过本教程，您已经成功构建了一个基本的MCP服务器，并了解了如何将其与AI工具集成。MCP协议为AI模型提供了强大的扩展能力，而.NET平台则为此类服务的开发提供了稳定高效的基础。您可以根据实际需求继续扩展此服务器，添加更多实用工具和功能。

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs