通过 MCP 在 AI 客户端直接调用汉字多功能转换器
汉字多功能转换器汉字转拼音简繁转换全角半角地址分词 # 通过 MCP 在 AI 客户端直接调用汉字多功能转换器
> 接口/接入点：汉字多功能转换器（apiCode=99）· 集成方式：MCP 服务（接口级，覆盖全部 6 接入点）· 适用：Cherry Studio / ChatBox 等支持 MCP 的 AI 客户端 · 阅读时间：约 6 分钟
## 核心要点
- 官方提供接口级 MCP 服务，配置一条 URL 即可让 AI 客户端直接调用本接口全部 6 个接入点。
- MCP 地址：`http://www.showapi.com.cn/mcp/99/{your_appKey}`（注意域名是 `showapi.com.cn`，把 `{your_appKey}` 换成真实 AppKey）。
- 适合让 AI Agent 在对话里"顺手"做拼音标注、简繁转换、地址分词等。
## Why：为什么用 MCP 而不是自己写代码
如果你在用 Cherry Studio、ChatBox 这类支持 MCP 的客户端，与其每次都写 HTTP 调用，不如把汉字多功能转换器注册成一个 MCP 工具，让大模型自己决定何时调用。零代码、可复用、覆盖全部接入点。
## What：MCP 配置速览
| 项 | 说明 |
|----|------|
| 服务名 | `showapi-mcp-99` |
| 服务地址 | `http://www.showapi.com.cn/mcp/99/{your_appKey}` |
| 覆盖范围 | 本接口全部 6 个接入点 |
| 客户端 | Cherry Studio、ChatBox 等支持 MCP 的客户端 |
## How：在 AI 客户端配置 MCP
在客户端的 MCP 配置中加入以下 JSON（把 `{your_appKey}` 替换为你的真实 AppKey）：
```json
{
"mcpServers": {
"showapi-mcp-99": {
"url": "http://www.showapi.com.cn/mcp/99/{your_appKey}"
}
}
}
```
配置完成后，在与模型的对话里即可直接说"把'你好'转成拼音""把这段地址分词""把这句简体转繁体"，客户端会通过 MCP 调用对应接入点并返回结果。
## 返回示例与解析
MCP 返回的结构与直接 HTTP 调用一致，例如汉字转拼音：
```json
{ "showapi_res_code": 0, "showapi_res_body": { "data": "ni hao", "simpleData": "n h", "flag": "true" } }
```
地址分词则通过业务级 `ret_code`/`result` 返回（详见地址分词实战文章）。
## 进阶/边界
- MCP 地址域名为 `showapi.com.cn`（不是 `www.showapi.com`），配置时别写错。
- `{your_appKey}` 是占位符，请填入控制台「我的 App」里的真实 AppKey，不要留存示例值。
- MCP 覆盖全部 6 接入点，但每个接入点的参数/返回差异仍然存在（尤其地址分词的 `addr` 与 `ret_code`/`result`）。
- 免费接口有档次限制，Agent 高频调用时同样受限制约。
## FAQ
**Q1：MCP 和直接调 API 有什么区别？**
MCP 让 AI 客户端/ Agent 直接以"工具"形式调用，无需你手写 HTTP；底层仍是同一接口。
**Q2：域名为什么是 showapi.com.cn？**
官方 MCP 服务部署在该域名，配置时照抄即可。
**Q3：AppKey 泄露怎么办？**
AppKey 等同于调用凭证，仅填在自己的客户端配置中；如怀疑泄露，到控制台重置。
**Q4：地址分词在 MCP 里参数也一样吗？**
是的，仍用 `addr` 且返回 `ret_code`/`result`，与其它接入点不同。
## 相关能力 / 下一步阅读
- [导入 Postman / Swagger：用 OpenAPI 文档管理汉字多功能转换器接口](https://www.showapi.com/guides/hanzi-converter-openapi-99)
- [汉字多功能转换器：5 分钟从注册到第一条转换结果（汉字转拼音）](https://www.showapi.com/guides/hanzi-converter-quickstart-99)
- [汉字多功能转换器：地址分词实战（物流/地图场景的地址智能切分）](https://www.showapi.com/guides/hanzi-address-segment-99)
- **本系列共 12 篇**：查看[汉字多功能转换器指南总目录](https://www.showapi.com/guides/hanzi-converter-guides-99)
