MCP 工具命名指南：让模型正确选择工具

先给结论

名称表达动作和对象，描述同时写适用场景与禁用场景，参数避免含义模糊的布尔组合。

判断起点

通过名称、描述、参数和负面边界减少误调用。MCP 解决的是客户端发现并调用外部能力的连接问题，不替代服务本身的鉴权、安全和业务校验。协议能够连接成功，只说明消息可以往返，不能证明返回数据正确或工具值得信任。

推荐做法

命名和描述会直接影响模型选择能力。名称使用清楚的动作加对象，描述写明何时使用、何时不用、是否产生副作用；参数保持单一含义。两个工具职责重叠时，优先合并边界，而不是通过更夸张的描述争取调用。

核验重点

• 服务声明的工具与实际权限是否一致
• 传输方式和凭据存储是否适合部署环境
• 失败、超时和返回数据是否可追踪

把检查结果写成可复测记录，至少包含日期、版本、环境、输入样例和结果。这样项目升级或需求变化后，团队可以判断原结论是否仍然成立。

进一步验证

引入新架构前，用现有 API 或普通函数实现一个基线版本。如果统一发现、跨客户端连接或状态编排没有带来可测收益，就保留简单方案。额外协议和框架会增加升级、监控与排错责任，技术流行度不是采用理由。

常见误区

用夸张或重叠描述争夺工具选择，会降低整个工具集的稳定性。同时不要把“能够运行”直接解释为“适合生产”，个人试验与长期服务对权限、稳定性、监控和维护的要求不同。

如何形成自己的结论

围绕本文主题准备一个代表性样例，先记录当前方案的基线，再使用候选方案重复同一任务。比较最终正确性、人工修正、耗时、资源或调用成本以及失败恢复情况；如果结果会影响重要数据或线上服务，应先在隔离环境验证。

留下可复查记录

日志服务于定位而不是永久保存全部上下文。建议记录请求标识、版本、动作、耗时、结果规模和错误类型，对参数按敏感级别脱敏。建立保存期限和删除流程，并实际验证异常堆栈不会意外打印令牌、文档原文或个人数据。

参考来源

• MCP Specification

本文根据以上公开项目整理，不复制 README 全文。仓库功能、许可证和维护状态可能变化，使用或分发前请再次查看原始页面。