写点什么

干货分享!MCP 实现原理,小白也能看懂

作者:王磊
  • 2025-04-11
    陕西
  • 本文字数:1648 字

    阅读完需:约 5 分钟

干货分享!MCP 实现原理,小白也能看懂

不知道大家有没有发现?对于添加到 MCP 服务市场的成千上万个 MCP 服务(而且这个数字每天还在增加),我们可以不写一行代码,轻松实现调用,但背后的原因究竟是啥呢?



MCP 虽然用起来很方便,但搞不懂背后的实现原理,总感觉这个知识点还没完全掌握,所以接下来,我们一起来看它的实现原理。

从某个 MCP 的调用说起

在调用某个 MCP 服务的时候,只需要在 json 配置文件中添加一段 MCP 服务厂商提供的 json 信息就可以实现服务调用了。


例如要调用百度地图提供的 8 大核心功能:地理编码、逆地理编码、地点检索、路线规划、天气查询、IP 定位等功能时,我们只需要添加以下 json 就能轻松调用了:


{  "mcpServers": {    "baidu-map": {      "command": "npx",      "args": [        "-y",        "@baidumap/mcp-server-baidu-map"      ],      "env": {        "BAIDU_MAP_API_KEY": "xxx"      }    }  }}
复制代码


执行结果如下:



要搞明白调用的实现原理,我们需要先从 json 配置文件说起,以上配置文件是 nodejs 的调用命令,其中“npx”是 “npm execute package” 的缩写,它的主要功能是运行一个包中的可执行文件,而无需先将其全局安装或添加到项目的依赖中,此时我们使用传统的 npm 使用方式,将百度提供的依赖下载到本地:


源码分析

我们查看其源码就可以发现:



其主要文件 dist/index.js 的核心源码如下:


// 启动一个 stdio 服务器async function runServer() {  const transport = new StdioServerTransport();  await server.connect(transport);  console.error("Baidu Map MCP Server running on stdio");}// 查询天气的工具实现async function handleWeather(districtId, location) {  const url = new URL("https://api.map.baidu.com/weather/v1/");  url.searchParams.append("data_type", "all");  url.searchParams.append("coordtype", "bd09ll");  url.searchParams.append("ak", BAIDU_MAP_API_KEY);  url.searchParams.append("from", "node_mcp");  if (location) {    url.searchParams.append("location", location);  }  if (districtId) {    url.searchParams.append("district_id", districtId);  }  const response = await fetch(url.toString());  const data = await response.json();  if (data.status !== 0) {    return {      content: [{        type: "text",        text: `Weather searth failed: ${data.message || data.status}`      }],      isError: true    };  }  return {    content: [{      type: "text",      text: JSON.stringify({        location: data.result.location,        now: data.result.now,        forecasts: data.result.forecasts,        forecast_hours: data.result.forecast_hours,        indexes: data.result.indexes,        alerts: data.result.alerts,      }, null, 2)    }],    isError: false  };}
复制代码


从以上源码我们可以大致看出,百度作为 MCP 服务提供商,帮我们做了以下这些事:


  1. 启动 stdio 服务端,等待 MCP 客户端连接。

  2. 当检测到客户端的通讯请求之后,它通过 HTTP 协议请求自己服务器的信息,再将返回结果以 stdio 方式发送给 MCP 客户端。


到这里,我们就搞明白了,之所以 MCP 使用比较简单,原因是每家 MCP 服务厂商,帮我们实现了服务的具体调用


并且他们遵循了 MCP 通讯协议,因此我们只需要使用 MCP Client 简单调用就可以实现某个功能了,它的具体执行流程如下:


小结

MCP 只使用调用简单是每家 MCP 厂商帮我们实现了服务调用的细节,并且遵循了 MCP 协议,开启了 stdio 本地线程通讯的服务,让我们可以轻松的通过 MCP 客户端进行调用了。所以,你能自己实现一个 MCP 带 UI 的客户端吗?


本文已收录到我的技术小站 www.javacn.site,其中包含的内容有:Spring AI、并发编程、MySQL、Redis、Spring、Spring MVC、Spring Boot、Spring Cloud、MyBatis、JVM、设计模式、消息队列、场景题等模块。

用户头像

王磊

关注

javacn.site 2018-08-25 加入

我的小站:javacn.site

评论

发布
暂无评论
干货分享!MCP 实现原理,小白也能看懂_王磊_InfoQ写作社区