iApp AI MCP Server

把泰国 AI 带进您已在使用的工具 — 将 Claude、Claude Code、Cursor、Codex、Windsurf、Antigravity (Gemini) 或任何 MCP 客户端连接到 iApp AI Marketplace：OCR、翻译、泰国法律数据、LLM 等，直接在您的助手里使用。

连接您的客户端

新方式 — 一个 URL，登录即用，无需复制 API key

一个 URL，登录，完成。 远程服务器通过 OAuth 与您的 iApp 账户连接 — API key 由服务器端自动获取。无需复制、无需粘贴任何 key。

https://mcp.iapp.co.th

① 打开 Claude 设置

启动 Claude Desktop 或打开 claude.ai，进入 Settings → Connectors。

② 添加 custom connector

点击 Add custom connector，填写：

Name: iApp AI
URL: https://mcp.iapp.co.th

OAuth 字段留空即可。

③ 登录

点击 Connect，用您的 iApp 账户登录并批准。完成 — API key 已自动关联。

一条命令，然后在浏览器中完成认证：

claude mcp add --transport http iapp-ai https://mcp.iapp.co.th

在 Claude Code 里输入 /mcp，选择 iapp-ai → Authenticate — 浏览器会打开 iApp 登录页，key 自动关联。

想要全部 44 个工具并访问本地文件？请看下方的本地服务器。

Settings → Tools & Integrations → New MCP Server，或添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "iapp-ai": { "url": "https://mcp.iapp.co.th" }
  }
}

Cursor 会自动检测 OAuth — 出现 Needs login 时点击并用 iApp 账户登录。

codex mcp add iapp-ai --url https://mcp.iapp.co.th
codex mcp login iapp-ai

或在 ~/.codex/config.toml 中：

[mcp_servers.iapp-ai]
url = "https://mcp.iapp.co.th"

添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "iapp-ai": { "serverUrl": "https://mcp.iapp.co.th" }
  }
}

在 Cascade 面板刷新插件，按提示完成登录。

在 Google Antigravity 中，打开 Agent 面板 → MCP servers（插头图标）→ Manage MCP servers → View raw config，添加：

{
  "mcpServers": {
    "iapp-ai": { "serverUrl": "https://mcp.iapp.co.th" }
  }
}

保存并刷新 — Antigravity 会在浏览器中打开 iApp 登录页，批准后工具即可供 Gemini 使用。

如果您的版本无法完成登录，请改用 mcp-remote 桥接：

{
  "mcpServers": {
    "iapp-ai": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.iapp.co.th"]
    }
  }
}

任何支持 Streamable HTTP + OAuth 的客户端都可直接使用 https://mcp.iapp.co.th。

对于仅支持 stdio 或不兼容 OAuth 的客户端，使用 mcp-remote 桥接 — 它在本地运行，处理浏览器登录、自动刷新 token，并把 iApp AI 暴露为普通 stdio 服务器：

{
  "mcpServers": {
    "iapp-ai": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.iapp.co.th"]
    }
  }
}

或使用 API key 运行本地服务器 — 全部 44 个工具，包括本地文件 OCR。

通过远程连接器您能得到什么

连接器默认提供 iApp 最常用的 16 项服务（21 个工具）：语音转文字、文字转语音、文档 OCR、泰国法条与最高法院判例（ฎีกา）及有据可依的法律问答、人脸比对、静默活体检测、翻译、泰国身份证 OCR、驾照 OCR、护照 OCR、泰国假日、图像去背景、车牌识别，以及全新的 图像生成、演示幻灯片生成和视频生成。

调用按正常 API 价格计费。文件输入必须是公开的 http(s) URL，而非本地路径——服务器在远端运行，无法读取你的磁盘。需要处理本地文件请运行本地服务器。

选择你需要的工具

每个工具定义都会在整个会话中占用助手的上下文，因此连接器默认只提供最常用的服务，而不是全部。在连接器 URL 后加上查询参数即可调整：

