文章目录

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

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

3.2 配置大模型

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

推荐模型

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

获取 OpenRouter API Key（以 OpenRouter 为例）

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

在 Cline 中填入配置

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

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

四、MCP 完整工作流程

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

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

在这里插入图片描述

五、手动配置 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.somcp.so
mcpmarket.commcpmarket.com
smithery.aismithery.ai

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

八、总结

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

掌握本文内容后，你已经可以：

  • ✅ 理解 MCP 的整体架构与数据流转
  • ✅ 配置任意 MCP Host 使用现有 MCP Server
  • ✅ 手动编写 JSON 配置接入 uvx/npx 类 Server
  • ✅ 从 MCP 市场找到合适工具并快速集成
# 前端
Logo
MCP技术社区

欢迎加入 MCP 技术社区！与志同道合者携手前行，一同解锁 MCP 技术的无限可能！

更多推荐

Google能索引，AI却抓不到

很多技术团队有个错觉：只要Google能正常收录，内容就没问题。但现实是，你的页面在Google搜索结果里好好的，在ChatGPT、Perplexity、Claude的答案里却像从未存在过一样。

avatar MCP技术社区
cover

Windows 下部署 New API 中转站全过程实录（含 6 个真实踩坑）

avatar MCP技术社区

初识智能体

在过去两年中，几乎所有人都体验过大语言模型（如 ChatGPT、Claude、DeepSeek）的强大能力：写周报、润色邮件、解答编程疑难。被动响应：你问一句，它答一句。如果你的 Prompt 没有写清楚约束条件，它无法主动追问或修正目标。知行脱节：大模型能用流畅的文字告诉你“如何部署一个高可用 K8s 集群”，但它无法替你登录服务器敲下命令、查看报错日志并自动回滚。信息孤岛：大模型的知识止步于预

avatar MCP技术社区