MCP(Model Context Protocol)

**MCP(Model Context Protocol)**是一项开放标准,让 Claude、Codex、Cursor 等 AI 应用通过名为 MCP 服务器的小程序连接外部工具和数据。

MCP 是什么

没有统一的协议时,同一个工具要为每个 AI 应用分别开发。有了 MCP,工具作者只需写一个 MCP 服务器,任何支持 MCP 的客户端都能使用。

它由两部分组成:

  • **客户端:**你与之对话的 AI 应用,例如 Claude Code、Claude 应用、Codex、Cursor,或装有 GitHub Copilot 的 VS Code。它负责连接服务器,并把服务器的工具展示给模型。
  • 服务器:提供工具(模型可以调用的操作)、资源(可读取的数据)或提示词(预先写好的指令)的程序。消息采用 JSON-RPC 格式。

模型不会直接在服务器上运行代码。它请求客户端带上参数调用某个工具,服务器再返回文字、图片或结构化数据。

MCP 的使用场景

  • **编程智能体:**在写代码时读取问题跟踪系统、查询数据库或打开浏览器。
  • **桌面助手:**访问本地文件、日历或笔记。
  • **截图与画面检查:**服务器可以截取窗口、屏幕或网页并返回图片,智能体看到结果,而不必靠猜。
  • **重复性任务:**智能体可以启动耗时的截图或导出任务,查看进度,完成后再汇报。

服务器如何连接

规范定义了两种标准传输方式。

stdio 是本地方式。客户端把服务器作为子进程启动,通过标准输入和标准输出与它通信。通常只需在客户端设置中填入类似 npx -y some-server 的命令;只要服务器自己不往外发送,数据就不会离开你的电脑。桌面应用常用一个小型 stdio 桥接程序,与已经在运行的应用通信。

Streamable HTTP 是远程方式。服务器作为独立进程运行,通常由厂商托管,客户端通过 URL 连接。远程服务器一般要求用 OAuth 登录或粘贴 API 密钥。

添加服务器后,客户端会列出它的工具。很多客户端默认在每次调用工具前请求批准。有些服务器还会自己再确认一次,例如在智能体删除内容前,先在自己的窗口中询问。

常见错误

  • **加错了位置:**每个客户端读取的文件和键名都不同(mcpServers、servers 或 context_servers)。放在错误键下的条目会被直接忽略,也不会报错。
  • **没装 Node 或 PATH 太短:**用 npx 启动的服务器需要 Node。从 Dock 或开始菜单打开的应用,看到的 PATH 可能和终端不同。服务器无法启动时,请填写 npx 的完整路径。
  • **以为所有客户端都能看到图片:**协议允许工具结果包含图片,但并非所有客户端都会把图片交给模型。如果智能体说看不到截图,请查看客户端的文档。
  • **关闭全部审批:**自动批准所有工具在长任务中很省事,但删除、发送、定时这类操作,最好保留确认。
  • **把页面文字当成指令:**截取的页面或文档里的文字只是数据。谨慎的智能体和服务器都会这样对待它。

还在反复截同样的图?

Shotomatic 可以按设定的间隔自动截取窗口或区域,并导出为图片或 PDF。

常见问题

什么是 MCP 服务器?

它是通过 Model Context Protocol 向 AI 应用提供工具、数据或提示词的程序。AI 应用是客户端:它读取服务器的工具列表,在处理你的请求时决定何时调用哪个工具。

MCP 服务器是本地的还是远程的?

两种都有。本地服务器通常通过 stdio 运行,由客户端在你的电脑上把它作为子进程启动。远程服务器运行在别处,通过 Streamable HTTP 连接,通常需要登录。

使用 MCP 需要会编程吗?

不需要。大多数客户端只要一条命令,或在设置文件里加一段简短的 JSON,就能添加服务器。有些桌面应用点一下按钮就能把自己添加到智能体中。

连接 MCP 服务器安全吗?

服务器只能做它的工具允许的事,但何时调用由智能体决定。只安装你信任的服务器,在客户端中保持工具审批开启,并优先选择在删除文件等难以撤销的操作前会先询问的服务器。

参考资料

相关资料

什么是 MCP(Model Context Protocol)? | 术语表 | Shotomatic