MCP协议从原理到开发保姆级教程.pdf

MCP协议从原理到开发保姆级教程

目录

1什么是MCP

2MCPServer开发

3MCPClient开发

4MCP的工作原理

5效果呈现

6写在最后

0101

什么是MCP

1.1MCP介绍

MCP（ModelContextProtocol，模型上下文协议）起源于2024年11月25日

Anthropic发布的文章：IntroducingtheModelContextProtocol。

可以用“AI扩展坞”来比喻MCP在AI领域的作用。就像现代扩展坞可以连接显示器、键

盘、移动硬盘等多种外设，为笔记本电脑瞬间扩展功能一样，MCPServer作为一个智能

中枢平台，能够动态接入各类专业能力模块（如知识库、计算工具、领域模型等）。当

LLM需要完成特定任务时，可以像即插即用般调用这些模块，实时获得精准的上下文支

持，从而实现能力的弹性扩展。这种架构打破了传统AI模型的封闭性，让大语言模型像搭

载了多功能扩展坞的超级工作站，随时都能获取最合适的专业工具。

1.2为什么要有MCP

终结工具调用碎片化

不同模型在定义FunctionCall（函数调用）时，采用的结构和参数格式各不相同，使得对

多模型集成、统一管理和标准化接入变得复杂而繁琐。

属性维度OpenAIClaudeGemini

调用结构名称tool_callstool_usefunctionCallfunc

参数格式JSON字符串JSON对象JSON对象JSON

特殊字段finish_reason字段包含id和thinkingargs字段命名与Op

对于开发者来说，针对不同模型去实现不同的工具调用方法，所谓的定制化开发不仅消耗

大量时间和资源，而且维护也变得困难。

而MCP作为一种AI模型的标准化接入协议，能够显著简化模型之间的集成。

实现多功能应用与创新体验的突破

MCP的潜力不仅限于连接现有工具，它还在推动客户端应用向“万能应用”演进，并创造

全新的用户体验。

以代码编辑器Cursor为例，作为MCP客户端，用户可以通过集成不同的MCP服务器，

将其转变为具备Slack消息收发、邮件发送（ResendMCP）、甚至图像生成（Replicate

MCP）等多种功能的综合工作站。

更具创造力的是，在单一客户端中组合多个MCP服务器可以解锁复杂的新流程。例如，AI

代理可以一边生成前端界面代码，一边调用图像生成服务器为主页创作视觉元素。这种模

式超越了传统应用的单一功能限制，为用户带来多样化的操作体验。

0202

MCPServer开发

MCPserver是MCP架构中的关键组件，目前提供3种主要类型的功能，

资源（Resources）：类似文件的数据，可以被客户端读取，如文件内容。

工具（Tools）：可以被LLM调用的函数。

提示（Prompts）：预先编写的prompt模板，帮助用户完成特定任务。

还有其他两种（samping和roots）但是目前还没被很好的支持。

以开发一个企业微信机器人mcpserver为例，用到的是社区sdktypescript-sdk。

（https///modelcontextprotocol/typescript-sdk）

2.1项目搭建开发

可以参考官方quickstart（https//modelcontextp