当前位置：首页 > news >正文

模型上下文协议（MCP）完全指南：从AI代理痛点到实战开发

news 2026/7/5 16:54:35

模型上下文协议（MCP）完全指南：从AI代理痛点到实战开发

🔍 MCP基础与核心价值（背景）

(一) AI代理的局限性

LLM原生能力边界：大型语言模型（LLM）仅能生成文本/图像等内容，无法直接执行外部操作（如预订航班、调用API）。
- 传统工具集成痛点：第三方平台API接口标准不一（如航班查询接口可能为API/flights、flights/list或list-flights），需手动编写适配代码，扩展性极低。

(二) MCP的定义与定位

全称：模型上下文协议（Model Context Protocol）
核心功能：为AI代理提供与第三方平台交互的标准化上下文，定义工具调用、数据格式及通信规则。
类比：可视为AI代理与外部系统交互的"API使用说明书"，解决跨平台兼容性问题。

🤖 AI代理与MCP的关系（原理）

(一) AI代理工作流

用户输入解析：AI代理调用LLM识别用户意图（如"飞往伦敦"→提取目的地、日期等参数）。
工具选择：LLM协助确定需调用的第三方服务（如航班API、酒店数据库）。
数据交互：代理通过工具获取外部数据（如航班列表），结合用户偏好（如低价优先）。
决策执行：LLM分析数据后生成决策，代理执行操作（如预订航班）并反馈结果。

(二) MCP的解决痛点

无MCP场景	有MCP场景
需为每个API编写定制化适配代码	统一遵循MCP标准，代理自动适配各类服务
工具调用格式混乱（参数/响应不统一）	标准化工具定义（输入输出schema、描述）
无法动态发现第三方服务能力	MCP服务器暴露工具列表，支持自动发现

🏗️ MCP架构与核心组件（技术细节）

(一) 架构 overview

客户端-服务器模型：
MCP客户端：嵌入AI代理（如IDE插件Cursor、Windsurf），发起工具调用请求。
MCP服务器：提供标准化接口，封装第三方服务能力，响应客户端请求。
传输协议：支持HTTP（远程通信）和标准IO（本地进程通信）。

(二) 三大核心组件

组件	定义	示例
资源（Resources）	静态数据或元信息，供AI决策参考	机场代码列表、退改签政策、城市天气数据
工具（Tools）	可执行操作接口，封装第三方API调用	航班搜索（输入：起止地/日期；输出：航班列表）、座位选择
提示（Prompts）	预定义指令模板，优化LLM交互效果	“作为旅行助手，调用search_flights工具时需指定origin/destination/date参数，日期格式为YYYY-MM-DD”

📋 MCP规范与通信协议（标准）

(一) 核心规范要求

通信格式：采用JSON RPC 2.0协议，请求需包含：
jsonrpc: “2.0”（固定版本）
method: 调用的工具名称（如"search_flights"）
params: 输入参数（如{"origin":"LAX","destination":"JFK"}）
id: 请求唯一标识-状态要求：连接必须有状态（Stateful），支持上下文保持（如长对话中的用户偏好记忆）。

(二) 客户端-服务器交互

能力发现：客户端请求MCP服务器暴露资源/工具列表（如list_tools()）。
工具调用：客户端发送标准化请求（如调用search_flights工具）。
上下文传递：服务器返回结构化响应，客户端结合LLM分析结果执行下一步操作。

🛠️ MCP实战开发（操作指南）

(一) 环境准备-

开发工具：Python +fast-mcpSDK（官方推荐）

依赖安装：uv add mcp（通过uv包管理器安装MCP核心库）
Lab环境：提供VS Code服务器、Root Code AI助手及预配置API密钥（如OpenAI兼容接口）。

(二) 服务器开发步骤

1. 初始化服务器

frommcp.server.fastmcpimportFastMCP mcp=FastMCP(transport="stdio")# 传输方式：标准IO（本地）或HTTP（远程）

定义资源（Resource）

@mcp.resource(type="file",name="airports")defget_airport_info():return{"LAX":"洛杉矶国际机场","JFK":"肯尼迪国际机场"}

定义工具（Tool）

@mcp.tool(name="search_flights",description="查询航班信息")defsearch_flights(origin:str,destination:str,date:str):# 调用第三方API逻辑return[{"flight_no":"CA987","price":500}]

定义提示（Prompt）

@mcp.prompt(name="find_best_flight",title="最优航班推荐")deffind_best_flight_prompt(preferences:dict):returnf"根据用户偏好{preferences}，从工具返回结果中选择最低价航班"

启动服务器

mcp.run()# 默认监听标准IO，HTTP模式需指定端口：mcp.run(transport="http", port=8080)

(三) 客户端配置

IDE集成：通过mcp.json文件配置服务器连接信息，示例：

{"mcp_servers":[{"id":"flight-booking","command":"uv run python server.py","env":{"API_KEY":"xxx"}}]}

核心功能：支持资源读取（read_resource(“airports”)）、工具调用（call_tool(“search_flights”, params)）及提示获取（get_prompt(“find_best_flight”)）。

💡 MCP高级特性（进阶）

(一) 客户端三大核心能力

能力	定义	应用场景
Roots（根目录共享）	客户端向服务器暴露本地文件系统路径	AI代理读取项目代码（如Git历史、日志文件）进行调试
Sampling（采样）	服务器请求客户端调用LLM处理数据	服务器将航班列表发送给LLM，由其生成自然语言总结
Elicitation（启发）	服务器通过客户端向用户请求补充信息	航班预订时询问用户"是否需要购买行李额"

(二) 典型应用场景