048、MCP Tools 开发：工具声明规范、参数 Schema 设计与调用处理的完整流程从一次诡异的“工具调用失败”说起上周五晚上，我在调试一个自定义MCP工具时遇到了一个让人抓狂的问题。工具声明看起来完全正确，参数Schema也按照文档写的，但Claude就是拒绝调用它，日志里只留下一句“Tool not found or invalid schema”。我盯着代码看了两个小时，最后发现是参数描述里多了一个不可见的Unicode空格——从Notion复制过来的。那一刻我差点把键盘摔了。这个经历让我意识到，MCP Tools开发中最容易出问题的不是业务逻辑，而是那些看似简单实则暗坑无数的声明规范和Schema设计。今天这篇笔记，我就把踩过的坑和总结的套路一次性写清楚。工具声明规范：别让Claude“看不见”你的工具MCP协议中，工具声明是一个JSON-RPC请求，核心字段就三个：name、description、inputSchema。但就是这三个字段，我见过至少五种不同的错误写法。name字段的命名陷阱工具名称必须符合小驼峰命名法，且只能包含字母和数字。我见过有人写get_user_info（下划线）、GetUserInfo（大写开头）、get-us