不知道大家有没有发现?对于添加到 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 服务提供商,帮我们做了以下这些事:
- 启动 stdio 服务端,等待 MCP 客户端连接。
- 当检测到客户端的通讯请求之后,它通过 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、设计模式、消息队列、场景题等模块。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。