iApp AI 2.0 发布——全新 Python 包与 MCP 服务器，把 30 多个泰语 AI API 接入 Claude Code

一条命令接入 Claude Code

claude mcp add iapp-mcp -s user -e IAPP_API_KEY=YOUR_API_KEY -- uvx iapp-mcp

需要 uv（brew install uv）以及一个 API 密钥，可在 iapp.co.th → API Keys → Create New API Key 获取。之后直接用自然语言提问即可，无需特殊语法。→ MCP 服务器完整指南（全部 37 个工具、其他客户端与疑难排查）

我们的 Python SDK 迎来了一次重要升级。iApp AI 2.0 把 github.com/iapp-technology/iapp_ai 重构为包含三个包的 monorepo，而其中最重要的新成员，是一个把整个 iApp AI Marketplace 化作 37 个工具、直接交到 AI 助手手中的 MCP 服务器。

一句话概括：一条命令之后，Claude Code 就能读取泰国身份证、转写会议录音、翻译成日语、生成视频，或者规划配送路线——因为它现在可以直接与我们的 API 对话。

三个包，一个核心

包	安装	是什么
iapp-ai	pip install iapp-ai	同步的 Python SDK——from iapp_ai import api，轻量封装，直接返回原始 requests.Response。
iapp-mcp	uvx iapp-mcp	全新 —— MCP 服务器，把整个市场以工具形式提供给 Claude 及任何 MCP 客户端。同时发布在 npm。
iapp-core	（依赖项）	共享核心：基础 URL、API 密钥认证、错误处理、响应格式化，以及同步 + 异步 HTTP 传输层。

不会破坏现有代码

现有 SDK 用户完全不受影响。pip install iapp_ai 与 from iapp_ai import api 的行为与此前完全一致——MCP 服务器以独立包发布。

如果你是在自己的 Python 代码里调用我们的 API，那么 SDK 依然是你要的东西：

from iapp_ai import api

client = api("YOUR_API_KEY")
resp = client.idcard_front("id.jpg")   # 返回 requests.Response
print(resp.json())

如果你希望由 AI 助手 替你调用，请继续往下读。

什么是 MCP

Model Context Protocol（模型上下文协议）是一个把 AI 助手连接到外部工具的开放标准。你运行一个小型服务器，助手会自动发现它提供的工具，并在任务需要时调用。iapp-mcp 就是 iApp AI Marketplace 的这样一个服务器：它通过 stdio 在你本地运行，因此 API 密钥不会离开你的机器，文件也直接从你的磁盘读取。

开箱即用的 37 个工具

类别	你的助手能做什么
🪪 eKYC	泰国身份证 OCR（正面/背面/复印件）、护照、驾照、存折、人脸比对、人脸检测、活体检测、人脸与证件 KYC、1:N 人脸识别
🔍 文档 OCR	泰语文档 OCR（纯文本 / 版面结构 / 转 DOCX）、收据、信用卡账单、50 ทวิ 扣税凭证、户籍证明、简历提取 + AI 评估、职位描述提取
🤖 大模型	Chinda 泰语 LLM 4B（免费）、DeepSeek-V3.2、DeepSeek V4 Flash/Pro、Thanoy 泰国法律 AI
🌐 泰语 NLP	翻译（28 种语言）、摘要、情感分析、毒性检测、泰语问答、问题生成
🎙️ 语音	带说话人分离的语音转文字（泰/英/中）、泰语 TTS（4 种音色）、声音克隆、AI 音频检测
🖼️ 图像与视频	图像生成（Nano Banana / Pro）、背景移除、Seedance 2.0 视频生成（异步提交 + 状态查询）
♻️ 智慧城市与数据	泰国车牌识别、水电表读数识别、路线优化、泰国节假日数据

接入 Claude Code

1. 获取 API 密钥。 登录 iapp.co.th → API Keys → Create New API Key，复制保存——密钥只显示一次。

2. 安装 uv（一次性），它可以免安装直接运行服务器：

curl -LsSf https://astral.sh/uv/install.sh | sh    # 或：brew install uv

3. 添加服务器。 按你的安装方式选择对应命令，用 -e 传入 API 密钥，并在启动命令前加上 --：

