Mindket
工具指南MCP 出品:Anthropic开源

MCP 入门:它是什么,怎么用

MCP,全称 Model Context Protocol(模型上下文协议),是一个开放标准,让 Claude、ChatGPT、VS Code、Cursor 这类 AI 应用可以使用外部系统。每个系统都放在一个 MCP 服务器后面。服务器是运行在你电脑上或某个网址上的程序,向 AI 提供它能调用的工具和能读取的数据。MCP 由 Anthropic 在 2024 年推出,协议本身可以免费使用。

擅长
  • 让 AI 读写文件
  • 在对话里调用工具
  • 查询数据库和接口
  • 一个服务器多应用通用

一眼看懂

  • MCP 是一套标准,不是一个应用。你要通过支持它的 AI 应用,或者像 MCP Inspector 这样的测试客户端来使用它。
  • 先看服务器是运行在你自己的电脑上,还是在某个网址上,这决定了你发出的请求会被谁收到。
  • 想不借助任何 AI 应用就看到服务器工作,启动 MCP Inspector,调用一个工具就行。
  • 本地服务器按你账号的权限运行,添加之前先读一遍它的启动命令。
全部工具
本页目录
  1. YouTube 教程
  2. MCP 是什么
  3. MCP 适合做什么
  4. 什么时候用 MCP,什么时候换别的工具
  5. 怎样使用 MCP,一步步来
  6. 来试一个例子
  7. 用好 MCP 的几个提醒
  8. 深入学习 MCP
  9. 常见问题
  10. 资料来源

MCP 是什么

MCP 是 Model Context Protocol 的缩写,是一个开放标准,用来把 AI 应用接到存放你的文件、数据和工具的系统上。Anthropic 在 2024 年 11 月 25 日把它开源,之后 OpenAI 和 Google DeepMind 也采用了它。2025 年 12 月,Anthropic 把它捐给了 Agentic AI Foundation,这是 Linux 基金会旗下的一个基金。

MCP 不像应用那样需要安装。它是一套规则,由两个程序共同遵守。你聊天用的 AI 应用,比如 Claude、ChatGPT、VS Code 或 Cursor,叫宿主(host)。每个外部系统都放在一个 MCP 服务器(server)后面。服务器是一个小程序,运行在你自己的电脑上或某个网址上,向 AI 提供可调用的工具、可读取的数据和可供你挑选的提示词。协议本身免费,不过有些服务器连接的服务需要你自己的账号或 API 密钥。

MCP 适合做什么

  • 读写你的文件:官方的文件系统服务器可以列出、读取、复制和创建文件,但只限你允许的文件夹。
  • 把设计稿变成代码:Claude Code 通过 MCP 读取 Figma 设计稿里的组件、设计令牌和布局规则,再照着生成代码。
  • 查看日程和笔记:按 MCP 自己的介绍,智能体可以通过对应的服务器读取 Google 日历和 Notion。
  • 查询数据库:架构指南里的例子是,工具负责执行查询,资源保存数据库结构,提示词演示怎样调用这些工具。
  • 把你自己的工具交给每个 AI 应用:用 Python 或 TypeScript 写一个小服务器,所有支持 MCP 的应用都能调用它。
  • 让 n8n 工作流和 AI 互通:n8n 有一个节点让智能体调用 MCP 服务器,还有一个触发器让 n8n 自己变成 MCP 服务器。

什么时候用 MCP,什么时候换别的工具

你的任务用 MCP 吗?或者试试
让 AI 应用访问你的文件、数据库或网络服务用,通过一个 MCP 服务器用 Claude Code 或 Cursor 当使用它的应用
给好几个 AI 应用同时加上你自己的工具用,写一个服务器就行Python 这一课会带你写一个
按计划,或者表单一提交就自动跑一串步骤不用n8n 或 Zapier
聊天、写作或做研究,不接外部系统不用ChatGPT、Claude 或 Gemini
在自己的电脑上运行模型不用,MCP 不运行模型Ollama 或 LM Studio
教 AI 应用一套写成说明的做事流程不用,那是技能的事Agent Skills,见我们的指南

怎样使用 MCP,一步步来