连接器 URL	提供的工具
`https://mcp.iapp.co.th`	默认的 16 项服务，含图像/幻灯片/视频生成（推荐）
`https://mcp.iapp.co.th/?tools=all`	远程服务器的全部工具
`https://mcp.iapp.co.th/?groups=legal`	仅单一类别——上下文占用最小
`https://mcp.iapp.co.th/?groups=default,llm`	默认集合再加一个类别
`https://mcp.iapp.co.th/?tools=iapp_translate,iapp_summarize`	只加载指定的工具

类别：speech、ocr、identity、face、vision、legal、data、nlp、llm。

当你清楚要做什么时，缩小范围很值得——只加载 ?groups=legal 的法律研究助手，上下文开销远小于全量集合。未知名称会被忽略而不是报错，因此拼写错误只损失一个工具，不会影响连接。

为什么要使用它

没有 MCP，调用 iApp API 意味着写脚本：读文件、构建请求、处理响应。有了 MCP，您只需描述想要的结果，助手会处理所有繁琐环节 — 包括把多个 API 串联起来。

试着问 "หาฎีกาที่ตีความ ป.อ. มาตรา 335 หลังปี 2560"，助手会搜索真实的最高法院判例并附上核验链接。无需胶水代码，对话里也不会出现任何 key。

Claude 使用 iApp AI 工具回答泰国诽谤法问题 — 实时显示 Grounded Thai Legal Q&A 与 Section Lookup 工具调用

PyPI · iapp-mcp npm · iapp-mcp GitHub · iapp_ai

本地服务器（全部 44 个工具）

iapp-mcp 包在本地通过 stdio 运行 — API key 不离开您的机器，文件直接从磁盘读取，全部 44 个工具可用，包括本地文件 OCR、eKYC、语音和图像/视频生成。

在 Claude Code 中安装 — 一条命令

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

前提条件

1. iApp API 密钥

在 iapp.co.th 登录/注册
在控制面板中转到API 密钥
点击创建新的 API 密钥，命名并创建
复制密钥 — 它只显示一次

2. 运行时

服务器已发布到 PyPI 和 npm — 任您选择。

Python 3.10+

包管理器	无需安装即可运行	永久安装
uv	`uvx iapp-mcp`	`uv tool install iapp-mcp`
pip	—	`pip install iapp-mcp`

Node.js 18+

包管理器	无需安装即可运行	永久安装
npm	`npx -y iapp-mcp`	`npm install -g iapp-mcp`
yarn	`yarn dlx iapp-mcp`	`yarn global add iapp-mcp`
pnpm	`pnpm dlx iapp-mcp`	`pnpm add -g iapp-mcp`

备注

npm 包是 Python 服务器的薄启动器，因此 uv 必须两种方式都安装：

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

设置 — Claude Code

使用 claude mcp add CLI。选择与您安装方式匹配的一行，使用 -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

工具参考

全部 44 种工具。文件输入是本地文件路径；生成的文件将写入您指定的 output_path。

eKYC

