通过 MCP 协议在 AI 客户端直接调用条码生成与识别
约 6 分钟 入门MCPAI客户端CherryStudioChatBox
# 通过 MCP 协议在 AI 客户端直接调用条码生成与识别
> 接口/接入点：条码生成与识别（apiCode 1129）· MCP 服务（覆盖全部接入点）｜ 是否免费：免费 ｜ 协议：MCP ｜ 适用人群：AI 应用开发者、低代码/智能体用户 ｜ 阅读时间：约 5 分钟
## TL;DR
- ShowAPI 提供接口级 MCP 服务 `showapi-mcp-1129`，把生成/识别能力以"工具"形式暴露给 AI 客户端。
- 在 Cherry Studio、ChatBox 等支持 MCP 的客户端里粘贴配置、替换 AppKey 即可对话式调用。
- 该 MCP 覆盖全部 4 个接入点，无需自己写 HTTP 封装。
## Why：让 AI 直接"出码 / 读码"
把条码能力接进 AI 工作流后，你可以直接说"帮我给这个 SKU 生成 CODE_128 条码""识别这张图里的条码"，AI 客户端通过 MCP 调接口拿到结果，省去手写请求代码。适合搭智能体、做内部工具、快速验证想法。
## What：MCP 配置
官方给出的接口级 MCP 配置（把 `{your_appKey}` 替换为你的真实 AppKey）：
```json
{
"mcpServers": {
"showapi-mcp-1129": {
"url": "http://www.showapi.com.cn/mcp/1129/{your_appKey}"
}
}
}
```
> AppKey 在 [控制台](https://www.showapi.com/console#/myApp) 获取。该 MCP 覆盖本接口全部接入点（生成 + 三种识别）。
## How：在 AI 客户端中接入
1. 打开支持 MCP 的客户端（如 Cherry Studio、ChatBox）。
2. 进入 MCP / 工具服务配置，新增一个 MCP Server。
3. 粘贴上面的 JSON，将 `{your_appKey}` 换成真实 AppKey 并保存。
4. 启用该服务，对话中即可让 AI 调用条码生成与识别工具。
示例对话：
- "生成内容 6901294172197 的 CODE_128 条码，返回图片链接。"
- "识别这张图片链接 https://your-cdn.com/box.png 里的条码。"
## 返回示例与解析
通过 MCP 调用后，客户端拿到的业务结果与普通 HTTP 调用一致，封装在 `showapi_res_body` 内：生成得到 `imgUrl`，识别得到 `retText`，并以 `ret_code == "0"` 判定成功。字段含义见 [返回字段全解](https://www.showapi.com/guides/barcode-response-fields-1129)。
## 进阶 / 边界
- **落盘提醒**：即便通过 MCP 生成，返回的 `imgUrl` 仍每 12 小时删除；需要长期保存请在客户端下游下载落盘，见 [12 小时过期策略](https://www.showapi.com/guides/barcode-image-expiry-1129)。
- **能力边界**：MCP 覆盖本接口 4 个接入点，均为同步请求-响应，无批量/订阅。
- **鉴权**：MCP URL 内嵌 AppKey，注意客户端配置的安全存储，不要外泄。
## FAQ
**Q：哪些客户端支持这种 MCP？**
文档举例 Cherry Studio、ChatBox 等支持 MCP 的客户端；具体以你所用客户端的 MCP 接入文档为准。
**Q：MCP 和直接 HTTP 调用有什么区别？**
能力相同，MCP 让 AI 客户端以"工具"方式调用，免去手写请求；底层仍是 1129 各接入点。
**Q：AppKey 写在配置里安全吗？**
MCP URL 直接包含 AppKey，请仅在可信的本地/私有客户端配置，避免泄露；泄露后及时在控制台重置。
**Q：能只暴露部分接入点吗？**
官方提供的是覆盖全部接入点的接口级 MCP；如需仅暴露特定能力，需在客户端侧做工具选择或自行封装。
## 相关能力 / 下一步阅读
- [导入 Postman / Swagger：用 OpenAPI 文档管理条码接口](https://www.showapi.com/guides/barcode-openapi-import-1129)
- [条码生成与识别：5 分钟接入，从注册到生成第一条条码与识别第一张图](https://www.showapi.com/guides/barcode-quickstart-1129)
- [条码生成与识别：返回字段全解（imgUrl / retText / ret_code / msg）](https://www.showapi.com/guides/barcode-response-fields-1129)
- **本系列共 12 篇**：查看[条码生成与识别指南总目录](https://www.showapi.com/guides/barcode-guides-1129)
