跳到主要内容

🔌 iApp AI MCP 服务器

把 Claude Code、Claude Desktop、Cursor——或任意 MCP 客户端——接入整个 iApp AI Marketplace。一条命令，即可让你的 AI 助手获得覆盖 OCR、eKYC、泰语 NLP、大模型、语音与图像/视频生成的 37 个工具。

一条命令接入 Claude Code
claude mcp add iapp-mcp -s user -e IAPP_API_KEY=YOUR_API_KEY -- uvx iapp-mcp

之后直接用自然语言提问即可，无需学习任何特殊语法。

为什么要用它​

没有 MCP 时，调用 iApp API 意味着你要自己写脚本：读文件、构造请求、处理响应。有了 MCP，你只需描述想要的结果，助手会自动处理这些细节——包括把多个 API 串联起来。

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

服务器在本地通过 stdio 运行，因此 API 密钥不会离开你的机器，文件也直接从你的磁盘读取。

前置条件​

1. iApp API 密钥​

  1. 在 iapp.co.th 登录 / 注册
  2. 进入控制台的 API Keys
  3. 点击 Create New API Key，命名并创建
  4. 复制密钥——只会显示一次

2. 运行环境​

服务器同时发布在 PyPI 与 npm 上，任选其一即可。

Python 3.10+

包管理器免安装运行永久安装
uvuvx iapp-mcpuv tool install iapp-mcp
pip—pip install iapp-mcp

Node.js 18+

包管理器免安装运行永久安装
npmnpx -y iapp-mcpnpm install -g iapp-mcp
yarnyarn dlx iapp-mcpyarn global add iapp-mcp
pnpmpnpm dlx iapp-mcppnpm add -g iapp-mcp
备注

npm 包只是 Python 服务器的轻量启动器，因此无论哪种方式都需要先安装 uv：

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

配置 — Claude Code​

使用 claude mcp add 命令。按你的安装方式选择对应命令，用 -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本机所有项目（推荐）
-s project仅当前仓库，写入共享的 .mcp.json，队友克隆后即可获得
-s local仅本机当前项目（省略时的默认值）

验证与管理​

claude mcp list              # 应显示 iapp-mcp 已连接
claude mcp remove iapp-mcp   # 日后可移除

也可以在 Claude Code 会话中输入 /mcp，查看服务器及其全部工具。

配置 — 其他 MCP 客户端​

Claude Desktop、Cursor 等使用 JSON 配置文件。服务器通过 stdio 通信，任何客户端都能启动它：

uv / uvx（推荐）：

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

npm：

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

已永久安装：

{
  "mcpServers": {
    "iapp-mcp": {
      "command": "iapp-mcp",
      "env": { "IAPP_API_KEY": "YOUR_API_KEY" }
    }
  }
}

也可以直接运行服务器，确认它能正常启动：

IAPP_API_KEY=YOUR_API_KEY iapp-mcp

工具清单​

全部 37 个工具。涉及文件的参数均为本机文件路径；生成的文件会写入你指定的 output_path。

🪪 eKYC​

工具功能主要参数
iapp_thai_id_card_ocr识别泰国身份证照片中的信息file_path、side（front/back）
iapp_thai_id_card_photocopy_ocr识别身份证复印件并检测签名file_path
iapp_passport_ocr识别护照的 MRZ 与个人信息file_path、segmentation
iapp_thai_driver_license_ocr识别泰国驾照file_path
iapp_book_bank_ocr识别存折页上的户名/账号file_path
iapp_face_verification判断两张人脸照片是否为同一人（1:1）image1_path、image2_path、threshold
iapp_face_detection检测照片中的人脸及边界框file_path、mode（single/multi）
iapp_face_liveness检测翻拍照片/屏幕欺骗file_path
iapp_face_id_card_kyc将自拍与证件上的人脸比对id_card_path、selfie_path
iapp_face_recognition在企业人脸库中登记与检索（1:N）action、company、file_path、name、password

🔍 泰语文档 OCR​

