mcp是什么协议

入门与上手

面向 Agent 开发者讲清 MCP 协议是什么、解决哪些接入场景,并给出判断它适不适合自己项目的检查步骤。

你可能已经能跑通模型调用,但一让 Agent 去读文件、查数据库、连内部系统,就得为每个工具写一套适配代码,换一个模型或客户端又得重写一遍。MCP 就是为这类重复接线问题提出的开放协议。这篇不背定义,而是说清它管的是哪一段、常见接入场景有哪几种、什么时候不值得上,最后给一份从零验证的排查顺序。

你可能已经能跑通模型调用,但一让 Agent 去读文件、查数据库、连内部系统,就得为每个工具写一套适配代码,换一个模型或客户端又得重写一遍。这类重复接线问题,正是 MCP 要处理的部分。它不是模型本身,也不是某个具体框架,而是一份把「客户端」和「外部能力」连起来的开放接口约定。

这篇不背定义,而是说清它管的是哪一段、常见接入场景有哪几种、什么时候不值得上,最后给一份从零验证的排查顺序。看完你至少能判断:自己的项目该自研函数调用,还是值得套一层协议。

MCP 到底管的哪一段

先把三层分清。模型负责推理,客户端(编辑器、聊天应用、Agent 框架)负责发起请求,MCP 负责客户端与外部能力之间的那根线。换句话说,它规定的不是模型怎么想,而是「一个工具以什么形式被客户端发现、列出、调用」。这条线一旦标准化,同一份服务端就能被不同客户端复用,而不是每换一个宿主就重写一遍胶水代码。

  • 核心价值是把一次性写死的工具调用,换成可复用的标准接口,服务端与客户端解耦
  • 它不定义模型怎么推理,也不替你解决鉴权、权限和审计,这些仍要自己设计
  • 它更像插座标准而不是电器本身,符合标准的插头能插进符合标准的插座,但电器好不好用另说
  • 想先对齐名词,可以到 /ai-dict/category/tech 对照一轮再往下看

常见的接入场景长什么样

实际落地大致分三类,判断标准是「能力放在哪、谁来维护」。本地能力适合随项目走,远程能力适合团队共享,现成目录适合先跑通再考虑自研。三者不是互斥的,很多项目会混着用。

场景类型典型能力适合谁主要顾虑
本地文件与代码库读写项目文件、检索目录个人开发者、小团队误写风险,需要只读起步
外部数据源数据库、工单、内部知识库有内部系统的团队常驻服务维护、鉴权设计
现成工具目录官方与社区已有服务端想快速验证的人能否在你用的客户端跑通

开发者最常碰到的第一类是本地文件与代码库,因为它不需要额外部署。第二类通常要放在中转服务上,跑在本机既不方便也不安全。第三类可以先上 /mcp 翻一遍目录,挑之前先确认它在你实际用的客户端里能不能跑通,能省掉不少自研。

  • 只调一次固定接口、工具数量很少时,直接写函数调用更省事
  • 团队没人维护长跑服务时,上远程 MCP 反而增加故障面
  • 对权限极其敏感的行业场景,先把合规聊清楚再谈接入
  • 只是想让 Agent 会做数学或格式化文本,本地函数就够,不必上协议

接之前要算清的账和踩过的坑

成本不只看模型 token。服务端常驻会占资源,每次会话注入的工具描述也会推高上下文占用,工具越多越明显。具体单价和用量口径,建议到 /tools/model-cost-calculator 核对当时的数字,别凭印象估。

  1. 算上下文账数一下你要暴露给 Agent 的工具数量,每个工具的名称、描述、参数都会进上下文。工具超过一定数量后,考虑分组或按需加载。
  2. 定权限范围先只读后写,按目录或按表收窄。给 Agent 一个能写文件的通道,等于给它一台能改代码的机器,出错时很难回滚。
  3. 确认客户端兼容同一个服务端在不同客户端支持程度参差,先确认它在你实际用的编辑器或框架里能启动、能列出工具。
  4. 留性能基线接口延迟波动直接影响体感,接入前后各测一次,用 /tools/speed-test 留个基线,后面排查有对照。

权限是最大风险点,也是最多人低估的地方。建议把「读」和「写」拆成两个服务端实例,写的那份单独加限制。版本与兼容问题则多半卡在启动命令、路径和环境变量三类填错,报错时先查这三项。

从零验证一份 MCP 接入的四步

下面这套顺序的目标不是「接上就完事」,而是先用最小成本验证值不值得推广。每一步都有验证动作,跑不通就停在那一步,不要跳。

  1. 定场景写清 Agent 需要读什么、写什么、出错时谁来兜底,只圈一个最小能力。验证方式:这个能力能用一句话说清,且不依赖其他工具。
  2. 本地跑通先在本机用只读方式连上,确认能取到真实数据。验证方式:手动触发一次调用,返回结果和你直接查一致。
  3. 接进客户端把服务端注册进你实际用的编辑器或 Agent 框架,路径、启动命令、环境变量三类最容易填错。验证方式:客户端里能看到工具列表,并能成功调用一次。
  4. 做对照同一任务分别用直写函数和 MCP 各跑一次,比较维护成本与失败率。验证方式:记录各自改动代码的行数与出错次数,再决定是否推广到其他工具。
协议解决的是重复接线,不是让不存在的需求变得值得做。
下一步如果你正打算给 Agent 接外部能力,可以先去 /sites 看看别人实际在用什么接入方式,再到 /price-watch 核对当时的成本口径,避免只拍脑袋估。

常见问题

MCP 和普通的函数调用(function calling)有什么区别?

函数调用是模型输出一段结构化参数、由你的代码去执行动作,属于单次请求内的约定;MCP 管的是客户端与外部能力之间的连接方式,把工具做成可复用的独立服务端。简单说:函数调用解决「这一次怎么调」,MCP 解决「这批工具怎么被多个客户端反复用」。工具很少时前者够用。

只用一家模型,还有必要上 MCP 吗?

看你有没有复用需求。如果你的工具只服务一个项目、只被一个客户端调用,直写接口更轻;但如果同一批工具要给编辑器、命令行、内部 Agent 多处共用,或者你预期会换模型,MCP 省下的重复接线就回本了。判断标准是「工具要不要被多处吃」,不是「用了几家模型」。

接上之后 Agent 读不到数据,先查什么?

按这个顺序排:一是服务端进程有没有真的起来;二是客户端里注册的启动命令、路径、环境变量有没有写对;三是权限范围是不是收得太窄,把目标目录或数据源挡在外面;四是网络类服务端有没有被代理或防火墙拦掉。四项都没问题,再去看客户端版本对这类服务端的支持情况。

本文依据各平台公开文档与官方公告整理,只做中文归纳;具体做法、参数与限制以官方文档为准。