ModelContextProtocol C SDK 中的工具类动态加载机制解析

在 ModelContextProtocol 的 C# SDK 开发过程中，工具类的动态加载机制是一个值得深入探讨的技术点。本文将从技术实现角度分析 SDK 中工具类的加载方式及其演进过程。

静态方法支持阶段

最初版本的 SDK 仅支持静态类和静态方法的工具注册方式。开发人员需要通过 [McpToolType] 和 [McpTool] 特性来标注工具类和方法。这种设计虽然简单直接，但存在明显局限性：

1. 工具类无法利用依赖注入系统
2. 工具方法必须是静态的
3. 工具类之间难以共享状态

非静态方法的支持需求

随着项目发展，开发者提出了对非静态工具类的支持需求。典型场景包括：

• 需要依赖注入的服务组件
• 需要维护内部状态的工具类
• 需要异步执行的工具方法

在示例项目 AspNetCoreSseServer 的 SampleLlmTool 中，开发者已经尝试通过注释说明该工具需要使用依赖注入和异步方法，但初始版本并未实际支持这些特性。

技术实现演进

开发团队经过讨论后，分阶段实现了以下改进：

1. 参数注入支持：首先支持通过方法参数注入服务，如 IServerProvider、IMcpServer 等
2. 实例方法支持：随后增加了对实例方法的支持，同时保持与静态方法的兼容性
3. 依赖注入整合：最终实现了与 ASP.NET Core 依赖注入系统的深度整合

最佳实践建议

基于当前实现，建议开发者采用以下方式定义工具类：

[McpToolType]
public class MyToolService
{
    private readonly ILogger<MyToolService> _logger;

    public MyToolService(ILogger<MyToolService> logger)
    {
        _logger = logger;
    }

    [McpTool]
    public async Task<string> ProcessDataAsync(string input, IMcpServer server)
    {
        _logger.LogInformation("Processing data: {Input}", input);
        // 处理逻辑
        return await Task.FromResult("processed");
    }
}

这种实现方式既支持依赖注入，又能访问 MCP 服务器上下文，同时保持了良好的可测试性。

技术要点总结

1. 工具类不再需要是静态的
2. 工具方法可以是实例方法
3. 支持通过方法参数注入服务
4. 保持与原有静态方法的兼容性
5. 异步方法得到完整支持

这一演进使得 ModelContextProtocol 的 C# SDK 更加符合现代 .NET 开发实践，为开发者提供了更大的灵活性和更强大的功能支持。