MCP 没有注册页面。想最快看到它工作,就用官方的测试客户端 MCP Inspector,连上一个已发布的服务器。下面六张图在文件系统服务器上调用一个工具,所以不需要 AI 应用,也不用写代码。先在一个文件夹里放几个文件,再到另一个文件夹运行 npm install @modelcontextprotocol/server-filesystem,装好这个服务器。

  1. 在终端里用 node --version 检查 Node,输出应当是 22.23.4、24.22.1 或 26.12.1,或者同一系列里更新的版本,因为 Inspector 要求打过补丁的 Node。然后输入 npx -y @modelcontextprotocol/inspector,后面依次跟 node、服务器 dist\index.js 的完整路径,以及放文件的那个文件夹。终端会打印一个带令牌的网址。图里的令牌属于一次已经结束的启动,你的会不一样。

    一个终端,先显示检查 node 版本,再显示 Inspector 的启动命令,命令下面是启动器的输出。命令和输出都用金色圈出。输出里有网页地址和它的令牌。
  2. 浏览器会自己打开这个网址。如果没有打开新标签页,就从终端复制这个网址。别凭记忆去敲,因为每次启动的令牌都不同。在 Servers 页面,拨动你服务器卡片上的开关。卡片上写着 Inspector 将要运行的命令。

    MCP Inspector 的 Servers 页面。一条 Read-only session 提示下面是一张名为 node 的卡片,标着 STDIO 和 Disconnected,写着它的启动命令。卡片上的连接开关用金色圈出。
  3. 连上之后,页面显示服务器自己的名字。打开 Tools 标签页。列表标题给出工具的数量,这里是 16 个,右侧的 Protocol 栏里,已经记下了取这份列表的 tools/list 请求。

    已连上 secure-filesystem-server 的 Inspector,Tools 标签页用金色圈出。列表标题是 Tools (16),最前面是 Append File、Copy File 和 Create Directory。右侧的 Protocol 栏里有三条已记录的消息。
  4. 在搜索框里输入 list,选中 List Directory。在 path 一栏填你交给服务器的那个文件夹,再选 Execute Tool。

    Tools 标签页里选中了 List Directory。path 一栏填着一个测试文件夹,Execute Tool 按钮用金色圈出。
  5. 结果出现在 Results 下面,每个文件或文件夹一行,标着 [FILE] 或 [DIR]。AI 应用调用工具时做的是同一件事,只不过表单由模型替你填。

    调用之后的 Tools 标签页。用金色圈出的 Results 面板显示 notes.txt 是文件,recipes 是文件夹,shopping.md 是文件。Protocol 栏里有一条 tools/call 消息。
  6. 选 Protocol 标签页,再点 tools/call 卡片上的 Expand。Parameters 框里是客户端发出的内容,Response 框里是服务器的回复,两者都是 JSON-RPC。

    Protocol 栏里,对 list_directory 的 tools/call 请求的卡片已展开,卡片右上角的箭头用金色圈出。Parameters 框里有工具名和一个 path 参数。Response 框里是 jsonrpc 2.0 的结果,文件列表以文字形式给出。

MCP Inspector 2.14.0 在 Windows 上的截图,拍摄于 2026 年 11 月 6 日,服务器是已发布的文件系统服务器。终端那张图是在真实的命令和输出外面画了一个窗口框。那次启动关掉了自动打开浏览器,所以输出里没有 Opening browser... 这一行。

本页顶部的教程视频演示 MCP 在 AI 应用里怎样工作。MCP Inspector 这一课把这些步骤连同每条命令又讲了一遍。

来试一个例子

在官方的文件系统服务器上启动 Inspector。服务器自己的启动命令跟在 Inspector 的名字后面,最后一段是服务器可以读取的文件夹,换成一个放着几个测试文件的文件夹的完整路径。

# The server's own start command goes after the Inspector's name
npx -y @modelcontextprotocol/inspector npx @modelcontextprotocol/server-filesystem /path/to/a/test/folder
  • 启动顺利的话,Servers 页面上会出现一张服务器卡片。打开它,页面就会列出服务器的名字和它的工具。
  • 调用 List Directory,会返回你的文件,每个标着 [FILE] 或 [DIR]。
  • Protocol 标签页里有一张 tools/call 卡片,记着确切的请求和响应。
  • 如果连不上,打开 Console,那里显示本地服务器写到 stderr 的内容。

用好 MCP 的几个提醒

  • 把服务器添加到任何应用之前,先读一遍它的启动命令。本地服务器以你的账号运行,你能手动做的事,它也能做。
  • 先看服务器是本地的还是远程的。远程服务器在它的网址上收到你的请求,本地服务器则在你自己的电脑上启动。
  • 配置文件里用绝对路径。应用从自己的工作目录启动服务器,./data 这样的相对路径可能出错。
  • 需要密钥的服务器,用权限受限的 API 密钥,Cursor 的文档也这样建议。
  • 改了 Claude Desktop 的配置之后,要彻底退出再重新打开,只关窗口不够。

深入学习 MCP

  1. 1MCP 实战课:写、测试并接入 MCP 服务器 · 第 1 节,共 4 节用官方 SDK 写一个 Python MCP 服务器用官方 SDK 写一个 Python MCP 服务器:用 uv 安装,写两个工具,通过 stdio 运行,再到 MCP Inspector 和 Claude Desktop 里验证。6 分钟
  2. 3MCP 实战课:写、测试并接入 MCP 服务器 · 第 3 节,共 4 节MCP Inspector:测试和调试 MCP 服务器学会用 MCP Inspector:对本地或远程服务器启动它,在浏览器里调用工具,查看协议日志,再用命令行模式做同样的检查。9 分钟
  3. 4MCP 实战课:写、测试并接入 MCP 服务器 · 第 4 节,共 4 节把 MCP 服务器接入 Claude Desktop、Cursor 和 VS Code把 MCP 服务器接入 Claude Desktop、Cursor 和 VS Code:每个应用的配置文件、JSON 格式、怎样重新加载,以及没有出现时该去哪里查。7 分钟
  4. 2MCP 实战课:写、测试并接入 MCP 服务器 · 第 2 节,共 4 节用官方 SDK 写一个 TypeScript MCP 服务器用官方 SDK 写一个 TypeScript MCP 服务器:搭好项目,用 Zod 定义工具的参数,通过 stdio 提供服务,再到 Inspector 里调用它。5 分钟

