MCP协议零基础入门：从概念到第一个Server（基于2026-07-28 RC版）

MCP协议零基础入门：从概念到第一个Server（基于2026-07-28 RC版）

一句话总结：MCP（Model Context Protocol）是AI Agent连接外部工具的统一协议，类似AI世界的USB-C接口，让任何Agent通过标准协议调用任何工具。

适合谁：非AI背景开发者、运维工程师、技术决策者、高校教学管理者

你能学到：① MCP协议核心概念（Tools/Resources/Prompts）② 2026-07-28 RC规范的无状态化变革 ③ 用Python 5分钟搭建第一个MCP Server

专栏：🔌MCP协议实战与架构专栏：从入门到生产环境

⚠️ 版本状态说明（截至2026-07-28）

2026-07-28规范目前处于Release Candidate阶段，已于2026-05-21锁定RC内容，正在进行为期10周的验证窗口。
官方计划2026年7月28日发布最终规范，但具体细节仍可能调整。
当前 finalized 版本仍为 2025-11-25。本文基于RC版内容撰写，供技术预研参考。

⚠️本文时效性

• 首次发布：2026-07-28
• 最后更新：2026-07-28
• 适用版本：mcp Python SDK >= 2.0.0b2（Beta）
• 预计失效：2026-07-28 正式版发布后，Beta API 可能有调整

历史变更

日期	变更内容	影响
2026-07-28	初稿，基于RC规范撰写	—

一、前置条件与验证环境（L4 证据扎根）

1.1 验证环境

1.2 依赖安装

# 创建虚拟环境（推荐）python-mvenv mcp-env# Windowsmcp-env\Scripts\activate# macOS/Linuxsourcemcp-env/bin/activate# 安装指定版本（锁定版本号，确保可复现）pipinstallmcp==2.0.0b2# 验证安装python-c"import mcp; print(mcp.__version__)"# 预期输出：2.0.0b2

⚠️风险提示：

• mcp==2.0.0b2为 Beta 版本，API 可能在正式版发布后调整
• 生产环境建议等待 finalized 版本的 SDK，或使用 TypeScript SDK（已更成熟）
• 稳定版（v1.x）已发布至 1.28.1，生产环境可直接使用
• npm install @modelcontextprotocol/inspector需 Node.js 18+ 环境

1.3 requirements.txt

mcp==2.0.0b2

二、一个类比：MCP就是AI世界的"USB-C接口"

在理解MCP之前，让我们先做一个思想实验。

想象你买了一台新笔记本电脑。它只有一个USB-C接口，但你可以用它：

• 连接显示器（视频输出）
• 插入U盘（数据存储）
• 接入网线（网络通信）
• 连接电源（电力供应）
• 外接显卡（性能扩展）

USB-C的魔力在于：一个物理接口，统一了所有外设的连接方式。

在AI Agent的世界里，MCP（Model Context Protocol，模型上下文协议）扮演的就是类似角色。

在MCP出现之前，如果你想让AI助手（如Claude、ChatGPT）连接外部工具，每个工具都需要单独开发"适配器"：

• 连接GitHub？写一套GitHub API封装
• 连接数据库？再写一套数据库驱动
• 连接搜索引擎？又要写一套搜索接口

MCP的愿景是：让任何AI Agent，通过统一的协议，连接任何外部工具。

就像USB-C让"一个接口连接万物"成为可能，MCP让"一个协议连接万Tool"成为现实。

💡你有没有遇到过这种情况？
你想让AI助手帮你查数据库、读文件、调API——结果每个工具都要单独对接，开发成本比写Agent本身还高。MCP就是来终结这种"适配器地狱"的。

根据MCP官方博客，截至2026年3月，MCP Python + TypeScript SDK月下载量已达9700万，16个月内超过React、GraphQL、Kubernetes同期采纳速度，获得OpenAI、Google、Microsoft、AWS全面支持 MCP官方博客。

三、MCP协议核心概念图解

3.1 协议架构：三层模型

MCP协议采用经典的三层架构设计：

┌─────────────────────────────────────────┐ │ 第一层：Host（宿主） │ │ Claude Desktop / Cursor / VS Code │ │ 负责：用户交互、LLM调用、权限管控 │ ├─────────────────────────────────────────┤ │ 第二层：Client（客户端） │ │ MCP Client SDK │ │ 负责：协议握手、请求路由、能力发现 │ ├─────────────────────────────────────────┤ │ 第三层：Server（服务端） │ │ GitHub MCP Server / PostgreSQL MCP Server│ │ 负责：工具实现、资源暴露、提示模板 │ └─────────────────────────────────────────┘

