https://cygnusyang.github.io/collections/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/05-mcp/技术 × 产品 × 机器人Hugo 0.160.1 & FixIt v0.4.6-20260517062719-ed8ec5c2zh-CNruohuyang@163.com (Cygnus Yang)ruohuyang@163.com (Cygnus Yang)Sat, 23 May 2026 00:00:00 +0800https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/05-mcp/mcp-deep-dive/Sat, 23 May 2026 00:00:00 +0800ruohuyang@163.com (Cygnus Yang)https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/05-mcp/mcp-deep-dive/<blockquote> <p>本文站在开发者视角，带你从&quot;写一个最简单的 MCP Server&quot;开始，逐步理解核心概念，最终掌握完整的开发实践。</p> </blockquote> <hr> <h2 class="heading-element" id="目录"><span>目录</span> <a href="#%e7%9b%ae%e5%bd%95" class="heading-mark"> <svg class="octicon octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg> </a> </h2><ol> <li><a href="#1-快速上手5-分钟写出第一个-mcp-server">快速上手：5 分钟写出第一个 MCP Server</a></li> <li><a href="#2-理解-tools让-ai-调用你的函数">理解 Tools：让 AI 调用你的函数</a></li> <li><a href="#3-理解-resources为-ai-提供背景数据">理解 Resources：为 AI 提供背景数据</a></li> <li><a href="#4-理解-prompts为用户预设交互模板">理解 Prompts：为用户预设交互模板</a></li> <li><a href="#5-深入核心架构与协议">深入核心：架构与协议</a></li> <li><a href="#6-传输选择stdio-vs-streamable-http">传输选择：stdio vs Streamable HTTP</a></li> <li><a href="#7-进阶实践认证日志进度追踪">进阶实践：认证、日志、进度追踪</a></li> <li><a href="#8-配置与部署在-claude-中使用">配置与部署：在 Claude 中使用</a></li> </ol> <hr> <h2 class="heading-element" id="1-快速上手5-分钟写出第一个-mcp-server"><span>1. 快速上手：5 分钟写出第一个 MCP Server</span> <a href="#1-%e5%bf%ab%e9%80%9f%e4%b8%8a%e6%89%8b5-%e5%88%86%e9%92%9f%e5%86%99%e5%87%ba%e7%ac%ac%e4%b8%80%e4%b8%aa-mcp-server" class="heading-mark"> <svg class="octicon octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg> </a> </h2><p>让我们直接开始——先写出一个能运行的 MCP Server，然后再理解它是怎么工作的。</p>