在Microsoft.Extensions.AI中集成远程HTTP工具的方法

Microsoft.Extensions.AI是.NET生态中用于构建AI应用的重要扩展库，其中的AIFunctionFactory提供了将本地方法注册为AI可调用工具的能力。但在实际开发中，我们经常需要将远程HTTP服务（如MCP Server）也集成到AI工具链中。

背景与挑战

传统上，AIFunctionFactory.Create方法仅支持注册本地C#方法作为AI工具。当开发者需要将远程HTTP服务（如运行在localhost:3001的MCP Server）暴露的API（如GetInsights）集成到ChatOptions.Tools时，会遇到直接集成困难的问题。

解决方案

通过使用ModelContextProtocol(MCP)的官方C# SDK，我们可以实现远程HTTP工具的集成。以下是具体实现方法：

MCP服务端配置

首先需要在MCP服务端进行正确配置，使其能够通过HTTP协议提供工具服务：

// 添加MCP服务并配置HTTP传输
builder.Services.AddMcpServer()
    .WithHttpTransport()
    .WithToolsFromAssembly();

var app = builder.Build();

// 映射MCP端点并启动服务
app.MapMcp();
app.Run("http://localhost:3001");

客户端集成

在需要使用这些远程工具的AI应用中，可以通过以下方式集成：

// 创建MCP客户端连接
var mcpClient = await McpClientFactory.CreateAsync(
    new SseClientTransport(new SseClientTransportOptions
    {
        Endpoint = new Uri("http://localhost:3001/sse")
    })
);

// 获取远程工具列表
var tools = await mcpClient.ListToolsAsync();

// 将远程工具添加到ChatOptions
var response = await client.GetResponseAsync(request.message, new ChatOptions
{
    Tools = [..tools],
});

技术要点

1. SSE传输协议：MCP客户端使用Server-Sent Events(SSE)作为默认传输协议，适合实时通信场景。

2. 工具发现机制：ListToolsAsync方法会自动发现远程服务暴露的所有可用工具。

3. 无缝集成：获取的McpClientTool实例可以直接作为AIFunction使用，无需额外转换。

4. 服务端工具注册：WithToolsFromAssembly方法会自动注册程序集中所有符合条件的工具方法。

最佳实践

1. 确保MCP服务端和客户端使用兼容的协议版本。

2. 对于生产环境，建议配置HTTPS而非HTTP以确保通信安全。

3. 考虑实现工具版本控制机制，便于后续维护和升级。

4. 在工具方法实现中加入适当的错误处理和日志记录。

通过这种方式，开发者可以轻松地将任何符合MCP协议的远程HTTP服务集成到Microsoft.Extensions.AI构建的AI应用中，大大扩展了AI工具的可选范围和应用场景。