ModelContextProtocol C SDK 工具调用问题解析

问题背景

在使用ModelContextProtocol C# SDK（版本0.1.0-preview.12）开发MCP服务器和客户端时，开发者遇到了工具调用无法正常工作的问题。该问题主要涉及JSON-RPC消息格式和工具注册方式两个关键方面。

核心问题分析

1. JSON-RPC方法名格式错误

开发者在使用SDK时错误地使用了"list_tools"和"call_tool"作为方法名，而根据MCP规范，正确的JSON-RPC方法名应为：

• 工具列表请求："tools/list"
• 工具调用请求："tools/call"

这种格式差异会导致服务器无法正确识别和路由请求，使得通信失败。

2. 工具注册方式冲突

代码中同时使用了两种工具注册方式：

• 高级方式：WithToolsFromAssembly自动注册
• 低级方式：自定义ListToolsHandler和CallToolHandler

虽然SDK设计上支持在ToolCollection没有匹配工具时回退到自定义处理器，但这种混合使用方式增加了调试复杂度，特别是在初次使用时容易造成混淆。

解决方案建议

正确使用JSON-RPC方法

开发者应按照MCP规范使用标准方法名格式：

// 错误示例
var listToolsRequest = new { method = "list_tools" };

// 正确示例
var listToolsRequest = new { method = "tools/list" };

简化工具注册方式

对于大多数场景，推荐优先使用WithToolsFromAssembly自动注册方式：

services.AddModelContextProtocol()
    .WithToolsFromAssembly(typeof(Program).Assembly);

这种方式会自动扫描程序集中的工具类并注册，减少了手动处理的工作量和出错概率。

工具类定义规范

工具类应按照以下规范定义：

[Tool]
public class MyTool
{
    [ToolMethod]
    public string MyMethod(string input)
    {
        return $"Processed: {input}";
    }
}

使用[Tool]标记工具类，[ToolMethod]标记可调用的方法。

调试建议

1. 首先验证基础连接是否正常
2. 检查发送的JSON-RPC请求是否符合规范
3. 使用日志中间件记录请求和响应
4. 从简单工具开始测试，逐步增加复杂度

总结

ModelContextProtocol C# SDK提供了强大的工具调用功能，但需要开发者正确理解和使用其规范。通过遵循JSON-RPC方法命名约定、合理选择工具注册方式，并按照规范定义工具类，可以避免大多数常见问题，构建稳定可靠的MCP服务。