aipass-th-mcp

MCP server ที่เชื่อมต่อกับ TH-AI Passport (https://de.aipass.net) ผ่านเบราว์เซอร์จริง (Playwright) เพื่อดึงรายการแชท / เนื้อหาแชท และส่งข้อความใหม่ ทำงานบนคอมพิวเตอร์ของคุณเอง ไม่ใช่บนเซิร์ฟเวอร์ของใคร

⚠️ นี่คือการ reverse-engineer endpoint ภายใน (/loaders/...) ของเว็บนี้เอง ไม่ใช่ API ทางการที่มีเอกสารรองรับ ถ้าเว็บอัปเดต UI หรือโครงสร้างข้อมูล สคริปต์อาจต้องแก้ selector ใหม่ ใช้กับบัญชีของคุณเองเท่านั้น และเป็นความรับผิดชอบของคุณในการตรวจสอบเงื่อนไขการใช้งานของเว็บ

สิ่งที่ต้องมี

• Node.js 18 ขึ้นไป

• เบราว์เซอร์ Chromium ของ Playwright (ติดตั้งอัตโนมัติตอน npm install)

Related MCP server: cdp-bridge

ติดตั้ง

cd aipass-mcp
npm install

คำสั่งนี้จะติดตั้งไลบรารีและดาวน์โหลด Chromium ให้ Playwright อัตโนมัติ (ผ่าน postinstall)

เพิ่มเข้า Claude Desktop / Claude Code

แก้ไฟล์ config ของ Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

เพิ่ม (แก้ path ให้เป็น path เต็มของโฟลเดอร์นี้ในเครื่องคุณ):

{
  "mcpServers": {
    "aipass-th": {
      "command": "node",
      "args": ["/absolute/path/to/aipass-mcp/server.js"]
    }
  }
}

แล้วรีสตาร์ท Claude Desktop

(ถ้าใช้ Claude Code แทน ให้เพิ่มด้วย claude mcp add aipass-th node /absolute/path/to/aipass-mcp/server.js)

การใช้งานครั้งแรก: login

บอก Claude ให้เรียกเครื่องมือ login (ในเซิร์ฟเวอร์ aipass-th) หนึ่งครั้ง — จะมีหน้าต่าง เบราว์เซอร์เปิดขึ้นมาให้คุณ login เข้า TH-AI Passport ด้วยตัวเอง (username/password หรือวิธีที่เว็บ กำหนด) เมื่อ login สำเร็จ session จะถูกบันทึกไว้ในเครื่องนี้ที่โฟลเดอร์ ~/.aipass-mcp-profile (เปลี่ยนตำแหน่งได้ด้วย env var AIPASS_PROFILE_DIR)

ครั้งต่อ ๆ ไปไม่ต้อง login ใหม่ เว้นแต่ session หมดอายุ — ถ้าเครื่องมืออื่นแจ้งว่ายังไม่ได้ login ให้เรียก login ซ้ำอีกครั้ง

session/cookie ถูกเก็บไว้ในเครื่องนี้เท่านั้น ไม่ได้ถูกส่งออกไปที่ไหนทั้งสิ้น

เครื่องมือที่มีให้ใช้

ข้อจำกัดที่รู้อยู่แล้ว

• list_chats / search_chats อ่านจาก DOM ของแถบด้านข้าง ถ้ามีแชทจำนวนมากที่ต้อง เลื่อน/โหลดเพิ่ม อาจได้ไม่ครบทุกรายการในครั้งเดียว

• send_message ใช้การพิมพ์ + กด Enter จริงในหน้าเว็บ และรอคำตอบสูงสุด ~60 วินาที ถ้า AI ตอบช้ากว่านั้นอาจต้องเรียก get_chat ซ้ำเองเพื่อดูคำตอบล่าสุด

• ทำงานแบบ headless (ไม่เห็นหน้าต่าง) ยกเว้นตอน login