MCP Clients

Khái niệm cơ bản

Tưởng tượng Client như “adapter” sạc điện thoại…

• Ổ cắm (Server) cho ra điện 220V
• Adapter (Client) chuyển đổi thành 5V USB
• Điện thoại (LLM) nhận điện an toàn

Client = Protocol layer nằm trong Host, dịch ngôn ngữ giữa Host và Server.

---

Kiến trúc Client

┌─────────────────────────────────────┐
│              HOST                    │
│                                     │
│  ┌─────────────────────────────┐   │
│  │         CLIENT              │   │
│  │                             │   │
│  │  - Session management      │   │
│  │  - Request/Response queue  │   │
│  │  - Error handling          │   │
│  │  - Reconnection logic      │   │
│  │                             │   │
│  └─────────────┬───────────────┘   │
│                │                    │
└────────────────┼────────────────────┘
                 │
        ┌────────┴────────┐
        │   TRANSPORT     │
        │  (stdio / SSE)  │
        └────────┬────────┘
                 │
                 ▼
         ┌─────────────┐
         │   SERVER    │
         └─────────────┘

---

Transport Types

1. Stdio (Standard Input/Output)

Server chạy như subprocess, giao tiếp qua stdin/stdout.

HOST                          SERVER
  │                              │
  │  ──────stdin────────────▶   │
  │  {"jsonrpc":"2.0",...}      │
  │                              │
  │  ◀─────stdout───────────    │
  │  {"result":{...}}           │
  │                              │

Config ví dụ:

{
  "filesystem": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path"]
  }
}

Ưu điểm	Nhược điểm
Nhanh (no network overhead)	Chỉ chạy local
Bảo mật (no ports exposed)	Không share được
Đơn giản setup	Server phải restart với Host

---

2. SSE (Server-Sent Events)

Server chạy như HTTP server, client kết nối qua network.

HOST (Browser/App)               SERVER (HTTP)
       │                              │
       │  ──POST /message────────▶   │
       │  {"jsonrpc":"2.0",...}      │
       │                              │
       │  ◀─────SSE stream──────     │
       │  event: message             │
       │  data: {"result":{...}}     │
       │                              │

Config ví dụ:

{
  "remote-server": {
    "url": "https://mcp.example.com",
    "transport": "sse",
    "headers": {
      "Authorization": "Bearer token123"
    }
  }
}

Ưu điểm	Nhược điểm
Remote connections	Cần network setup
Scalable	Security concerns
Shareable across users	Latency overhead

---

JSON-RPC 2.0 Protocol

Mọi message đều theo format JSON-RPC:

Request (Client → Server)

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "read_file",
    "arguments": {
      "path": "/Users/me/document.txt"
    }
  }
}

Response (Server → Client)

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "File content here..."
      }
    ]
  }
}

Notification (No response expected)

{
  "jsonrpc": "2.0",
  "method": "notifications/progress",
  "params": {
    "progressToken": "task-1",
    "progress": 50,
    "total": 100
  }
}

---

Common Methods

Method	Direction	Description
initialize	Client → Server	Handshake, exchange capabilities
tools/list	Client → Server	Get available tools
tools/call	Client → Server	Execute a tool
resources/list	Client → Server	Get available resources
resources/read	Client → Server	Read a resource
prompts/list	Client → Server	Get available prompts
prompts/get	Client → Server	Get prompt template

---

So sánh Stdio vs SSE

Aspect	Stdio	SSE
Setup	Config command path	Config URL + auth
Network	None (local process)	HTTP/HTTPS
Security	Inherently sandboxed	Need TLS + auth
Use case	Local dev tools	Enterprise, shared
Latency	Microseconds	Milliseconds
Scale	1 user per process	Many users

💡 Khuyến nghị: Bắt đầu với Stdio cho development, chuyển sang SSE khi cần deploy.

---

Bài tập thực hành

Mục tiêu

Hiểu cách Client giao tiếp bằng cách xem logs.

Bước thực hiện

1. Chạy MCP server với debug mode:

npx -y @modelcontextprotocol/server-filesystem /tmp --debug

2. Quan sát stdin/stdout trong terminal

3. Hoặc sử dụng MCP Inspector:

npx @modelcontextprotocol/inspector

4. Kết nối server và gửi request thủ công

Câu hỏi

• Request tools/list trả về những tools nào?
• Thử gọi tools/call với tool read_file

---

Tóm tắt

Khái niệm	Ý nghĩa
Client	Protocol layer trong Host
Stdio	Transport qua stdin/stdout
SSE	Transport qua HTTP
JSON-RPC	Message format chuẩn

Bài tiếp theo: MCP Servers - Xây dựng nguồn dữ liệu.