工具	功能	关键输入
`iapp_thai_id_card_ocr`	读取泰国国民身份证照片中的数据	`file_path`、`side`（正面/背面）
`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`（单人/多人）
`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`	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`	从简历/CV 中提取结构化数据并进行 AI 评估	`file_path`
`iapp_job_description_ocr`	从职位描述中提取结构化数据	`file_path`

大型语言模型

工具	功能	关键输入
`iapp_llm_chat`	与 iApp 托管的 LLM 聊天（OpenAI 兼容）	`prompt` 或 `messages`、`model`：`deepseek-chat`（默认）/ `deepseek-reasoner` / `deepseek-v4-flash` / `deepseek-v4-pro`、`system_prompt`、`max_tokens`、`temperature`
`iapp_openthai_legal_chat`	提出可验证มาตรา 引用的泰国法律问题 — 基于 39 条泰国法律的 RAG，返回使用的法规条款（至 2026 年 9 月 30 日免费）	`prompt` 或 `messages`、`rag`（默认 true）、`rag_top_k`、`rag_inject`（`user`/`system`）、`max_tokens`、`temperature`
`iapp_thanoy_legal_qa`	提出泰国法律问题（Thanoy 法律 AI）	`query`

泰语 NLP

工具	功能	关键输入
`iapp_translate`	在 28 种语言之间进行翻译（优化泰语）	`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`、`model`
`iapp_slide_generation`	生成完整的 16:9 演示幻灯片——标题、要点与图表	`title`、`content`、`style`、`aspect_ratio`
`iapp_remove_background`	从图像中删除背景	`file_path`、`output_path`
`iapp_video_generation_submit`	提交异步 Seedance 视频任务——返回 task id	`prompt`、`model`、`duration`、`ratio`、`resolution`、`generate_audio`
`iapp_video_generation_status`	轮询视频任务并获取下载 URL	`task_id`

智慧城市 AI 与泰国数据

工具	功能	关键输入
`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`，或不填

泰国法律数据（法条 + ฎีกา）

工具	功能	主要输入
`iapp_thai_law_list`	39 部已索引泰国法律的目录（免费）— 请先调用以获取有效法律名称	`q`（可选名称过滤）
`iapp_thai_law_section`	法条原文；可选附上引用该法条的最高法院判决	`law`、`section`、`with_deka`
`iapp_thai_law_search`	从泰语事实描述进行语义法规搜索	`query`、`top_k`（1–20，默认 8）
`iapp_thai_deka_search`	在 70,634 份判决中检索判例；可按被引用法条筛选	`query`、`cites_law`、`cites_section`、`year_from`、`top_k`
`iapp_thai_deka_get`	按 ฎีกา 编号获取单个判决（`1234/2565` 或 `1234-2565`）	`case_id`、`include_body`
`iapp_thai_legal_ask`	基于事实、引文经机器校验的法律回答 — 绝不虚构案件编号	`question`、`include_deka`

→ 完整详情：泰国法律数据 API/MCP

用法示例

连接后 — 在 Claude Code、Claude Desktop 或任何其他 MCP 客户端中 — 只需用泰语或英语提问。没有命令语法；助手会选择工具。

eKYC

อ่านข้อมูลจากบัตรประชาชนในไฟล์ idcard.jpg
เช็คว่ารูป selfie.jpg กับ idcard.jpg เป็นคนเดียวกันไหม
Extract the MRZ data from passport.jpg
ตรวจว่ารูป face.jpg เป็นภาพถ่ายคนจริงหรือภาพปลอม

文档

OCR ใบเสร็จ receipt.jpg แล้วรวมยอดให้หน่อย
แปลงเอกสารสแกนนี้เป็นไฟล์ Word
สกัดข้อมูลจาก resume.pdf แล้วประเมินความเหมาะสมกับตำแหน่ง
อ่านหนังสือรับรองหักภาษี ณ ที่จ่าย (50 ทวิ) ไฟล์นี้

语音和语言

ถอดเสียงไฟล์ประชุม meeting.wav พร้อมระบุว่าใครพูด
อ่านข้อความนี้เป็นเสียงพูดด้วยเสียงไข่ต้ม เซฟเป็น speech.wav
แปลข้อความนี้เป็นภาษาญี่ปุ่น
วิเคราะห์ว่ารีวิวลูกค้าพวกนี้เป็นบวกหรือลบ

LLM 和法律

ถาม Chinda Thai LLM ว่า ส้มตำมีกี่แคลอรี่
ใช้ DeepSeek V4 Flash ช่วยจัดหมวดหมู่ข้อความลูกค้าพวกนี้
ถามทนอย: สัญญาเช่าบ้านไม่มีลายเซ็นพยานมีผลไหม

创意和智慧城市

สร้างรูปแมวใส่ชุดไทยนั่งริมเจ้าพระยา เซฟเป็น cat.png
Generate a 5-second video of a cat surfing at sunset
จัดเส้นทางส่งของ 20 จุดนี้ให้คนขับ 3 คน เริ่มจากคลังสินค้า
อ่านป้ายทะเบียนรถจากภาพกล้องวงจรปิด cctv.jpg

泰国法律数据

ขอตัวบท ป.อ. มาตรา 335 พร้อมฎีกาที่เกี่ยวข้อง （请给出刑法典第 335 条原文及相关判例）
หาฎีกาที่ตีความ ป.อ. มาตรา 335 หลังปี 2560 （查找 2560 年后解释第 335 条的判例）
ลักทรัพย์ในเวลากลางคืนมีโทษอย่างไร ตอบแบบอ้างอิงได้ （夜间盗窃如何处罚？请附可验证引文）

注意事项和限制

本地文件路径。 基于文件的工具接受您机器上的路径；生成的音频、图像和视频会写入您命名的 output_path。
积分。 大多数工具每次调用都会消耗 iApp 积分 (IC)。每个工具的说明文档中都列出了其成本。Chinda Thai LLM 4B 是免费的。
Seedance 视频生成需要付费账户 — 购买任何 IC 套餐即可解锁。
上下文保持较小。 API 响应中的大型 Base64 块（例如，裁剪的面部图像）在工具输出中会被截断。
运行时。 Python 3.10+ 或 Node.js 18+。

故障排除

症状	修复方法
旧版 `iapp-mcp`（本地）显示 failed — Windows 上常见	经典 stdio 服务器需要安装 `uv`。最简单的解决办法：改用远程服务器 — `claude mcp remove iapp-mcp` 然后 `claude mcp add --transport http iapp-ai https://mcp.iapp.co.th`（无需 uv、无需 API key）。或安装 uv 继续使用本地版
`iapp-ai`（远程）显示 Needs authentication	新添加后的正常状态 — 运行 `/mcp` → iapp-ai → Authenticate 并登录
`claude mcp list` 显示服务器失败	检查 `uv` 是否已安装并在您的 `PATH` 中 — 直接运行 `uvx iapp-mcp` 以查看错误
每个工具都出现身份验证错误	`IAPP_API_KEY` 值错误或已过期。使用正确的密钥重新添加，或检查控制面板中的API 密钥
服务器在其他项目中缺失	您使用的是默认的 `-s local` 作用域安装的。使用 `-s user` 重新添加
积分不足 (HTTP 402)	在控制面板中充值；在定价页面查看每个工具的成本
视频生成被拒绝	Seedance 需要付费账户 — 购买任何 IC 套餐即可解锁

