MCP接入方式介绍

上一篇文章,我们介绍了MCP是什么以及MCP的使用。
MCP是什么,MCP的使用

接下来,我们来详细介绍一下MCP的接入

先看官网的架构图
image-20250420213558221

上图的MCP 服务 A、MCP 服务 B、MCP 服务 C是可以运行在你的本地计算机(本地服务器方式),也可以运行在远程服务器上( 远程服务器方式)。


两种方式对比

本地服务器方式(stdio)远程服务器方式(sse)
运行方式本地运行服务器进程直接使用服务提供方已部署好的服务
技术复杂度较高(需维护本地环境,安装相关命令和依赖包)较低(仅需配置URL和参数)
性能考虑本地服务器可能有更低的延迟远程服务器可能有更好的稳定性
资源消耗本地服务器需要使用本地计算资源远程服务器不占用本地计算资源
维护方式本地服务器需要自行维护、更新远程服务器由服务提供方维护和更新

下面我们以高德地图的MCP服务为例,来介绍一下这两种方式的接入。

1. 远程服务器方式(sse)

远程服务器方式(sse)

  • 直接指定一个远程URL地址,参数通过URL传递
  • 使用SSE (Server-Sent Events) 与远程服务器通信
  • MCP客户端调用远程服务器提供的MCP服务

配置示例:只需一个url即可

{
  "mcpServers": {
    "amap-amap-sse": {
      "url": "https://mcp.amap.com/sse?key=您在高德官网上申请的key"
    }
  }
}

远程服务器方式(sse)连不上时,先确保第三方的sse服务有正常提供,再检查服务地址、参数密钥这些是否正确。


2. 本地服务器方式(stdio)

本地服务器方式(stdio)

  • 通过commandargs运行一个本地进程。args指定运行所需要的参数
  • env中配置运行时的环境变量
  • MCP客户端调用本地运行的MCP服务

注意:所执行的命令需要在你的系统已经安装,否则会运行失败
比如
npx命令则需要先安装Node.js
uvx命令则需要先安装uv包管理器
java命令则需要先安装JDK
docker命令则需要安装Docker容器
等等

Unix/Linux配置示例:

{
    "mcpServers": {
        "amap-maps": {
            "command": "npx",
            "args": [
                "-y",
                "@amap/amap-maps-mcp-server"
            ],
            "env": {
                "AMAP_MAPS_API_KEY": "您在高德官网上申请的key"
            }
        }
    }
}

Windows配置示例:
Windows需要额外加上cmd /c。因为Windows和Unix/Linux系统执行命令的方式不同,加 cmd /c 确保命令能够被正确解释和执行。

{
	"mcpServers": {
		"amap-maps": {
			"command": "cmd",
			"args": [
				"/c",
				"npx",
				"-y",
				"@amap/amap-maps-mcp-server"
			],
			"env": {
				"AMAP_MAPS_API_KEY": "您在高德官网上申请的key"
			}
		}
	}
}

你可以在命令行窗口先执行下命令检查是否正常

set AMAP_MAPS_API_KEY=您在高德官网上申请的key && npx -y @amap/amap-maps-mcp-server

image-20250423170313251

本地MCP服务连不上时,可以先检查通过上面的方式服务是否能够正常启动。

检查所需要的依赖和要运行的命令是否已经安装,以及版本是否符合。
image-20250423200937484


用 Cherry Studio 来测试两种方式的接入

Cherry Studio 的安装请参考:Cherry Studio下载和安装教程

左下角配置 -> MCP 服务器 -> 添加服务器 -> 填写远程服务器sse地址 -> 保存
image-20250423201829980

输入"请规划一个杭州一日游",并且选择配置好的MCP服务。可以看到调用了工具
image-20250423202355178

删除配置,再试另一种方式
image-20250423203137650

左下角配置 -> MCP 服务器 -> 编辑 MCP 配置
image-20250423201114502

根据配置示例填写配置
image-20250423203312228

输入"广州一日游规划",并且选择配置好的MCP服务。可以看到调用了工具
image-20250423173251334

👉 关注公众号"北灵聊AI",一个专注于技术的博主

✅ 已更新:AI实践虚拟化平台安装
✅ 已更新:Docker Desktop 安装
✅ 已更新:Ollama安装教程
✅ 已更新:DeepSeek私有化部署
✅ 已更新:Dify私有化部署
✅ 已更新:Dify接入大模型
✅ 已更新:Dify + DeepSeek搭建本地私有化知识库
✅ 已更新:Dify应用类型的选择
✅ 已更新:Dify升级指南
✅ 已更新:Dify节点的详细介绍(上)
✅ 已更新:Dify节点的详细介绍(中)
✅ 已更新:Dify节点的详细介绍(下)
✅ 已更新:RagFlow本地部署和使用
✅ 已更新:基于大模型的智能问数NL2SQL
✅ 已更新:用通俗易懂的话告诉你MCP是什么,MCP的使用
✅ 已更新:MCP接入方式介绍
✅ 已更新:3分钟教你开发一个自己的MCP服务

### 通过 STDIO 方式接入扣子的 MCP 服务 要通过 STDIO 方式接入某个系统的 MCP 服务,例如扣子平台的 MCP 服务,需要遵循以下核心步骤: 1. **确认 MCP 服务的接口规范** 需要确保目标 MCP 服务支持 STDIO 作为通信传输方式。STDIO 通常用于本地进程间通信,适用于 Node.js 或其他支持子进程调用的环境。如果扣子平台的 MCP 服务提供此类接口,则可以通过 `npx` 或直接调用可执行文件的方式启动 MCP 客户端[^2]。 2. **配置 MCP 客户端参数** 在客户端配置中,需指定 MCP 服务的命令行启动参数,包括命令(`command`)、参数数组(`args`)、环境变量(`env`)等。这些参数通常用于传递认证信息、目标数据库连接信息或其他运行时依赖。 示例配置如下: ```json { "mcpServers": { "扣子平台": { "command": "npx", "args": ["@modelcontextprotocol/your-mcp-server-package"], "env": { "PLATFORM_API_KEY": "your_api_key", "PLATFORM_HOST": "api.douzi.com", "PLATFORM_PROJECT_ID": "your_project_id" }, "transportType": "stdio", "autoApprove": ["list_resources", "execute_action", "query_data"] } } } ``` 3. **启动 MCP 客户端并连接服务** 使用 `npx` 或直接运行 MCP 服务的可执行文件来启动客户端。例如: ```bash npx @modelcontextprotocol/your-mcp-server-package ``` 该命令会启动 MCP 服务,并通过 STDIO 与主进程通信,进而实现与扣子平台的交互。 4. **集成至开发环境(如 Cursor、VS Code 等)** 如果使用的是支持 MCP 的 IDE(如 Cursor),可在其设置中添加 MCP 服务器配置,指定对应的命令、参数和环境变量。这使得开发工具能够自动调用 MCP 服务,获取上下文信息或执行操作[^2]。 5. **处理上下文聚合与注入** MCP Hosts 负责聚合来自多个 Server 的上下文片段,并将其注入给大语言模型。因此,在接入成功后,可通过 MCP Hosts 管理多个 MCP Client 实例,协调它们与大语言模型之间的上下文交互[^1]。 ### 注意事项 - 确保 MCP 服务支持 STDIO 传输类型,否则需使用其他协议如 SSE 或 gRPC。 - 配置文件中的敏感信息(如 API Key)应妥善管理,避免泄露。 - 若扣子平台未提供官方 MCP 插件或支持包,可能需要自行开发 MCP 服务端逻辑,以适配其 API 接口。
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值