工具功能主要参数
iapp_document_ocr识别任意泰语文档file_path、mode：text / layout / docx
iapp_receipt_ocr提取泰语收据的明细与合计file_path、return_ocr
iapp_credit_card_statement_ocr提取信用卡账单中的交易记录file_path、return_ocr
iapp_tax_deduction_certificate_ocr识别扣缴凭证（50 ทวิ）file_path、return_ocr
iapp_civil_registration_ocr识别泰国户籍证明file_path、return_ocr
iapp_resume_ocr从简历中提取结构化数据并进行 AI 评估file_path
iapp_job_description_ocr从职位描述中提取结构化数据file_path

🤖 大语言模型​

工具功能主要参数
iapp_llm_chat与 iApp 托管的大模型对话（兼容 OpenAI 接口）prompt 或 messages、model：chinda-qwen3-4b（免费）/ deepseek-chat / deepseek-reasoner / deepseek-v4-flash / deepseek-v4-pro、system_prompt、max_tokens、temperature
iapp_thanoy_legal_qa咨询泰国法律问题（Thanoy 法律 AI）query

🌐 泰语 NLP​

工具功能主要参数
iapp_translate28 种语言互译（针对泰语优化）text、source_lang、target_lang
iapp_summarize泰语/英语文本摘要text、style、language
iapp_sentiment_analysis判断泰语文本为正面/中性/负面text
iapp_toxicity_classification检测泰语毒性文本text
iapp_thai_qa依据给定泰语文档回答问题question、document
iapp_question_generation从泰语文本生成问答对text

🎙️ 语音技术​

工具功能主要参数
iapp_speech_to_text语音转写并区分说话人file_path、language（th/en/zh）、quality（base/pro）
iapp_text_to_speech合成泰语语音并保存音频文件text、output_path、voice、speed
iapp_voice_clone_tts用样本克隆的音色朗读任意文本text、ref_audio_path、ref_text、output_path
iapp_ai_audio_detection检测音频是否由 AI 生成audio_path

🖼️ 图像与 🎬 视频生成​

工具功能主要参数
iapp_image_generation由文本生成图像（Google Nano Banana）prompt、output_path、model
iapp_remove_background移除图像背景file_path、output_path
iapp_video_generation_submit提交 Seedance 2.0 异步视频任务prompt、model、duration、ratio、resolution、generate_audio
iapp_video_generation_status查询视频任务并获取下载链接task_id

♻️ 智慧城市与 📊 泰国数据​

工具功能主要参数
iapp_license_plate_ocr从照片中识别泰国车牌file_path
iapp_meter_ocr从照片中识别水电表读数file_path
iapp_route_optimization为多名司机优化配送路线（≤100 个站点）origin_address + 坐标、stops、driver_count
iapp_thai_holidays查询泰国公共假期year，或 start_date+end_date，或留空

使用示例​

连接完成后——无论是 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
检测 face.jpg 是真人照片还是翻拍伪造

文档

识别收据 receipt.jpg 并合计金额
把这份扫描件转换成 Word 文档
从 resume.pdf 提取信息并评估其与岗位的匹配度
读取这份泰国扣缴凭证（50 ทวิ）

语音与语言

转写会议录音 meeting.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 中的车牌号

注意事项与限制​

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

疑难排查​

现象处理方法
claude mcp list 显示服务器启动失败确认已安装 uv 且在 PATH 中；直接运行 uvx iapp-mcp 查看具体报错
所有工具都报认证错误IAPP_API_KEY 有误或已过期。用正确的密钥重新添加，或在控制台 API Keys 中检查
换个项目就找不到服务器你使用了默认的 -s local 作用域，请改用 -s user 重新添加
积分不足（HTTP 402）在控制台充值；各工具费用见价格页面
视频生成被拒绝Seedance 需要付费账户——购买任意 IC 套餐即可解锁

更想直接写代码？​

如果你是在自己的 Python 程序中调用 iApp API，而不是通过 AI 助手，请改用 SDK：

from iapp_ai import api

client = api("YOUR_API_KEY")
resp = client.idcard_front("id.jpg")   # 返回 requests.Response
print(resp.json())
pip install iapp-ai

两个包共享同一套 iapp-core 基础，因此行为与错误处理完全一致。

相关链接​