MCP工程
用于构建有效MCP工具服务器的生产测试模式。基于12个多月使用FastMCP、Pydantic和JMESPath进行MCP开发的经验。
这些模式源于构建和操作人工智能代理每天消耗的多个MCP服务器。重点是可测量地影响代理准确性、响应质量和令牌效率的实际决策。
模式
MCP设计模式 --主要文件包括:
- 哲学 --整合过度增殖,docstrings=代理入职,信号过于灵活
- 工具设计 --命名约定、统一列表工具、投影、CRUD操作、参数描述
- 响应设计 --信封模式、ID模式、响应格式(TSV、TOON、JSON)、令牌预算
- 查询引擎 --JMESPath具有自定义搜索()、类型安全模式、过滤器→ sort → 分页→ 项目管道
- 令牌优化 --6种测量技术,13种工具的代币减少8.9%
- 测试 --单元+合约测试,强制性模式快照测试
- 反模式 --常见错误及应采取的措施
堆栈
fastmcp, pydantic, jmespath, httpx
工作簿
这 workbook/ 该目录包含来自构建MCP服务器的原始笔记和观察结果,这种非结构化思维最终成为了模式文档。
未来计划
- 测量工具设计质量评价框架
- 示例实现
- 在开发过程中应用模式的代理技能
许可证
麻省理工学院
