Bật Mí Cách 'Dạy' LLM Hiểu Rõ Thư Viện Mới: MCP Server Vào Cuộc!

Lê Lân

18/07/2025

MCP Server: Giải Pháp Nâng Cao Hiểu Biết Cho Large Language Models Với Thư Viện Mới

Mở Đầu

Large Language Models (LLMs) như Claude đã có những bước tiến vượt bậc trong vài năm gần đây, hỗ trợ đắc lực trong nhiều lĩnh vực của kỹ thuật phần mềm, từ hỗ trợ phát triển cho đến thảo luận thiết kế. Tuy nhiên, một giới hạn cố hữu là tri thức của những mô hình này bị giới hạn tại thời điểm cập nhật dữ liệu huấn luyện. Điều này dẫn đến việc LLMs thường không thể hiểu hoặc áp dụng chính xác các thư viện mã nguồn mở mới ra đời gần đây.

Chẳng hạn, thư viện TypeScript mới nhất của chúng tôi là

praha/byethrow

– một thư viện Result type nhẹ, lấy cảm hứng từ neverthrow – thường bị LLMs như Claude hay ChatGPT xử lý không chính xác khi yêu cầu tạo mã sử dụng thư viện này. Thậm chí, chúng có thể tưởng tượng ra những hàm không tồn tại hoặc đưa ra cách dùng sai.

Để khắc phục, chúng tôi phát triển MCP (Model Context Provider) server, giúp LLMs tham chiếu tài liệu TSDoc và hiểu chính xác hơn về những thư viện mới. Bài viết này sẽ giới thiệu khái niệm, cấu trúc và cách xây dựng MCP server.

MCP Server Là Gì?

Khái Niệm MCP

MCP (Model Context Provider) là một giao thức cung cấp cho LLMs ngữ cảnh bổ sung hoặc truy cập đến các công cụ bên ngoài.

Quy Trình Hoạt Động

LLM gửi yêu cầu đến MCP server bên ngoài

MCP xử lý logic theo yêu cầu và trả về phản hồi

LLM sử dụng phản hồi để thực hiện các hành động tiếp theo

MCP giúp bổ sung thông tin chính xác và cập nhật cho LLMs dựa trên tài liệu được chuẩn bị kỹ càng, từ đó nâng cao chất lượng câu trả lời.

Cách Hoạt Động Của MCP Server Chúng Tôi

🧱 Cấu Trúc Tổng Quan

Thành phần	Vai trò
LLM (vd: Claude)	Gửi yêu cầu qua `stdin`
MCP Server (Node.js)	Nhận và xử lý yêu cầu
TSDoc Markdown	Tài liệu được tạo sẵn giúp LLM đọc hiểu

🛠 Công Nghệ Sử Dụng

TypeDoc : Tạo tài liệu Markdown từ TSDoc trong
praha/byethrow

modelcontextprotocol/sdk
: Framework xây dựng MCP server

Rslib : Đóng gói code TypeScript thành định dạng ESM

🔍 Luồng Yêu Cầu

LLM truy vấn các công cụ có sẵn từ MCP server

LLM chọn công cụ và gửi yêu cầu cụ thể

MCP server trả về tài liệu Markdown đã chuẩn bị

LLM dùng tài liệu này để tạo câu trả lời chính xác hơn

📨 Ví Dụ Phản Hồi

Nếu hỏi Claude: "Giải thích byethrow trong 3 dòng"

Không có MCP: Câu trả lời thường không chính xác hoặc sai lệch

Có MCP:

praha/byethrow
là thư viện cải thiện xử lý lỗi trong TypeScript bằng cách áp dụng lập trình hàm. Sử dụng loại Result để xử lý lỗi rõ ràng thay vì ném ngoại lệ, đảm bảo luồng lỗi an toàn kiểu. Cung cấp các combinator như pipe, andThen, map giúp viết code dễ đọc, kết hợp và gỡ lỗi.

Nhờ vậy, LLMs có thể dựa vào kiến thức API chính xác và cập nhật để trả lời.

Quá Trình Xây Dựng MCP Server

🛠 Chuẩn Bị Tài Liệu

Nguồn chính là tài liệu TSDoc được xuất ra định dạng Markdown để LLM dễ tiếp cận và xử lý.

Cài Đặt Gói Cần Thiết

npm install --save-dev typedoc typedoc-plugin-markdown

Cấu Hình `typedoc.json`

{
  "$schema": "https://typedoc.org/schema.json",
  "entryPoints": ["./src/index.ts"],
  "plugin": ["typedoc-plugin-markdown"],
  "router": "kind",
  "readme": "none",
  "indexFormat": "table",
  "hidePageHeader": true,
  "hideBreadcrumbs": true,
  "useCodeBlocks": true,
  "preserveLinkText": false
}

🔗 Loại Bỏ Liên Kết Nội Bộ Trong Trang Markdown

