通过 MCP 协议在 AI 客户端中直接调用中文文本相似度检测接口
MCPAI客户端CherryStudioChatBox # 通过 MCP 协议在 AI 客户端中直接调用中文文本相似度检测接口
> 元信息:接口/接入点 中文文本相似度检测接口(MCP 服务,覆盖 294/1、294/2)· 免费 · 返回格式 JSON · 适用人群 AI 客户端 / Agent 开发者 · 阅读时间 约 6 分钟
## 核心要点
- 本接口提供官方 **MCP 服务**,配置名 `showapi-mcp-294`,覆盖全部接入点,无需自己写 HTTP 封装。
- 在支持 MCP 的客户端(如 Cherry Studio、ChatBox)里粘贴一段 JSON 即可让 AI 直接调用相似度检测。
- 把 `{your_appKey}` 换成真实 AppKey(控制台获取),注意保护密钥不外泄。
## Why:让 AI Agent 直接"比一比两段话"
当你的 AI 助手需要判断"用户这两条留言是不是重复""这两段文案像不像",与其让它凭感觉答,不如让它真去调接口拿 `like` 值。MCP 把接口变成 Agent 可调用的"工具",几行配置就能打通,不用写一行后端代码。
## What:MCP 集成速览
| 项 | 说明 |
|----|------|
| 服务名 | `showapi-mcp-294` |
| 服务地址 | `http://www.showapi.com.cn/mcp/294/{your_appKey}` |
| 覆盖范围 | 接口全部接入点(294/1、294/2) |
| 适用客户端 | Cherry Studio、ChatBox 等支持 MCP 的客户端 |
| 鉴权 | URL 内的 AppKey |
## How:三步接入 MCP
### 步骤 1:获取 AppKey
登录 ShowAPI 控制台 → 我的应用 → 拿到 `appKey`(https://www.showapi.com/console#/myApp)。
### 步骤 2:在客户端配置 MCP
将下面 JSON 中的 `{your_appKey}` 替换为真实值,填入客户端的 MCP 配置:
```json
{
"mcpServers": {
"showapi-mcp-294": {
"url": "http://www.showapi.com.cn/mcp/294/{your_appKey}"
}
}
}
```
### 步骤 3:在对话中直接使用
配置生效后,AI 客户端即可把"文本相似度检测"作为可用工具。你可以直接说"比较一下'A'和'B'像不像",Agent 会调用接口返回 `like` / `likeValue` 与 `mostLike`。
## 返回示例与解析
接口返回经 `showapi_res_body` 封装:接入点 1 给 `like`,接入点 2 给 `likeValue` + `mostLike`(最匹配候选下标)。字段含义详见[《返回字段全解》](https://www.showapi.com/guides/text-similarity-response-fields-294)。
## 进阶 / 边界
- **保护 AppKey**:MCP 地址内含 AppKey,不要提交到公开仓库或贴到公开场合。
- **仅中文**:Agent 传入英文/数字时结果无意义,可在 Prompt 中约束"仅对中文文本调用"。
- **限流**:免费档位有每日调用与 QPS 限制,Agent 高频调用需配合限流策略(见[缓存篇](https://www.showapi.com/guides/text-similarity-cache-cost-294))。
## FAQ
**Q1:哪些客户端支持这个 MCP?**
文档示例提到 Cherry Studio、ChatBox 等支持 MCP 协议的客户端,按各客户端说明粘贴配置即可。
**Q2:MCP 配置里的 AppKey 会泄露吗?**
MCP 地址内嵌 AppKey,属于敏感凭证,不要写入公开代码库或公开分享。
**Q3:MCP 覆盖了哪些接入点?**
覆盖本接口全部接入点(294/1 文本相似度检测、294/2 批量检测)。
**Q4:AI 传了英文也能比吗?**
不能,本接口仅支持中文,英文/数字结果无意义,建议在调用前做语言约束。
## 下一步阅读
- [导入 Postman / Swagger:用 OpenAPI 文档管理中文文本相似度检测接口](https://www.showapi.com/guides/text-similarity-openapi-294)
- [中文文本相似度检测接口返回字段全解:like / likeValue / mostLike / ret_code 一文读懂](https://www.showapi.com/guides/text-similarity-response-fields-294)
- [中文文本相似度检测接口:5 分钟从注册到第一条相似度结果](https://www.showapi.com/guides/text-similarity-quickstart-294)
- **本系列共 12 篇**:查看[中文文本相似度检测接口指南总目录](https://www.showapi.com/guides/text-similarity-guides-294)