PDF文件正文抽取：通过 MCP 在 AI 客户端直接调用
MCPAI客户端CherryStudioChatBox # PDF文件正文抽取：通过 MCP 在 AI 客户端直接调用
> 接口 PDF文件正文抽取（apiCode=10，接入点 10-1） · 免费服务 · 提供 MCP 服务 · 适用人群 AI 客户端用户、Agent 开发者 · 阅读时间 约 4 分钟
## 核心要点
- 官方提供 MCP 服务 `showapi-mcp-10`，URL 为 `http://www.showapi.com.cn/mcp/10/{your_appKey}`。
- 在支持 MCP 的客户端（如 Cherry Studio、ChatBox）里粘贴配置即可，无需手写 HTTP 调用。
- 调用时把 `{your_appKey}` 替换为你的真实 AppKey（在 [AppKey 管理页](https://www.showapi.com/console#/myApp) 获取）。
## Why：为什么用 MCP
传统调用要写代码、管参数、解析 JSON。MCP 把接口变成 AI 客户端里的一个「工具」，你直接用自然语言说「帮我把这份 PDF 的正文抽出来」，客户端就会调用接口并返回 `text`。对不想写代码、或想把抽取能力接进 Agent 工作流的人来说，这是最低门槛的方式。
## What：MCP 配置速览
| 项目 | 值 |
|------|----|
| MCP 服务名 | `showapi-mcp-10` |
| 服务地址 | `http://www.showapi.com.cn/mcp/10/{your_appKey}` |
| 覆盖范围 | 本接口全部接入点（即 10-1） |
| 适用客户端 | Cherry Studio、ChatBox 等支持 MCP 的客户端 |
## How：三步接入
**步骤 1 — 获取 AppKey**
到 [AppKey 管理页](https://www.showapi.com/console#/myApp) 复制你的 `appKey`。
**步骤 2 — 在客户端添加 MCP 配置**
把下面配置粘贴进客户端的 MCP 设置（将 `{your_appKey}` 换成真实值）：
```json
{
"mcpServers": {
"showapi-mcp-10": {
"url": "http://www.showapi.com.cn/mcp/10/{your_appKey}"
}
}
}
```
**步骤 3 — 直接用自然语言调用**
配置保存并连接成功后，在对话框里直接说，例如：
> 「上传这份 `example.pdf`，用 PDF文件正文抽取 把正文抽出来，并保存到 `example.txt`。」
客户端会调用 MCP 服务，返回 `text` 字段内容。
## 返回示例与解析
通过 MCP 拿到的业务结果与直接调接口一致：正文在 `text` 字段，状态由 `ret_code` 表示。区别只是「谁发起的请求」——MCP 下由客户端/Agent 代发，你不必自己拼 HTTP。
## 进阶 / 边界
- **AppKey 安全**：MCP 配置里写的是真实 AppKey，注意客户端本地的配置保密，不要提交到公开仓库。
- **免费档位仍生效**：经 MCP 调用同样受免费「使用档次限制」，批量场景仍需控制频率（见 [免费档位篇](https://www.showapi.com/guides/pdf-extract-free-tier-10)）。
- **仅覆盖本接口**：该 MCP 服务只覆盖 apiCode=10 的接入点，不涉及其他接口。
## FAQ
**Q：配置后连不上怎么办？**
A：先确认 AppKey 已正确替换、网络可访问 `showapi.com.cn`；若客户端报连接错误，检查 MCP 设置格式是否为合法 JSON、URL 是否完整。
**Q：MCP 和直接调 API 结果一样吗？**
A：业务结果一致（都是 `text` 字段），只是调用方式不同：MCP 适合自然语言/Agent 场景，直接调 API 适合写代码集成。
**Q：支持哪些客户端？**
A：文档列举 Cherry Studio、ChatBox 等支持 MCP 的客户端；只要客户端支持标准 MCP 接入，理论上均可配置。
**Q：一次能传多个 PDF 吗？**
A：本接口的 MCP 能力覆盖单一接入点（每次一个 `pdf`），批量仍需在客户端侧循环或自行编排。
## 相关能力 / 下一步阅读
- [PDF文件正文抽取：5 分钟从注册到跑通第一条抽取结果](https://www.showapi.com/guides/pdf-extract-quickstart-10)
- [PDF文件正文抽取：导入 Postman / Swagger 用 OpenAPI 文档管理接口](https://www.showapi.com/guides/pdf-extract-openapi-10)
- **本系列共 10 篇**：查看[PDF文件正文抽取指南总目录](https://www.showapi.com/guides/pdf-extract-guides-10)
