跳到主要内容

🔌 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 的 Add custom connector 对话框
通过远程连接器您能得到什么

连接器默认提供 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 工具调用

本地服务器（全部 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 密钥​

  1. 在 iapp.co.th 登录/注册
  2. 在控制面板中转到API 密钥
  3. 点击创建新的 API 密钥，命名并创建
  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 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_ocrOCR 任何泰语文档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 年 8 月 24 日免费）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 idprompt、model、duration、ratio、resolution、generate_audio
iapp_video_generation_status轮询视频任务并获取下载 URLtask_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_list39 部已索引泰国法律的目录（免费）— 请先调用以获取有效法律名称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 基础，因此行为和错误处理是相同的。

链接​