关键洞察：MCP不是直接让LLM调用工具，而是通过Client作为"翻译官"，将LLM的自然语言意图转换为结构化的协议调用。

3.2 三大核心原语：Tools、Resources、Prompts

MCP Server向Client暴露三种能力，构成了协议的完整语义空间：

三者关系：Tools是"手"（执行动作），Resources是"眼"（获取信息），Prompts是"脑"（组织流程）。

3.3 传输模式：三种"数据线"

MCP支持三种传输模式，对应不同的部署场景：

🚨2026-07-28 RC版重大变革：协议层从有状态转向无状态，彻底取消了initialize握手和Mcp-Session-Id会话绑定。
这意味着HTTP Stream模式成为生产环境的首选，MCP Server可以像普通无状态HTTP服务一样水平扩展。

3.4 快速选型表

四、MCP vs Function Calling vs gRPC：选型对比（L1 科学逻辑）

很多开发者会问：MCP和OpenAI的Function Calling有什么区别？和gRPC呢？

4.1 方案对比

4.2 边界说明

✅推荐使用MCP的场景：

• 需要对接3个以上外部工具的Agent系统
• 需要跨多个LLM（Claude + GPT + 国产模型）复用同一套工具
• 多人协作的工具生态，需要动态发现能力

❌不推荐使用MCP的场景：

• 只有1-2个简单工具，Function Calling更轻量
• 超高性能要求的内部微服务通信（选gRPC）
• 对延迟极度敏感的实时系统（stdio模式有进程启动开销）

⚠️一句话总结：Function Calling是"一个厂商的解决方案"，gRPC是"性能优先的通信框架"，MCP是"整个AI行业的标准工具接口"。

五、零代码体验：用MCP Inspector理解MCP

在写代码之前，让我们先用MCP Inspector（官方调试工具）零代码体验MCP的工作流程。

5.1 安装与启动

# 安装MCP Inspector（锁定版本号，0.22.0为经典版最终版）npminstall-g@modelcontextprotocol/inspector@0.22.0# 验证安装npx @modelcontextprotocol/inspector--version# 预期输出：0.22.0# 启动Inspector，连接到一个示例Servernpx @modelcontextprotocol/inspectornodebuild/index.js

Inspector会在浏览器中打开一个调试界面，你可以：

• 查看Server暴露的所有Tools、Resources、Prompts
• 手动调用Tool，观察请求/响应的JSON结构
• 测试不同传输模式（stdio/SSE/HTTP Stream）

5.2 交互式体验：调用一个"天气查询"Tool

假设我们连接了一个天气查询MCP Server，在Inspector中可以看到：

Tool列表：

- get_weather 描述：获取指定城市的当前天气 参数： - city: string (required) - 城市名称 - unit: enum ["celsius", "fahrenheit"] - 温度单位

手动调用：

// 请求{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_weather","arguments":{"city":"北京","unit":"celsius"}}}// 响应{"jsonrpc":"2.0","id":1,"result":{"content":[{"type":"text","text":"北京当前天气：晴朗，温度28°C，湿度65%"}]}}

关键观察：MCP协议基于JSON-RPC 2.0，所有交互都是结构化的请求-响应。
LLM不需要理解天气API的具体格式，只需要理解MCP协议的统一格式。

5.3 2026-07-28 RC新特性：无状态请求

在2026-07-28 RC规范下，请求变成了自包含的：

// 2026-07-28 RC 无状态请求格式{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_weather","arguments":{"city":"北京","unit":"celsius"},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"MyClient","version":"1.0.0"}}}}

注意_meta字段：协议版本、客户端信息现在随每个请求携带，不再需要预先的initialize握手。

这是2026-07-28 RC最核心的变革。

六、最小代码验证：5分钟搭建你的第一个MCP Server

现在，让我们用Python实现一个最小可用的MCP Server——一个"教务系统查询"Server，演示如何暴露Tools和Resources。

6.1 完整代码（可直接运行）