偏好编写代码？

如果您要从自己的 Python 程序而不是通过助手调用 iApp API，请改用 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 基础，因此行为和错误处理是相同的。

链接

公告： iApp AI 2.0 — 新软件包和 MCP 服务器
GitHub： github.com/iapp-technology/iapp_ai
PyPI： iapp-mcp · iapp-ai · iapp-core
npm： iapp-mcp
支持： support@iapp.co.th · Discord

iApp AI MCP Server

连接您的客户端

选择你需要的工具

为什么要使用它

本地服务器（全部 44 个工具）

前提条件

1. iApp API 密钥

2. 运行时

设置 — Claude Code

作用域

验证和管理

设置 — 其他 MCP 客户端

工具参考

eKYC

泰国文件 OCR

大型语言模型

泰语 NLP

语音技术

图像与视频生成

智慧城市 AI 与泰国数据

泰国法律数据（法条 + ฎีกา）

用法示例

注意事项和限制

故障排除

偏好编写代码？

链接

ChindaX

SpeechFlow

ChindaGO

连接您的客户端​

选择你需要的工具​

为什么要使用它​

本地服务器（全部 44 个工具）​

前提条件​

1. iApp API 密钥​

2. 运行时​

设置 — Claude Code​

作用域​

验证和管理​

设置 — 其他 MCP 客户端​

工具参考​

eKYC​

泰国文件 OCR​

大型语言模型​

泰语 NLP​

语音技术​

图像与 视频生成​

智慧城市 AI 与 泰国数据​

泰国法律数据（法条 + ฎีกา）​

用法示例​

注意事项和限制​

故障排除​

偏好编写代码？​

链接​

连接您的客户端

选择你需要的工具

为什么要使用它

本地服务器（全部 44 个工具）

前提条件

1. iApp API 密钥

2. 运行时

设置 — Claude Code

作用域

验证和管理

设置 — 其他 MCP 客户端

工具参考

eKYC

泰国文件 OCR

大型语言模型

泰语 NLP

语音技术

图像与视频生成

智慧城市 AI 与泰国数据

泰国法律数据（法条 + ฎีกา）

用法示例

注意事项和限制

故障排除

偏好编写代码？

链接