用途:这是一份创建高质量 MCP(Model Context Protocol)服务器的开发指南。MCP 服务器提供工具,让 LLM 能访问外部服务与 API;服务器质量以能否帮 LLM 完成真实任务来衡量。
主要流程分四个阶段:一是深度研究与规划,包括理解以 Agent 为中心的设计原则(为工作流而非仅 API 端点构建工具、优化有限上下文、设计可操作的错误信息、按自然任务划分子工具、采用评估驱动开发),查阅 MCP 协议文档、框架文档与 API 文档,并制定实施计划(工具选择、共享工具与辅助函数、输入/输出设计、错误处理策略)。二是实现,搭建项目结构,先实现核心基础设施,再系统化实现工具(定义输入 schema、编写完整 docstring、实现逻辑、添加工具注解),并遵循语言特定最佳实践。三是审查与优化,进行代码质量检查、测试与构建,使用质量清单验证。四是创建评估,生成 10 个独立、只读、复杂、真实、可验证且稳定的评估问题,以 XML 格式输出。
必要用法:查阅 MCP 协议文档可获取 https://modelcontextprotocol.io/llms-full.txt;Python 实现可获取 https://raw.githubusercontent.com/modelcontextprotocol/python-sdk/main/README.md,使用 MCP Python SDK 与 Pydantic;Node/TypeScript 实现可获取 https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/main/README.md,使用 MCP TypeScript SDK 与 Zod。测试时注意 MCP 服务器是长时间运行进程,直接运行会挂起,建议用评估工具、tmux 或 timeout 5s python server.py;Python 可用 python -m py_compile your_server.py 校验语法,TypeScript 可运行 npm run build。
限制:具体依赖版本、安装命令、完整代码示例及评估脚本细节资料暂未提供。