MCP工具服务器设计模式

基于FastMCP、Pydantic和JMESPath的MCP工具服务器设计模式,旨在提高AI代理的准确性、响应质量和令牌效率。

  • by iorlas
  • 本地部署
  • 更新于
在 GitHub 查看 iorlas/mcp-engineering

使用说明

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服务器的原始笔记和观察结果,这种非结构化思维最终成为了模式文档。

未来计划

  • 测量工具设计质量评价框架
  • 示例实现
  • 在开发过程中应用模式的代理技能

许可证

麻省理工学院