常见问题

MCP 要钱吗?

不要。协议本身免费,代码和规范方面的贡献采用 Apache License 2.0。有些服务器连接的服务需要你自己的账号或 API 密钥,这些服务有各自的条款。

使用 MCP 需要会写代码吗?

不需要。给应用添加一个服务器是改设置,不是编程。只有自己写服务器时才用到代码,官方的 SDK 覆盖好几种编程语言。

MCP 服务器和 API 是一回事吗?

不是,不过很多服务器底层会调用 API。API 是某个服务自己的接口,每个服务的设计都不一样。MCP 服务器把它提供的东西包成统一的格式,所以支持 MCP 的应用不用为这个服务专门写代码,就能列出并调用它的工具。

哪些 AI 应用支持 MCP?

按 MCP 自己的介绍,Claude、ChatGPT、Visual Studio Code 和 Cursor 都在其中。各家有各自的配置文件:Claude Desktop 读 claude_desktop_config.json,Cursor 读 .cursor/mcp.json,VS Code 读 .vscode/mcp.json。

随便添加一个 MCP 服务器安全吗?

不安全。本地服务器按你账号的权限运行,所以读过它的启动命令再添加。MCP 规范还写明,宿主调用工具之前必须得到你的明确同意。先查哪些东西,见我们的 MCP 服务器安全指南。

MCP 和 Agent Skills 有什么区别?

技能是一个装着说明的文件夹,MCP 服务器是通向某个系统的实时连接。两者可以并用,各自适合什么,见我们的 Agent Skills 指南。

自己写的 MCP 服务器怎么测试?

运行 MCP Inspector,把服务器的启动命令放在它的名字后面,比如 npx @modelcontextprotocol/inspector node build/index.js。然后连接、调用一个工具,再到 Protocol 标签页里看消息。

资料来源

  1. Wikipedia: Model Context Protocol (2026年11月6日 查阅)https://en.wikipedia.org/wiki/Model_Context_Protocol
  2. Model Context Protocol: What is MCP? (2026年11月3日 查阅)https://modelcontextprotocol.io/docs/getting-started/intro
  3. MCP docs: Architecture overview (2026年11月2日 查阅)https://modelcontextprotocol.io/docs/learn/architecture
  4. MCP docs: Understanding MCP servers (2026年11月2日 查阅)https://modelcontextprotocol.io/docs/learn/server-concepts
  5. MCP specification: Tools (2026年11月2日 查阅)https://modelcontextprotocol.io/specification/latest/server/tools
  6. Anthropic: Introducing the Model Context Protocol (2026年11月2日 查阅)https://www.anthropic.com/news/model-context-protocol
  7. Anthropic: Donating the Model Context Protocol and establishing the Agentic AI Foundation (2026年11月3日 查阅)https://www.anthropic.com/news/donating-the-model-context-protocol-and-establishing-of-the-agentic-ai-foundation
  8. GitHub: modelcontextprotocol/servers (2026年11月2日 查阅)https://github.com/modelcontextprotocol/servers
  9. Claude on X: Claude Code and Figma through MCP, 23 September 2025 (2026年11月3日 查阅)https://x.com/claudeai/status/1970541285615264071
  10. n8n Docs: MCP servers (2026年11月2日 查阅)https://docs.n8n.io/build/integrate-ai/mcp-servers
  11. n8n Docs: MCP Server Trigger node (2026年11月2日 查阅)https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-langchain.mcptrigger
  12. MCP docs: MCP Inspector (2026年11月4日 查阅)https://modelcontextprotocol.io/docs/tools/inspector
  13. MCP docs: Inspector web client (2026年11月4日 查阅)https://modelcontextprotocol.io/docs/2026-07-28/tools/inspector/web
  14. MCP Inspector: README (2026年11月4日 查阅)https://github.com/modelcontextprotocol/inspector
  15. MCP docs: Connect to local MCP servers (2026年11月4日 查阅)https://modelcontextprotocol.io/docs/2026-07-28/develop/connect-local-servers
  16. MCP docs: Debugging (2026年11月4日 查阅)https://modelcontextprotocol.io/docs/2026-07-28/tools/debugging
  17. Cursor docs: Model Context Protocol (2026年11月4日 查阅)https://cursor.com/docs/mcp
  18. VS Code docs: MCP configuration reference (2026年11月4日 查阅)https://code.visualstudio.com/docs/agents/reference/mcp-configuration

分享本节课

做出你的第一个 MCP 服务器

第一课用官方 SDK 在 Python 里做一个小小的天气服务器。

开始这一课

本节课的 Markdown 版本 · 全部工具 · 全部课程