# server.py — 教务查询MCP Server（基于mcp SDK 2.0.0b2）""" MCP Server：教务系统课程查询 暴露三种能力：Tool（查询课程）、Resource（课程列表）、Prompt（培养方案模板） 验证环境：Python 3.11.9, mcp==2.0.0b2, Windows 11 """frommcp.serverimportMCPServerfrommcp.typesimportTool,Resource,TextContent# 创建Server实例# 注意：当前为Beta/RC版本，生产环境建议等待 finalized 版本server=MCPServer("course-query-server",version="1.0.0")# 模拟教务数据库COURSES:dict[str,dict[str,str|int]]={"CS101":{"name":"计算机导论","credits":3,"teacher":"张教授"},"CS201":{"name":"数据结构","credits":4,"teacher":"李教授"},"AI301":{"name":"机器学习","credits":3,"teacher":"王教授"},}@server.tool()asyncdefquery_course(course_id:str)->str:""" 查询指定课程ID的详细信息 Args: course_id: 课程编号，如"CS101"、"AI301" Returns: str: 课程信息描述字符串 Raises: 无显式异常，未找到课程时返回提示信息 """course=COURSES.get(course_id)ifnotcourse:returnf"未找到课程：{course_id}，可用课程：{', '.join(COURSES.keys())}"return(f"课程：{course['name']}，"f"学分：{course['credits']}，"f"授课教师：{course['teacher']}")@server.resource("courses://list")asyncdeflist_courses()->str:"""获取所有课程列表（只读数据）"""lines=[f"{cid}:{info['name']}（{info['credits']}学分）"forcid,infoinCOURSES.items()]return"\n".join(lines)@server.prompt()asyncdefstudy_plan_prompt(major:str)->str:""" 生成培养方案查询提示模板 Args: major: 专业名称，如"计算机科学与技术" """returnf"""请帮我查询{major}专业的培养方案，包括： 1. 必修课程列表 2. 选修课程要求 3. 学分分布情况 4. 毕业设计要求"""if__name__=="__main__":server.run(transport="stdio")

6.2 代码解读：三个关键装饰器

6.3 运行与验证

# 步骤1：启动Serverpython server.py# 预期：进程启动，等待stdio输入（无输出即正常）# 步骤2：在另一个终端，使用MCP Inspector连接npx @modelcontextprotocol/inspector python server.py# 预期：浏览器自动打开 http://localhost:6274

在Inspector中，你将看到：

• Tools：query_course（带参数schema，含course_id字段）
• Resources：courses://list（URI格式，可点击读取）
• Prompts：study_plan_prompt（带参数模板，含major字段）

手动验证Tool调用：在Inspector的Tool面板中，输入course_id: "CS201"，点击调用。

预期输出：

课程：数据结构，学分：4，授课教师：李教授

七、踩坑记录：搭建第一个Server时遇到的3个问题（L3 探索图）

🚨踩坑预警：别以为"照着文档写就能一次跑通"，Beta版本的SDK有不少"惊喜"等着你。

7.1 踩坑一览

7.2 关键洞察

Beta/RC版本的SDK文档可能滞后于代码变更。遇到导入错误时，最有效的排查方式是直接查看SDK源码的__init__.py导出列表，而不是搜索文档。

八、2026-07-28 RC规范：从"会话绑定"到"请求自包含"

8.1 旧版（2025-11-25）的问题

在旧版规范中，远程MCP部署需要：

Client → Load Balancer → 固定Server实例 → Session Store ↑______________________________↑ Sticky Session

这带来了生产环境的三大痛点：

1. 粘性会话：负载均衡器必须识别Mcp-Session-Id，将同一客户端固定到同一实例
2. 共享存储：Session状态需要Redis等共享存储，增加复杂度
3. 网关解析：负载均衡器需要深度解析HTTP Body才能获取Session ID，性能损耗

8.2 新版（2026-07-28 RC）的解决方案

新版规范通过6个SEP（Specification Enhancement Proposals）彻底重构了传输层：

核心收益：MCP Server现在可以像普通HTTP服务一样部署——普通轮询负载均衡、无共享Session Store、标准网关路由、水平自动扩展。

正如企查查技术总监杜虎在MCP工程实践中所言：
“协议从’会话绑定’走向’请求自包含’，远程MCP Server不必再被某次会话绑定在某台机器上。”
企查查技术团队

8.3 新旧协议对比：on the wire

2025-11-25 Spec（旧版）：

// Step 1: Initialize and get session ID{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"sample-client","version":"1.0.0"}}}// Step 2: Every request must carry session IDMcp-Session-Id:1a2b3c4d-5e6f-7g8h{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_user","arguments":{"user_id":"u123"}}}

2026-07-28 RC Spec（新版）：

