MCP Server ≠ SDK API,它是和人(以及 LLM)打交道的接口,因此对接口易懂性要求极高:
- 参数简化:像 ak/sk、region、project、logstore 等环境级参数应通过 Server 生命周期注入,而非每次都要求 LLM 提供。
- 原子化:一个 Tool 只做一件事,避免链式依赖。例如把 getLogs 拆成 get_index、get_fields_desc、get_uv 等具体功能。
- 避免万能 query 接口:LLM 很难正确生成复杂的 query 语法,成功率接近 0。
- 按业务模块划分:把常用操作封装成语义清晰的 MCP Tools。
简单来说:"三岁小孩都能懂"的 MCP Tools 才是好 Tools。




