🔌 iApp AI MCP Server

เชื่อม Claude Code, Claude Desktop, Cursor หรือไคลเอนต์ MCP ตัวใดก็ได้ เข้ากับ iApp AI Marketplace ทั้งหมด ด้วยคำสั่งเดียว ผู้ช่วย AI ของคุณจะได้ เครื่องมือ 37 ตัว ครอบคลุมทั้ง OCR, eKYC, NLP ภาษาไทย, LLM, เสียงพูด และการสร้างภาพ/วิดีโอ

🐍 PyPI · iapp-mcp📦 npm · iapp-mcp🐙 GitHub · iapp_ai

ติดตั้งใน Claude Code ด้วยคำสั่งเดียว

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

จากนั้นพิมพ์สั่งงานเป็นภาษาปกติได้เลย ไม่ต้องเรียนรู้ไวยากรณ์คำสั่งพิเศษใด ๆ

ทำไมต้องใช้

หากไม่มี MCP การเรียก API ของ iApp หมายถึงต้องเขียนสคริปต์เอง ทั้งอ่านไฟล์ ประกอบคำขอ และจัดการผลลัพธ์ แต่เมื่อใช้ MCP คุณเพียงบอกผลลัพธ์ที่ต้องการ แล้วผู้ช่วยจะจัดการเบื้องหลังให้ทั้งหมด รวมถึงการต่อ API หลายตัวเข้าด้วยกัน

ลองสั่งว่า "อ่านใบเสร็จทุกใบในโฟลเดอร์ ./expenses รวมยอดแยกตามหมวด แล้วเขียนสรุปเป็นภาษาไทย" ผู้ช่วยจะไล่ OCR ทั้งโฟลเดอร์ คำนวณ และร่างสรุปให้ โดยคุณไม่ต้องเขียนโค้ดเชื่อมเลยสักบรรทัด

เซิร์ฟเวอร์ทำงาน บนเครื่องของคุณผ่าน stdio ดังนั้น API key จึงไม่ออกจากเครื่อง และไฟล์ก็อ่านจากดิสก์ของคุณโดยตรง

สิ่งที่ต้องเตรียม

1. API key ของ iApp

1. เข้าสู่ระบบ / สมัครสมาชิก ที่ iapp.co.th
2. ไปที่เมนู API Keys ในหน้าควบคุม
3. คลิก Create New API Key ตั้งชื่อ แล้วสร้าง
4. คัดลอกคีย์เก็บไว้ — ระบบแสดงให้เห็นเพียงครั้งเดียว

2. Runtime

เซิร์ฟเวอร์เผยแพร่ทั้งบน 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

note

แพ็กเกจ npm เป็นเพียงตัวเรียกบาง ๆ ของเซิร์ฟเวอร์ที่เขียนด้วย Python ดังนั้นไม่ว่าทางไหนก็ต้องติดตั้ง uv ก่อน

curl -LsSf https://astral.sh/uv/install.sh | sh    # หรือ: brew install uv

การตั้งค่า — Claude Code

ใช้คำสั่ง claude mcp add เลือกบรรทัดที่ตรงกับวิธีติดตั้งของคุณ ใส่ API key ด้วย -e และคั่นด้วย -- ก่อนคำสั่งที่ใช้เรียกเซิร์ฟเวอร์

# 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

ขอบเขตการติดตั้ง (scope)

แฟล็ก	มีผลที่ไหน
-s user	ทุกโปรเจกต์บนเครื่องนี้ (แนะนำ)
-s project	เฉพาะโปรเจกต์นี้ โดยเขียนลงไฟล์ .mcp.json ที่แชร์ให้เพื่อนร่วมทีมเมื่อ clone
-s local	เฉพาะโปรเจกต์นี้บนเครื่องนี้เท่านั้น (ค่าเริ่มต้นหากไม่ระบุ)

ตรวจสอบและจัดการ