MCP-Protocol-Version:2026-07-28Mcp-Method:tools/call Mcp-Name:get_user{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_user","arguments":{"user_id":"u123"},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"sample-client","version":"1.0.0"},"io.modelcontextprotocol/clientCapabilities":{}}}}

8.4 迁移策略：新旧版本共存

对于已有MCP Server的开发者，官方提供了平滑迁移路径：

⚠️ 官方明确：2025-11-25规范不会立即失效，新规范包含12个月的弃用保护期（SEP-2596）。
“弃用"≠"移除”，旧代码在窗口期内继续工作。

九、2026-07-28 RC的五大进阶特性

9.1 OAuth/OIDC 授权强化

2026-07-28 RC包含重要的授权层变革，使MCP真正企业级就绪：

9.2 JSON Schema 2020-12 升级 (SEP-2106)

• 工具输入/输出Schema采用JSON Schema 2020-12
• 支持oneOf/anyOf/allOf组合、条件判断、$ref/$defs
• 禁止自动解引用外部$refURI（DoS防护）
• Schema深度必须受限

9.3 缓存提示：ttlMs与cacheScope

List和Resource读取结果现在携带ttlMs和cacheScope字段，类比HTTPCache-Control：

{"tools":[...],"ttlMs":3600000,"cacheScope":"user"}

• ttlMs：响应新鲜度时长（毫秒）
• cacheScope：缓存共享范围（user/global/session）

9.4 官方扩展框架：MCP Apps与Tasks

MCP Apps (SEP-1865)：首个官方扩展，允许Server提供交互式HTML界面，Host在沙箱iframe中渲染。

Tasks (SEP-2663)：从核心协议移至扩展，支持长时运行任务——服务器返回task handle，客户端通过tasks/get、tasks/update、tasks/cancel驱动，支持客户端输入和任务取消。

9.5 迁移常见错误警示

十、总结与学习路径

10.1 你已经掌握了

• ✅ 核心概念：Tools（执行）、Resources（读取）、Prompts（模板）
• ✅ 架构模型：Host-Client-Server三层
• ✅ 传输模式：stdio / SSE / HTTP Stream
• ✅ 2026-07-28 RC最新变革：从有状态到无状态
• ✅ 最小代码实现：Python MCP Server（可运行）
• ✅ 选型判断：MCP vs Function Calling vs gRPC

10.2 推荐学习路径

10.3 核心结论

MCP协议正在经历从"实验室玩具"到"生产级基础设施"的关键蜕变。

2026-07-28 RC的无状态化变革，标志着MCP正式迈入企业级部署阶段。

对于高校教务管理者而言，MCP的启示在于：未来的教育信息系统，应当以"能力可发现、接口标准化"的方式构建，让AI Agent能够无缝集成教务数据、课程资源、教学工具，真正实现"AI+教育"的深度融合。

十一、互动时间 💬

💡 你在工作中遇到过哪些"接口不统一"导致的集成难题？

• A. 不同系统用不同协议，对接成本极高
• B. 旧系统没有API，只能手动导数据
• C. 有API但文档不全，全靠猜参数
• D. 其他（评论区说说你的故事）

在评论区告诉我你的选择，你的问题可能成为我下一篇文章的主题！

如果你正在调研MCP协议用于实际项目，也欢迎留言你的场景，我会针对性地给出选型建议。

参考文献

[1] Model Context Protocol Blog. The 2026-07-28 MCP Specification Release Candidate[EB/OL]. 2026-05-21. https://blog.modelcontextprotocol.io/posts/2026-07-28-release-candidate/

[2] WorkOS. The biggest MCP spec update ships July 28[EB/OL]. 2026-06-18. https://workos.com/blog/mcp-2026-spec-agent-authentication

[3] 企查查技术团队. MCP 2026-07-28 发布在即：从API到Agent-Native企业数据基座的工程实践[EB/OL]. 2026-07-17. https://f.sdnews.com.cn/xx/202607/t20260717_4708667.htm

[4] Stacktree. MCP 2026-07-28 spec: what changed, what breaks[EB/OL]. 2026-07-13. https://stacktr.ee/blog/mcp-2026-spec-changes

[5] InfoQ. MCP开发者峰会观察：网关、无状态请求与企业级落地路径[EB/OL]. 2026-04-11. https://www.infoq.cn/article/f4df9bE6zm1wy9pI1xKA

[6] MCP Specification (2026-07-28 RC). Model Context Protocol[EB/OL]. 2026-05-21. https://spec.modelcontextprotocol.io/specification/2026-07-28/

本文遵循CC BY-NC-SA 4.0协议，转载请注明出处。如有技术问题，欢迎在评论区留言，我会持续更新到《MCP Server故障排查手册》中。