# uv / uvx（推荐，无需额外安装）
claude mcp add iapp-mcp -s user -e IAPP_API_KEY=YOUR_API_KEY -- uvx iapp-mcp

# npm / npx
claude mcp add iapp-mcp -s user -e IAPP_API_KEY=YOUR_API_KEY -- npx -y iapp-mcp

# 已永久安装的情况（pip / uv tool / npm / yarn / pnpm）
claude mcp add iapp-mcp -s user -e IAPP_API_KEY=YOUR_API_KEY -- iapp-mcp

-s user 表示在所有项目中注册。若想写入本仓库的 .mcp.json 并与队友共享，请用 -s project；若只想用于本机当前项目，则用 -s local。

4. 验证。 运行 claude mcp list，或在 Claude Code 会话中输入 /mcp，应能看到 iapp-mcp 已连接并列出全部工具。日后可用 claude mcp remove iapp-mcp 移除。

配置到此结束。无需学习任何特殊语法：在对话中描述你的需求即可，Claude Code 会自动调用合适的 iapp-mcp 工具。

其他 MCP 客户端（Claude Desktop、Cursor 等）

任何 MCP 客户端都可使用，因为该服务器通过 stdio 通信。把下面的配置写入你的客户端配置文件：

{
  "mcpServers": {
    "iapp-mcp": {
      "command": "uvx",
      "args": ["iapp-mcp"],
      "env": {
        "IAPP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

使用示例

连接完成后——无论是 Claude Code、Claude Desktop 还是其他任何 MCP 客户端——用泰语或英语直接提问即可，无需特殊命令语法，助手会自行挑选工具。

eKYC 与文档

อ่านข้อมูลจากบัตรประชาชนในไฟล์ idcard.jpg
（读取 idcard.jpg 中泰国身份证的信息）

เช็คว่ารูป selfie.jpg กับ idcard.jpg เป็นคนเดียวกันไหม
（判断 selfie.jpg 与 idcard.jpg 是否为同一人）

Extract the MRZ data from passport.jpg
OCR ใบเสร็จ receipt.jpg แล้วรวมยอดให้หน่อย
（识别收据 receipt.jpg 并合计金额）

语音与语言

ถอดเสียงไฟล์ประชุม meeting.wav พร้อมระบุว่าใครพูด
（转写会议录音 meeting.wav 并标注说话人）

อ่านข้อความนี้เป็นเสียงพูดด้วยเสียงไข่ต้ม เซฟเป็น speech.wav
（用 Kaitom 音色朗读这段文字并保存为 speech.wav）

把这段文字翻译成日语
分析这些客户评论是正面还是负面

大模型与法律

问 Chinda 泰语 LLM：青木瓜沙拉有多少卡路里
用 DeepSeek V4 Flash 给这些客户留言分类
ถามทนอย: สัญญาเช่าบ้านไม่มีลายเซ็นพยานมีผลไหม
（问 Thanoy：租房合同没有见证人签字是否有效）

创意与智慧城市

生成一张猫咪穿泰服坐在湄南河边的图片，保存为 cat.png
Generate a 5-second video of a cat surfing at sunset
把这 20 个配送点分给 3 位司机规划路线，从仓库出发
读取监控图片 cctv.jpg 中的车牌号

真正的价值在于组合。只要说一句 "读取 ./expenses 里的所有收据，按类别汇总金额，并用泰语写一份摘要"，助手就会对整个文件夹逐一 OCR、完成计算并起草摘要——你不需要写任何胶水代码。

注意事项

• 本地文件路径。 涉及文件的工具使用你机器上的路径；生成的音频、图像与视频会写入你指定的 output_path。
• 积分。 多数工具按次消耗 iApp 积分（IC），每个工具的说明中都标注了费用；Chinda 泰语 LLM 4B 免费。
• Seedance 视频生成 需要付费账户——购买任意 IC 套餐即可解锁。
• 上下文保持精简。 API 响应中的大段 base64 数据（例如裁剪出的人脸图）会在工具输出中被截断。
• 需要 Python 3.10+ 或 Node 18+。

相关链接

• GitHub： github.com/iapp-technology/iapp_ai
• PyPI： iapp-ai · iapp-mcp · iapp-core
• npm： iapp-mcp
• API 文档： iapp.co.th/docs/intro
• 技术支持： support@iapp.co.th · Discord