Cherry Studio搭载自定义MCP服务,精准引导大模型

01 引言

上一节介绍了手搓MCP服务和客户端,并且采用了服务器发送事件(SSE)的形式调用,完成了基本调用。

当然客户端也可以使用Cherry Studio 客户端直接调用,输入服务端的IP和端口即可,按照下图配置,这里不在赘述!

为了更好理解本节内容,如果对上一节手搓MCP服务不清楚的,可以先了解一下,传送门:

https://blog.youkuaiyun.com/static_coder/article/details/147732655

02 打包自定义MCP服务

MCP服务既支持Stdio标准流也支持SSE,本次打包以Stdio为例,需要更改MCP服务xml依赖:

<!--  SSE
<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-mcp-server-webmvc</artifactId>
</dependency>
 -->

<!-- 标准Stdio -->
<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-mcp-server</artifactId
### 调用大模型时出现错误的解决方法 在使用 Cherry Studio 调用大模型的过程中,可能会遇到各种问题导致调用失败。以下是一些常见的错误类型及其对应的排查与解决方法: #### 1. **本地模型服务未正确启动** 如果使用 Ollama 等工具运行本地模型,需确保模型服务已正常启动并监听指定端口。可以通过命令行执行 `ollama serve` 来手动启动服务,并检查是否有异常输出。 此外,在 Cherry Studio 中配置本地模型时,应确认模型名称、端口和地址填写无误。例如,Ollama 默认监听 `http://localhost:11434`,因此在 Cherry Studio 的模型设置中应正确填写该地址[^2]。 #### 2. **网络连接问题** 若尝试通过远程方式调用本地大模型(如结合 cpolar 进行内网穿透),需要确保内网穿透服务已成功建立隧道,并且公网访问地址可正常响应请求。可以使用 `curl` 或浏览器访问隧道地址来测试连通性。 对于 Windows 和 Linux 用户来说,建议检查防火墙设置是否阻止了相关端口通信,必要时添加例外规则允许流量通过[^3]。 #### 3. **MCP 服务配置不当** 当涉及到 MCP(Model Control Protocol)功能时,比如集成高德地图等外部服务,务必按照官方文档提供的格式准确编写配置文件。以高德地图为例,其 MCP 配置示例包含激活状态、执行命令路径、参数列表以及环境变量等关键字段,任何一项缺失或错误都可能导致服务无法加载[^5]。 ```json { "mcpServers": { "amap-maps": { "isActive": true, "command": "/usr/local/bin/npx", "args": ["-y", "@amap/amap-maps-mcp-server"], "env": { "AMAP_MAPS_API_KEY": "your_api_key_here" }, "name": "amap-maps" } } } ``` 请特别注意 API 密钥的有效性和权限范围,确保其具有足够的访问权限[^5]。 #### 4. **软件版本不兼容** 不同版本之间的 Cherry Studio 可能存在功能差异或 Bug,影响到与某些模型或服务的交互效果。推荐定期更新至最新版,同时关注项目官网发布的更新日志,及时获取修复补丁或替代方案[^1]。 #### 5. **资源不足导致崩溃** 运行大型语言模型通常需要较高的硬件配置,尤其是内存和 GPU 显存。如果系统资源不足以支撑当前所选模型,则可能出现 Out Of Memory (OOM) 错误。此时可考虑降低模型规模、减少批处理大小或者升级硬件设备。 ---
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

智_永无止境

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值