🔥 Bài toán M × N integrations

🎯 MCP giảm xuống chỉ M + N

Định nghĩa: Resources là data sources read-only mà server expose cho client. Client (hoặc user) chủ động kéo về để cung cấp context cho model.

Ví dụ resources phổ biến:

• File content: file:///home/user/notes.md
• Database row: postgres://db/users/123
• Log entry: log://service-a/2025-06-21
• Image: screen://capture/window-1

Khi nào dùng? Khi data không thay đổi state (chỉ đọc). User control khi nào include.

Định nghĩa: Tools là functions model có thể tự gọi (autonomous) để thực hiện hành động. Đây là tương đương "function calling" nhưng chuẩn hóa qua MCP.

Ví dụ tools phổ biến:

• create_file(path, content) → tạo file
• query_database(sql) → truy vấn DB
• send_slack_message(channel, text) → gửi Slack
• git_commit(message) → commit code
• search_github_issues(repo, query) → tìm issue

Khi nào dùng? Khi action thay đổi state hoặc cần model tự quyết định gọi.

Định nghĩa: Prompts là template được tham số hóa mà user có thể invoke (thường qua slash command "/").

Ví dụ prompts:

• /code-review file=app.py → server trả về prompt review code chuẩn
• /summarize-pr number=123 → server fetch PR rồi sinh prompt summary
• /explain-stacktrace error=... → format stacktrace để Claude debug

Khi nào dùng? Khi muốn cung cấp workflow chuẩn cho user, ẩn complexity prompt engineering.

Request: Client gọi tool

1{
2  "jsonrpc": "2.0",
3  "id": 42,
4  "method": "tools/call",
5  "params": {
6    "name": "query_database",
7    "arguments": {
8      "sql": "SELECT name FROM users WHERE active = true LIMIT 10"
9    }
10  }
11}

Response: Server trả kết quả

1{
2  "jsonrpc": "2.0",
3  "id": 42,
4  "result": {
5    "content": [
6      {
7        "type": "text",
8        "text": "[{\"name\":\"Huy\"},{\"name\":\"Linh\"},..."
9      }
10    ],
11    "isError": false
12  }
13}

🎯 Tóm lại: MCP không thay thế function calling — mà là lớp chuẩn hóa cao hơn giúp function calling reusable cross-app, cross-vendor. Bên dưới, MCP server vẫn dùng function calling khi gọi LLM.

Bước 1: Install SDK

1pip install mcp

Bước 2: Tạo server.py

1from mcp.server.fastmcp import FastMCP
2from datetime import datetime
3
4mcp = FastMCP("Demo Server")
5
6@mcp.tool()
7def calculate_age(birth_year: int) -> int:
8    """Tính tuổi hiện tại dựa trên năm sinh."""
9    return datetime.now().year - birth_year
10
11@mcp.resource("author://info")
12def get_author_info() -> str:
13    """Thông tin tác giả MCP server demo."""
14    return "Nguyễn Quốc Huy (Rinez) — MinAI Learning Platform"
15
16@mcp.prompt()
17def code_review_prompt(file_path: str) -> str:
18    """Sinh prompt review code cho file cụ thể."""
19    return f"Hãy review file {file_path} với focus: security, performance, readability."
20
21if __name__ == "__main__":
22    mcp.run(transport="stdio")

Bước 3: Đăng ký vào Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

1{
2  "mcpServers": {
3    "demo": {
4      "command": "python",
5      "args": ["/path/to/server.py"]
6    }
7  }
8}

Bước 4: Restart Claude Desktop → bạn sẽ thấy icon MCP ở góc dưới input box. Gõ: "Tôi sinh năm 1995, tính tuổi của tôi" → Claude tự gọi calculate_age(1995) và trả kết quả.

Cài đặt

1npm install @modelcontextprotocol/sdk

Tạo server.ts

1import { Server } from "@modelcontextprotocol/sdk/server/index.js";
2import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
3
4const server = new Server(
5  { name: "demo-ts", version: "1.0.0" },
6  { capabilities: { tools: {} } }
7);
8
9server.setRequestHandler("tools/list", async () => ({
10  tools: [
11    {
12      name: "calculate_age",
13      description: "Tính tuổi hiện tại",
14      inputSchema: {
15        type: "object",
16        properties: { birthYear: { type: "number" } },
17        required: ["birthYear"],
18      },
19    },
20  ],
21}));
22
23server.setRequestHandler("tools/call", async (req) => {
24  if (req.params.name === "calculate_age") {
25    const year = req.params.arguments.birthYear as number;
26    return { content: [{ type: "text", text: String(new Date().getFullYear() - year) }] };
27  }
28  throw new Error("Unknown tool");
29});
30
31const transport = new StdioServerTransport();
32await server.connect(transport);

🎯 Cách bắt đầu cho dev VN

1. Cài Claude Desktop (free, tier có hạn) hoặc dùng Cursor / Continue.dev
2. Cài 3 MCP servers cơ bản: filesystem, github, fetch
3. Build 1 MCP server custom đầu tiên cho use case cụ thể của bạn (vd: tra cứu CIC, query nội bộ)
4. Share open-source nếu phù hợp → contribute community

🎯 MCP = chuẩn industry cho AI integration giai đoạn 2026-2030