40个MCP服务器的工程教训
Background-Job-862 · reddit · 2026-07-14
作者复盘了构建约 40 个 MCP servers 后踩到的几个典型坑，重点不是概念而是工程实现。 主要经验包括： - **不要手写太多 server 包装层**：给每个内部 API 单独写一套 server 不可扩展；他们后来改用把 OpenAPI 规格直接转换成 MCP tools，把新 server 的搭建时间从一天降到一小时以内。 - **工具粒度要适中**：太细会浪费模型上下文，太粗又容易让模型参数填错。最终更合理的是按“用户意图”而不是按底层 endpoint 划分。 - **错误信息要给模型看**：结构化、可解释的错误提示能明显减少 agent 在失败调用上反复重试。 - **认证与凭据要统一管理**：自研 server 容易出现每个服务一套不同的 auth 逻辑，带来 credential sprawl。 最后他们把新 server 创建迁移到 Truefoundry 的工具上，借助 OpenAPI→MCP 转换和托管 stdio server 统一处理认证。