ModelContextProtocol C SDK 中的 XML 文档工具定义方案探索

在软件开发过程中，良好的工具定义和文档说明对于团队协作和代码维护至关重要。ModelContextProtocol 的 C# SDK 近期讨论了一个关于如何利用 XML 文档注释来定义多行工具描述的功能增强方案。

传统上，C# 开发者使用 [McpServerTool] 属性来定义工具，这种方式简洁但功能有限，特别是在需要提供详细的多行描述时显得力不从心。XML 文档注释作为 C# 生态中广泛使用的文档方式，自然成为了增强工具定义描述能力的候选方案。

ASP.NET Core 的 OpenAPI 集成已经展示了类似的技术路线，它们成功地将 XML 文档注释转化为 API 的 Schema 描述。然而，这种方案在实现上存在一定挑战，主要在于运行时可靠读取 XML 文档的技术难度。对于框架级产品如 ASP.NET Core 来说相对容易实现，但对于库级别的 ModelContextProtocol SDK 则需要更精巧的设计。

从技术实现角度看，[McpServerTool] 属性本质上是对 McpServerTool.Create 方法的语法糖，开发者完全可以通过编程方式自由创建和注册工具实例。SDK 还提供了 McpServerTool 基类用于自定义行为扩展，以及 DelegatingMcpServerTool 这种装饰器模式实现，允许开发者包装现有工具实例来增强或修改其行为。

这种设计为 XML 文档注释的集成提供了良好的扩展点。开发者可以创建自定义的 McpServerTool 派生类，在初始化时读取程序集中的 XML 文档注释，将这些文档内容转化为工具定义的元数据。这种方案既保持了现有 API 的简洁性，又为需要丰富文档的场景提供了支持。

考虑到不同项目的需求差异，这种功能更适合作为可选扩展实现。开发者可以根据项目实际情况决定是否引入 XML 文档支持，而不会强制所有用户承担额外的运行时开销。这种灵活的设计哲学正是现代 SDK 开发的重要原则之一。

对于希望实现类似功能的开发者，建议深入研究 SDK 中 McpServerTool 及相关类型的源代码和测试用例，理解其扩展机制的工作原理。通过合理利用装饰器模式和派生类扩展，可以在不修改核心代码的情况下实现丰富的文档支持功能。