claude mcp list              # ควรเห็น iapp-mcp เชื่อมต่อสำเร็จ
claude mcp remove iapp-mcp   # ถอดออกภายหลัง

หรือพิมพ์ /mcp ในเซสชัน Claude Code เพื่อดูเซิร์ฟเวอร์และรายการเครื่องมือทั้งหมด

การตั้งค่า — ไคลเอนต์ 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	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	สนทนากับ LLM ที่โฮสต์บน 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	ถามคำถามกฎหมายไทย (ทนอย Legal AI)	query

🌐 NLP ภาษาไทย

เครื่องมือ	ทำอะไร	อินพุตสำคัญ
iapp_translate	แปลระหว่าง 28 ภาษา (ปรับให้เหมาะกับภาษาไทย)	text, source_lang, target_lang
iapp_summarize	สรุปข้อความภาษาไทย/อังกฤษ	text, style, language
iapp_sentiment_analysis	วิเคราะห์อารมณ์ข้อความไทย บวก/กลาง/ลบ	text
iapp_toxicity_classification	ตรวจจับข้อความไทยที่เป็น toxic	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 แบบ async	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
เช็คว่ารูป selfie.jpg กับ idcard.jpg เป็นคนเดียวกันไหม
อ่านข้อมูล MRZ จากพาสปอร์ต passport.jpg
ตรวจว่ารูป face.jpg เป็นภาพถ่ายคนจริงหรือภาพปลอม

เอกสาร

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

เสียงพูดและภาษา

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

LLM และกฎหมาย

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

งานสร้างสรรค์และเมืองอัจฉริยะ

สร้างรูปแมวใส่ชุดไทยนั่งริมเจ้าพระยา เซฟเป็น cat.png
สร้างวิดีโอ 5 วินาที ภาพแมวโต้คลื่นตอนพระอาทิตย์ตก
จัดเส้นทางส่งของ 20 จุดนี้ให้คนขับ 3 คน เริ่มจากคลังสินค้า
อ่านป้ายทะเบียนรถจากภาพกล้องวงจรปิด cctv.jpg

ข้อควรรู้และข้อจำกัด

• ใช้พาธไฟล์บนเครื่อง เครื่องมือที่รับไฟล์จะใช้พาธบนเครื่องคุณ ส่วนเสียง ภาพ และวิดีโอที่สร้างขึ้นจะถูกบันทึกไปยัง output_path ที่คุณระบุ
• เครดิต เครื่องมือส่วนใหญ่มีค่าใช้จ่ายเป็นเครดิต iApp (IC) ต่อการเรียกหนึ่งครั้ง โดยระบุไว้ในคำอธิบายของแต่ละเครื่องมือ ส่วน Chinda Thai LLM 4B ใช้ฟรี
• การสร้างวิดีโอ Seedance ต้องเป็นบัญชีแบบชำระเงิน เพียงซื้อแพ็กเกจ IC ใดก็ได้ก็ปลดล็อก
• ประหยัดคอนเท็กซ์ ข้อมูล base64 ก้อนใหญ่ในผลลัพธ์ API (เช่น ภาพใบหน้าที่ครอบมา) จะถูกตัดทอนในผลลัพธ์ของเครื่องมือ
• Runtime ต้องใช้ 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 ใดก็ได้ก็ปลดล็อก

ถนัดเขียนโค้ดมากกว่า

หากคุณเรียก API ของ iApp จากโปรแกรม Python ของตัวเอง แทนที่จะผ่านผู้ช่วย 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 ร่วมกัน พฤติกรรมและการจัดการข้อผิดพลาดจึงเหมือนกันทุกประการ

ลิงก์

• ประกาศเปิดตัว: iApp AI 2.0 — แพ็กเกจใหม่พร้อม MCP Server
• GitHub: github.com/iapp-technology/iapp_ai
• PyPI: iapp-mcp · iapp-ai · iapp-core
• npm: iapp-mcp
• ฝ่ายสนับสนุน: support@iapp.co.th · Discord