mcp-lens-py

mcp-lens-py 是一个面向大型 MCP 工具目录的渐进式披露（Progressive Disclosure）Python 库与协议规范。随着 MCP 服务器接入的工具端点增多，传统方案要求 AI 模型在每次上下文窗口中加载所有工具定义，导致成本随目录规模线性增长。mcp-lens 用一种简洁的思路解决这个问题：无论后台注册了多少个工具，对 MCP 客户端永远只暴露 3 个稳定的元工具——search_capabilities（搜索能力）、get_capability_schema（获取能力 schema）和 execute_capability（执行能力），工具定义对模型的上下文开销与目录规模无关，真正实现了 O(1) 的固定成本。mcp-lens.registry 是纯 Python 实现，零 MCP 硬依赖，可自由替换传输层（默认提供 FastMCP 适配层）；搜索算法支持插入自定义函数（Postgres 全文检索、向量嵌入等）来替代默认的关键词匹配，3 个元工具的契约接口保持不变。SPEC.md 独立定义了工具名称、Schema 和语义规范，不绑定特定语言实现，可跨语言移植。该方案已在生产环境中验证——在真正的 MCP 服务器中运行了一段时间后才提炼出产品化的库和协议规范，而非纯理论设计。使用方式：pip install mcp-lens 或 uv add mcp-lens，定义 Capability 注册到 CapabilityRegistry，build_server 即可启动服务。适用场景：MCP 服务商管理大量工具端点、AI 编码平台降低模型上下文开销、工具平台希望统一封装能力并对外开放。