用途:指导开发者构建高质量 MCP 服务器,使大语言模型能通过精心设计的工具完成真实任务。适用于为外部 API 或服务构建 MCP 集成、为已有 MCP 服务器添加工具、改进工具设计以提升智能体可用性、创建评估测试,以及调试智能体难以使用的 MCP 工具。
主要能力与核心理念:以智能体为中心设计,而非简单封装 API。每条工具需优化上下文效率、工作流完成度、可操作的错误提示与自然任务拆分。文档提供四阶段工作流:研究与规划(约40%精力)、实现(约30%)、评审与精炼(约15%)、创建评估(约15%)。内容包括设计原则、通用 MCP 最佳实践(命名、响应格式、分页、字符限制、安全、工具注解、错误处理)、Python FastMCP 与 TypeScript MCP SDK 实现指南、评估指南,并可与系统化调试、测试驱动开发、完成前验证等技能配合。
使用方式:先加载设计原则文档,再获取 MCP 规范与 SDK 文档,彻底研究目标 API;随后按语言创建项目结构,先构建共享工具函数与校验(Pydantic 或 Zod),再实现工具;接着做代码质量评审与构建测试;最后创建 10 个复杂、只读、独立、可验证的问题进行智能体效果评估。须知:不要直接运行服务器(会挂起),应使用评估装置或 tmux。
限制:具体安装命令、版本号、依赖与完整代码示例本文资料暂未提供;效果数据来自开发经验描述,并非保证结果。