内容提要
本专栏介绍如何用Go构建MCP Server。MCP为AI应用提供标准化工具接口,无需重写现有后端,只需增加适配层;CLI与MCP各有优势,可组合使用。专栏共14讲,围绕订单管理系统,从首个Tool逐步扩展到多工具、资源、授权、幂等、测试与部署,帮助Go开发者将企业能力安全开放给AI Agent。
延伸解读
MCP 是适配层,不是重写后端
文章明确澄清一个常见误解:引入 MCP 不意味着重写现有后端。如果订单查询逻辑已由 Go 服务实现,合理做法是在领域服务之外增加 MCP 适配层,把 MCP 请求映射到已有应用服务,再将结果转换为适合 AI 客户端理解的响应。这意味着工程重点不只是注册 Tool,还包括工具契约设计、读写操作区分、身份与租户传递、授权、失败处理以及测试观测部署。
CLI 与 MCP 处于不同抽象层次
针对“Agent 能直接调 CLI,MCP 是否多余”的疑问,文章指出两者解决的问题不同。CLI 适合命令组合、管道处理和本地自动化,对拥有终端权限的 Agent 更轻量灵活;MCP 则提供跨语言、跨平台的标准化能力接口,便于不同 AI Host 统一发现和调用远程或本地服务。企业场景更需要明确能力边界、结构化输入输出、统一认证授权和可审计治理,因此两者并非二选一,可以组合使用。
选择 Go 是为了延续工程体系
文章选择 Go 的理由不只是语言流行,而是许多企业后端和云原生基础设施已用 Go 构建。使用 Go 官方 MCP SDK 增加接入层,可以延续现有语言、工程规范、测试体系和部署方式。更重要的是把 Go 中成熟的工程思想带进 MCP 服务:用接口隔离领域逻辑与协议适配,用类型化结构定义输入输出,用 context.Context 贯穿请求生命周期,用自动化测试验证工具契约和协议交互。
真正的工程工作从第一个 Tool 之后开始
专栏围绕订单管理系统逐步扩展,从 get_order 开始,加入库存、工单、资源以及取消订单、创建工单等有副作用的操作。文章强调,完成一个能返回订单信息的 Tool 只说明协议链路跑通,不能证明服务可安全接入生产环境。后续还需面对工具命名与参数 Schema 如何避免模型误用、Tool 与 Resource/Prompt 的选用、stdio 与 Streamable HTTP 的部署差异、身份与权限、写操作幂等、超时并发限流以及协议集成测试等问题。
Q&A
MCP 是什么?它和传统 API 有什么区别?
MCP(Model Context Protocol)是一套标准化协议,用于 AI Host、MCP Client 与 MCP Server 之间的交互。服务端可通过 Tools 暴露可执行动作,通过 Resources 提供可读上下文,通过 Prompts 提供任务模板。传统 API 是为程序调用设计的,不天然具备 AI 应用所需的发现、描述和交互方式;MCP 则让 AI 应用能以统一方式发现和调用能力,并交换结构化参数、结果和上下文资源。
引入 MCP 需要重写现有的后端系统吗?
不需要。如果订单查询逻辑已由 Go 服务实现,无需为 MCP 重写业务逻辑。更合理的做法是在现有领域服务之外增加一个 MCP 适配层,负责把 MCP 请求映射到已有应用服务,再将结果转换成适合 AI 客户端理解的响应。
CLI 和 MCP 是二选一的关系吗?
不是。CLI 适合命令组合、管道处理和本地自动化,拥有庞大的 Unix 工具生态;MCP 提供跨语言、跨平台的标准化能力接口,适合企业场景中明确能力边界、结构化输入输出、统一认证授权和可审计治理。两者处于不同抽象层次,可以组合使用,例如 CLI 作为 Agent 运行环境,MCP 承担工具连接和能力暴露。
为什么这个 MCP 专栏选择用 Go 来构建?
Go 在企业后端、云原生基础设施和网络服务中广泛应用。对于已使用 Go 的团队,用 Go 官方 MCP SDK 增加 MCP 接入层可以延续现有语言、工程规范、测试体系和部署方式。同时能把 Go 中成熟的工程思想带入 MCP 服务,如接口隔离领域逻辑与协议适配、类型化结构定义输入输出、context.Context 贯穿请求生命周期、自动化测试验证工具契约等。
这个专栏会围绕什么项目展开,包含哪些内容模块?
专栏围绕一个虚构的企业订单管理系统展开,共14讲,分四个模块:第一模块(01–03)建立心智模型,理解协议并搭建 Go 项目骨架;第二模块(04–06)实现第一个 Tool、工具契约和传输方式;第三模块(07–09)组织多工具、Resources/Prompts 和安全写操作;第四模块(10–14)覆盖授权、可靠性、测试观测、部署和综合实战,最终具备生产化交付能力。
完成这个专栏后能掌握哪些 MCP 工程能力?
读者将能够:理解 MCP Host、Client、Server 及 Tool 调用的基本链路;使用 Go 官方 SDK 构建 MCP Server 和类型化 Tool;将 MCP 适配层与领域服务解耦;设计清晰的工具名称、描述、输入 Schema 和输出结构;根据场景选择 stdio 或 Streamable HTTP;合理使用 Tools、Resources 和 Prompts;为写操作设计授权、确认、幂等和审计机制;处理 context 取消、超时、并发、限流和下游故障;建立协议集成测试、可观测性与部署流程。