Model Context Protocol (MCP)

เชื่อมต่อ Clew กับเครื่องมือภายนอก, แหล่งข้อมูล, และบริการผ่าน MCP — มาตรฐานเปิดสำหรับ AI-tool integration

MCP อยู่ใน src/services/mcp/ — Clew ค้นหาเซิร์ฟเวอร์ MCP จาก settings.json, CLI flags, และ plugin manifests แล้วรวมเครื่องมือเข้าสู่ runtime

สถาปัตยกรรม

 ┌──────────────────────────────────────────────────────────────────────────┐
 │                    MCP — MODEL CONTEXT PROTOCOL                           │
 └──────────────────────────────────────────────────────────────────────────┘

                         ┌──────────────────────────┐
                         │   Settings / CLI Config   │
                         │  src/services/mcp/config  │
                         └────────────┬─────────────┘
                                      │
                                      â–¼
                     ┌──────────────────────────┐
                     │   MCPConnectionManager   │
                     │  จัดการ lifecycle        │
                     │  ของเซิร์ฟเวอร์ MCP ทั้งหมด │
                     └────────────┬─────────────┘
                                  │
              ┌───────────────────┼───────────────────┐
              â–¼                   â–¼                   â–¼
      ┌──────────────┐   ┌──────────────┐   ┌──────────────┐
      │  Stdio MCP   │   │   SSE MCP    │   │Direct Connect│
      │ (subprocess) │   │  (remote)    │   │ (in-process) │
      │ npx/node/etc │   │  HTTP + SSE  │   │              │
      └──────┬───────┘   └──────┬───────┘   └──────┬───────┘
             │                  │                   │
             └──────────────────┼───────────────────┘
                                │
                                â–¼
                     ┌──────────────────────┐
                     │   Client (JSON-RPC)  │
                     │  tools/list          │
                     │  tools/call          │
                     │  resources/list      │
                     └──────────┬───────────┘
                                │
                                â–¼
                     ┌──────────────────────┐
                     │   assembleToolPool   │
                     │  (MCP + built-in     │
                     │   tools รวมกัน)      │
                     └──────────┬───────────┘
                                │
                                â–¼
                     ┌──────────────────────┐
                     │    Query Engine      │
                     │  Model เห็น tools     │
                     │  ทั้งหมดใน pool      │
                     └──────────────────────┘

วิธีการทำงาน

การค้นหาเซิร์ฟเวอร์

MCP servers ถูกค้นหาจาก 3 แหล่งเมื่อเริ่มต้น:

1. settings.json — คีย์ mcpServers กำหนด command, args, env
2. CLI --mcp-config — ไฟล์หรือ inline JSON
3. Plugins — manifest ของ plugin สามารถประกาศ MCP server ได้; เริ่มเมื่อ plugin โหลด, หยุดเมื่อ unload

ประเภทการเชื่อมต่อ

Tool Lifecycle

  1. CONNECT    ──► MCPConnectionManager เชื่อมต่อ server
                       │
                       â–¼
  2. DISCOVER   ──► เรียก tools/list (รองรับ paginated)
                       │
                       â–¼
  3. MERGE      ──► assembleToolPool() รวม MCP tools
                       │  กับ built-in tools (sort + dedup)
                       â–¼
  4. PRESENT    ──► Model เห็น MCP tools เป็น native tools
                       │  (permission gating, hooks, logging)
                       â–¼
  5. EXECUTE    ──► Model เรียก tool → toolExecution.ts
                       │  route ไปยัง server ที่ถูกต้อง
                       â–¼
  6. RESPOND    ──► ผลลัพธ์กลับไปหา model

การยืนยันตัวตน (Authentication)

• OAuth 2.0 — redirect flow สำหรับ remote MCP servers เปิด local HTTP port เพื่อรับ callback
• Bearer token — static API token ใน Authorization header
• XAA token — auth provider token สำหรับ Claude-specific servers
• Credential vault — credentials ที่เก็บไว้ใน vault ถูก inject อัตโนมัติ

คำสั่ง MCP

รูปแบบ Config (settings.json)

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"],
      "env": {}
    },
    "database": {
      "command": "node",
      "args": ["./mcp/db-server.js"],
      "env": {
        "DB_URL": "postgresql://localhost:5432/mydb"
      }
    },
    "remote-api": {
      "url": "https://mcp.example.com",
      "headers": {
        "Authorization": "Bearer sk-..."
      }
    }
  }
}

Plugin-Bundled MCP Servers

Plugin สามารถประกาศ MCP server ใน manifest เมื่อ plugin โหลด Clew จะสร้าง DirectConnect session ให้อัตโนมัติ — ไม่ต้อง subprocess ไม่ต้อง network — server จะพร้อมใช้งานทันที

เครื่องมือ Built-in ที่ใช้ MCP

ไฟล์สำคัญ