【MCP 快速入门指南】—— 从原理到实战，带你深入掌握MCP（基础篇）

前端百草阁

1202人浏览 · 2026-04-09 18:10:10

前端百草阁 · 2026-04-09 18:10:10 发布

MCP 快速入门指南

前言

MCP 无疑是近期 AI 领域的热点话题。你可能已经看过不少介绍，但关于它的运行原理，是否还是有点摸不着头脑？

对于想深入使用、甚至自己动手开发 MCP 工具的开发者来说，很多教程只是浮于表面 —— 看完之后似乎懂了，又似乎没懂。

本文的目标是：让你不仅知道如何使用 MCP，更能透彻地理解它。

一、MCP 是什么？

MCP，全称 Model Context Protocol（模型上下文协议），由 Anthropic 公司于 2024 年 11 月 25 日 正式发布。

这个名字听起来有点玄乎，先不用纠结它的字面含义，直接看它能做什么更直观。

MCP 能做什么？

简单一句话：MCP 让大模型拥有使用外部工具的能力。

大模型本身其实只会 “问答”，它无法主动操作外部系统。而借助 MCP，我们可以让模型：

使用浏览器上网查询实时信息
操作 Unity 编写游戏
查询实时路况、天气预报
…… 几乎任何可编程的外部工具都可以接入

二、核心概念解析

在动手之前，先把几个关键词搞清楚。

2.1 MCP Host

MCP Host 是一个支持 MCP 协议的软件，是你与 MCP 交互的 “宿主环境”。

常见的 MCP Host：

软件	类型
Claude Desktop	桌面应用
Cursor	代码编辑器
Cline	VS Code 插件
Cherry Studio	桌面应用

本文以 Cline（VS Code 插件） 为例进行演示。

2.2 MCP Server

MCP Server 听起来像传统的远程服务器，但实际上它与传统 Server 并没有太大关系。

本质上，MCP Server 就是一个本地程序，只是它的执行方式符合 MCP 协议规范。

大部分 MCP Server 通过 Node.js 或 Python 在本地启动
使用过程中可以联网，也可以完全本地运行
类比手机上的 App：每个 MCP Server 就是一个功能应用

2.3 Tool（工具）

Tool 是 MCP Server 内部封装的功能模块，本质上就是一个函数。

不熟悉编程的话这样理解：函数就像一台机器 —— 你放入材料（输入），它按规则处理后给你成品（输出）。

举例：天气 MCP Server

Tool 名称	输入	输出
get_forecast	经纬度	未来几天天气预报
get_alerts	美国州代码	气象预警信息

2.4 MCP Host、MCP Client、MCP Server

维度	MCP Host	MCP Client	MCP Server
角色定位	总控中枢、用户交互入口	通信桥梁、协议代理	能力提供者、工具执行者
运行形态	独立的 AI 应用 / 软件	Host 内部的组件 / 模块，非独立进程	独立运行的程序（本地 / 远程）
核心工作	对接 LLM、用户授权、结果聚合、生命周期管理	协议消息收发、连接维护、格式转换	具体工具逻辑执行、API 调用、资源读写
数量关系	1 个 Host	一个 MCP Host（如 Cline）内部仅存在一个 MCP Client，该 Client 可与多个 MCP Server 建立独立连接，并调用各个 Server 提供的工具。	N 个独立的 Server，每个提供不同的能力
用户是否直接操作	是（你直接打开用）	否（Host 内部自动管理，用户无感知）	仅需配置启动命令，不用直接交互
典型例子	Claude Desktop、Cline、Cursor	Cline 内部的连接管理模块	天气 Server、文件系统 Server、GitHub Server

把 MCP Host 当成 AI 助手本体（比如 Cline / Claude Desktop）

MCP Host：你打开的整个软件（主程序）
MCP Server：一个个外部服务（文件系统、GitHub、天气、数据库……）
MCP Client：Host 与 Server 之间建立的 “专属电话线”

AI 编辑器 = MCP Host
Host 内部自带 1 个 MCP Client
Client 负责：连 Server → 查有啥工具 → 转发调用 → 收结果 → 交给 Host 给 LLM

三、环境准备

3.1 安装 Cline

下载并安装 VS Code
在插件市场搜索 Cline，点击安装
安装完成后，左侧边栏会出现 Cline 图标

3.2 配置大模型

点击 Cline 配置图标，选择 API Provider 和模型。

推荐模型

