通过 MCP 协议在 AI 客户端中直接调用印刷体OCR识别
# 通过 MCP 协议在 AI 客户端中直接调用印刷体OCR识别
> 接口 926(接入点 926-1) · 免费 · POST/GET · JSON · 适用人群:AI Agent / MCP 开发者 · 阅读时间:约 5 分钟
## 核心要点
- 印刷体OCR识别提供官方 MCP 服务,覆盖本接口全部接入点,无需自己写 HTTP 封装。
- MCP 地址:`http://www.showapi.com.cn/mcp/926/{your_appKey}`(注意是 `.com.cn`,与官网 `.com` 不同)。
- 在 Cherry Studio、ChatBox 等支持 MCP 的客户端配置后即可让 AI 直接「看图识字」。
## Why:让 AI 助手直接会 OCR
当你在 AI 客户端里想让模型「读这张图上的字」,与其自己写调用代码,不如把接口暴露成 MCP 工具,AI 自己就能调用。免费、零封装、随接随用,非常适合做智能体工作流的图文提取环节。
## What:MCP 服务信息
| 项目 | 说明 |
|------|------|
| 服务地址 | `http://www.showapi.com.cn/mcp/926/{your_appKey}` |
| 覆盖范围 | 接口 926 全部接入点(当前仅 926-1) |
| 鉴权 | 把 `{your_appKey}` 替换为你的真实 AppKey |
| 适用客户端 | Cherry Studio、ChatBox 等支持 MCP 的客户端 |
> 注意 host 是 `www.showapi.com.cn`(带 `.cn`),与官网 `www.showapi.com` 不同,复制时勿改。
## How:在客户端配置
复制下面的 JSON,把 `{your_appKey}` 换成你的真实 AppKey,粘贴到客户端的 MCP 配置处:
```json
{
"mcpServers": {
"showapi-mcp-926": {
"url": "http://www.showapi.com.cn/mcp/926/{your_appKey}"
}
}
}
```
以 Cherry Studio 为例:设置 → MCP 服务器 → 添加 → 选「URL 类型」→ 填入上面的 `url` → 保存。连接成功后,对话中让 AI「识别这张图片的文字」,它就会调用该 MCP 工具并返回 `str`/`list` 结果。
**命令行快速验证(可选)**
若你的环境能直接发 MCP/HTTP 请求,可先访问该 URL 确认连通性;具体调用协议以客户端实现为准。
## 返回结果说明
与直接调接口一致:成功 `ret_code=0`,取 `str`(整段)或 `list`(逐行+坐标+置信度,需 `need_all_region`)。AI 客户端通常会把工具返回的文本直接呈现给你。
## 进阶 / 边界
- **AppKey 即凭证**:MCP URL 里含 AppKey,只在你信任的本地/私有客户端配置,不要泄露给他人。
- **免费档位仍限流**:MCP 走同一接口,并发 ≤ 10、按档次限流;高频调用参考《10 并发与档位优化》。
- **不是独立批量服务**:MCP 仍是单图识别,多图需由 AI/工作流循环调用。
## FAQ
**Q1:MCP 地址连不上?**
A1:确认 host 是 `www.showapi.com.cn`(带 .cn);AppKey 是否替换且有效;客户端是否支持该 MCP 接入方式。
**Q2:能指定 need_all_region 吗?**
A2:取决于客户端对该 MCP 工具暴露的参数;若工具未暴露该参数,默认返回 `str`,需要坐标时仍可走代码调用(见坐标篇)。
**Q3:MCP 和直接调接口结果一样吗?**
A3:底层是同一接口 926-1,结果结构一致;区别只是调用通道(MCP vs HTTP)。
**Q4:AppKey 泄露了怎么办?**
A4:到 [AppKey 管理页](https://www.showapi.com/console#/myApp) 重置/停用对应密钥。
## 相关能力 / 下一步阅读
- [导入 Postman / Swagger:用 OpenAPI 文档管理印刷体OCR识别接口](https://www.showapi.com/guides/printed-ocr-openapi-926)
- [5 分钟接入印刷体OCR识别:从注册到第一条识别结果](https://www.showapi.com/guides/printed-ocr-quickstart-926)
- [印刷体OCR识别返回字段全解:ret_code 与识别结果一文读懂](https://www.showapi.com/guides/printed-ocr-response-codes-926)
- **本系列共 12 篇**:查看[印刷体OCR识别指南总目录](https://www.showapi.com/guides/printed-ocr-guides-926)