Liên kết kiểu [FunctionName](./FunctionName) thường gây nhiễu cho LLMs, nên cần tạo plugin tùy chỉnh:

// @ts-check
import { MarkdownPageEvent } from 'typedoc-plugin-markdown';

export const load = (app) => {
  app.renderer.on(MarkdownPageEvent.END, (page) => {
    page.contents = page.contents
      .replaceAll(/Defined in: \[[^\]]+\]\([^\)]+\)\s*/g, '')
      .replaceAll(/\[(`?)(.+?)\1\]\([^\)]+\)/g, (_match, _quote, label) => `\`${label}\``);
  });
};

⚙️ Cấu Hình Rslib Đóng Gói

// rsbuild.config.ts
import { defineConfig } from '@rslib/core';

export default defineConfig({
  source: {
    tsconfigPath: './tsconfig.build.json',
  },
  lib: [{ format: 'esm' }],
  tools: {
    rspack: {
      module: {
        rules: [
          {
            test: /\.md$/,
            type: 'asset/source',
          },
        ],
      },
    },
  },
});

Thêm định nghĩa để tránh lỗi type với Rspack:

// global.d.ts
/// <reference types="@rspack/core/module" />

🧩 Phần Mềm MCP Server

Khởi Tạo Server

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import packageJson from '../package.json';

const server = new McpServer(
  {
    name: '@praha/byethrow',
    version: packageJson.version,
  },
  {
    instructions: 'Sử dụng server này để lấy tài liệu và ví dụ về @praha/byethrow.',
  }
);

Nạp Tài Liệu

const loadDocument = (key: string) => {
  return import.meta.webpackContext('../docs')(key) as string;
};

Đăng Ký Công Cụ (Tools)

ModuleReference: Tổng quan các module

server.tool(
  'ModuleReference',
  'Trả về tổng quan về @praha/byethrow và các module xuất khẩu.',
  () => ({
    content: [{ type: 'text', text: loadDocument('./modules/Result.md') }],
  })
);

FunctionReference: Tham chiếu và ví dụ hàm

import { z } from 'zod';

server.tool(
  'FunctionReference',
  'Trả về tham chiếu và ví dụ hàm cụ thể.',
  { name: z.string().describe('Tên hàm.') },
  ({ name }) => ({
    content: [{ type: 'text', text: loadDocument(`./functions/Result.${name}.md`) }],
  })
);

TypeReference: Tham chiếu và ví dụ kiểu

server.tool(
  'TypeReference',
  'Trả về tham chiếu và ví dụ kiểu cụ thể.',
  { name: z.string().describe('Tên kiểu dữ liệu.') },
  ({ name }) => ({
    content: [{ type: 'text', text: loadDocument(`./types/Result.${name}.md`) }],
  })
);

Kết Nối Qua stdio

import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

const transport = new StdioServerTransport();
await server.connect(transport);

✅ Kiểm Tra MCP Server Hoạt Động

Thêm cấu hình dưới đây vào settings.json của VSCode:

{
  "mcp": {
    "servers": {
      "my-mcp-server": {
        "type": "stdio",
        "command": "node",
        "args": ["{path-to-mcp}/dist/index.js"]
      }
    }
  }
}

Nếu log hiển thị:

[info] Starting server my-mcp-server
[info] Connection state: starting
[info] Starting server from LocalProcess extension host
[info] Connection state: running
[info] Discovered 3 tools

Chứng tỏ MCP server đã hoạt động bình thường.

🎁 Kho Mã Nguồn Công Khai

Toàn bộ source code và cấu hình MCP server được chia sẻ tại:

https://github.com/praha-inc/byethrow/tree/main/packages/mcp

Bạn có thể clone về và thử tại máy.

Kết Luận

LLMs ngày càng mạnh mẽ nhưng không phải là toàn tri. Giới hạn knowledge cutoff khiến chúng không hiểu rõ về thư viện mới hoặc công nghệ phát triển gần đây. Việc xây dựng các lớp cung cấp ngữ cảnh như MCP giúp giải quyết hạn chế này hiệu quả.

Nếu bạn đang phát triển các thư viện mới hoặc có các công cụ nội bộ, MCP server là giải pháp đáng giá để nâng cao trải nghiệm và tính chính xác khi tích hợp LLM vào quy trình làm việc.

Hãy cân nhắc áp dụng MCP server để phát huy tối đa sức mạnh của các mô hình ngôn ngữ lớn trong dự án của bạn!

Tham Khảo

Model Context Protocol. (2024). https://modelcontextprotocol.io/introduction

TypeDoc Documentation. (2024). https://typedoc.org/

praha/byethrow
Repository. (2024). https://github.com/praha-inc/byethrow

MCP SDK Github. https://github.com/modelcontextprotocol/typescript-sdk

Rslib - Rust TypeScript Bundler. https://rslib.rs/