模型	特点
Claude 3.7	对 MCP 支持最好，但费用较高
DeepSeek V3 0324	效果不错，价格极低，推荐性价比之选

获取 OpenRouter API Key（以 OpenRouter 为例）

访问 openrouter.ai，点击右上角 Sign in 登录
鼠标移至右上角头像，点击 Keys → Create Key
填入 Key 名称（如 default）和消费上限（如 5 美元），点击 Create
立即复制保存 Key，页面关闭后无法再次查看
如只使用免费模型，无需充值；如需使用付费模型，点击 Credits 充值即可

在 Cline 中填入配置

配置项	值
API Provider	Open Router
API Key	`你的 Key`
Model	`deepseek/deepseek-chat-v3-0324`（免费版末尾带 `:free`）

注意：Plan Mode 和 Act Mode 都需要分别配置模型。

四、MCP 完整工作流程

配置完成后，我们来看 MCP 从提问到返回结果的完整链路：

步骤	说明
1	用户提问
2	Cline 读取配置 JSON，用命令启动 MCP Server 程序
3	双方建立连接，Cline 询问：有哪些 Tool 可用？
4	MCP Server 返回 Tool 列表（名称 + 参数描述）
5	Cline 将「用户问题 + 可用 Tool 列表」一起发给大模型
6	大模型判断：需要调用哪个 Tool，传什么参数？
7	Cline 向 MCP Server 发起 Tool 调用（需用户 Approve）
8	MCP Server 执行 Tool，返回结果
9	Cline 将结果传回大模型，模型整理后回复用户

在这里插入图片描述

五、手动配置 MCP Server

虽然 Cline 内置了 MCP 市场，支持一键安装，但手动配置更稳定、更可控，也适用于不支持自动安装的 Host。

5.1 配置文件格式

点击 Cline 中的 Configure MCP Server，会打开一个 JSON 文件。新增一个 MCP Server，只需添加对应的启动配置：

{
  "mcpServers": {
    "weather": {
      "disabled": false,
      "timeout": 60,
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-weather"],
      "transport": {
        "type": "stdio"
      }
    }
  }
}

字段	说明
`disabled`	是否禁用该 Server
`timeout`	连接超时时间（秒）
`command`	启动程序的命令（如 `npx`、`uvx`、`node`）
`args`	传给命令的参数列表
`transport.type`	通信方式，主流为 `stdio`（标准输入输出）

六、常用启动方式

MCP Server 大多使用 Python 或 Node.js 编写，对应两种主流启动命令：

6.1 uvx（Python 程序）

uvx 是 uv tool run 的缩写，用于运行 Python 编写的 MCP Server。

前置要求：安装 uv

# 安装 uv（macOS/Linux）
curl -LsSf https://astral.sh/uv/install.sh | sh

# 手动预下载依赖，避免 Cline 中超时
uvx mcp-server-fetch

配置示例（fetch - 网页抓取）

"hot-news": {
  "command": "npx",
  "args": ["-y", "mcp-hot-news"]
}

6.2 npx（Node.js 程序）

npx 是 Node.js 自带的包执行器，用于运行 Node.js 编写的 MCP Server。它会自动下载并执行指定的 npm 包，无需全局安装。

前置要求：安装 Node.js

访问 Node.js 官网，下载并安装 LTS（长期支持）版本。

安装完成后，打开终端验证：

node -v
npm -v
输出版本号即表示安装成功。
手动预下载依赖（推荐）

为避免在 Cline 中因首次下载超时，建议先在终端手动执行一次启动命令：

npx -y mcp-hot-news

说明：-y 参数表示自动确认所有提示，无需手动输入 yes。

配置示例（hot-news - 热点新闻）

"hot-news": {
  "command": "npx",
  "args": ["-y", "mcp-hot-news"]
}

除此之外还有 bunx、直接 node 启动等方式，查阅对应文档即可举一反三。

七、去哪里找 MCP Server？

目前已有大量社区贡献的 MCP Server，常用平台：

平台	网址
mcp.so	mcp.so
mcpmarket.com	mcpmarket.com
smithery.ai	smithery.ai

类比手机应用市场，绝大部分需求都能找到现成的 Server 直接使用。

八、总结

概念	一句话理解
MCP	让大模型能使用外部工具的协议
MCP Host	支持 MCP 的软件，如 Cline、Cursor
MCP Server	封装工具的本地程序，类比手机 App
Tool	MCP Server 内部的功能函数
stdio	Host 与 Server 之间的主流通信方式