Bỏ qua tới nội dung
Ông T.vn

modelcontextprotocol/servers: máy chủ MCP mẫu cho Claude — hướng dẫn cài đặt và dùng

10 phút đọcCập nhật

Bài này là một góc nhìn khác về modelcontextprotocol/servers — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: modelcontextprotocol/servers: kết nối AI với công cụ — hướng dẫn cài đặt và dùng →

modelcontextprotocol/servers: máy chủ MCP mẫu cho Claude — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

modelcontextprotocol/servers là kho các máy chủ MCP mẫu do nhóm điều hành Model Context Protocol duy trì. Mỗi máy chủ cho một ứng dụng AI (như Claude Desktop) thêm một khả năng: đọc file, lấy nội dung web, thao tác Git, ghi nhớ, xem giờ. Cài không khó, chỉ cần chạy một lệnh npx hoặc uvx rồi khai báo vào ứng dụng AI. Tuy vậy repo tự nhận chỉ là bản tham khảo, chưa phải sản phẩm dùng cho môi trường chính thức.

modelcontextprotocol/servers là bộ sưu tập các máy chủ MCP mẫu (reference servers). MCP là Model Context Protocol, một chuẩn mở để ứng dụng AI kết nối với công cụ và dữ liệu bên ngoài. Mỗi máy chủ trong repo cho AI thêm một "đôi tay": đọc file trong thư mục, lấy nội dung trang web, đọc kho Git, nhớ thông tin giữa các cuộc trò chuyện, hoặc đổi múi giờ.

Nếu bạn dùng Claude Desktop hay một ứng dụng AI hỗ trợ MCP và muốn AI làm được nhiều hơn là chỉ trò chuyện, repo này là nơi bắt đầu hợp lý. Lập trình viên mới cũng nên đọc, vì đây là các ví dụ chính thức về cách viết một máy chủ MCP. Hiện repo có khoảng 91.956 sao và 11.960 fork.

Điểm đáng giá nhất là mỗi máy chủ chạy được chỉ bằng một dòng lệnh. Điểm cần nhớ nhất là tác giả ghi rõ đây là bản tham khảo mang tính giáo dục, không phải giải pháp sẵn sàng cho môi trường chính thức. Bạn cần tự cân nhắc yêu cầu bảo mật của mình trước khi dùng cho dữ liệu quan trọng.

Danh sách tuyển chọn

modelcontextprotocol/servers

Bộ máy chủ MCP mẫu chính thức (Filesystem, Git, Fetch, Memory, Time…) giúp AI đọc file, xem web, nhớ thông tin; chủ yếu để học và thử nghiệm.

★ 92kTypeScript
Xem repo trên GitHub

I.Repo này làm được gì

README liệt kê 7 máy chủ tham khảo đang được duy trì trong repo:

  • Everythingmáy chủ mẫu và máy chủ thử nghiệm, có đủ prompt, resource và tool. Nó hữu ích khi bạn muốn xem một máy chủ MCP "đầy đủ đồ nghề" trông như thế nào. Đây cũng là máy chủ duy nhất trong repo chạy được qua Streamable HTTP, ngoài stdio.
  • Fetchlấy nội dung trang web và chuyển thành dạng gọn để AI đọc hiệu quả. Bạn có thể dán một đường dẫn rồi nhờ AI tóm tắt thay vì tự copy nội dung.
  • Filesystemthao tác file an toàn, có cấu hình quyền truy cập. AI chỉ được động vào những thư mục bạn cho phép.
  • Gitcác công cụ để đọc, tìm kiếm và thao tác trên kho Git. Nó hợp với việc hỏi AI về lịch sử thay đổi của một dự án.
  • Memorybộ nhớ lâu dài dựa trên đồ thị tri thức, để AI nhớ thông tin giữa các lần dùng.
  • Sequential Thinkinggiải quyết vấn đề theo chuỗi các bước suy nghĩ, có thể xem xét lại.
  • Timexem giờ và đổi múi giờ.

Ngoài ra README còn nhắc tới một nhóm máy chủ đã lưu trữ (archived) như GitHub, PostgreSQL, Google Drive, Slack, SQLite… Chúng được chuyển sang kho riêng tên servers-archived. Nếu bạn cần một danh sách máy chủ MCP rộng hơn, README hướng tới MCP Registry thay vì repo này.

II.Cần chuẩn bị gì

Theo README, bạn cần:

  • Một ứng dụng MCP client. Chạy máy chủ riêng lẻ không có nhiều tác dụng, nên bạn cần một client để cấu hình máy chủ vào. README lấy Claude Desktop làm ví dụ.
  • npx để chạy các máy chủ viết bằng TypeScript (ví dụ Memory, Filesystem). README không ghi phiên bản Node.js cụ thể.
  • uv / uvx (hoặc pip) để chạy các máy chủ viết bằng Python (ví dụ Git, Fetch). README khuyên dùng uvx cho dễ cài. Hướng dẫn cài uv nằm ở trang docs.astral.sh/uv/getting-started/installation, còn pip ở pip.pypa.io/en/stable/installation.
  • Windows: README có cấu hình riêng, bọc npx bằng cmd /c (xem phần cài đặt).

README không nhắc tới API key hay phần cứng đặc biệt cho các máy chủ ở trên.

III.Cài đặt từng bước

  1. Chọn máy chủQuyết định bạn cần khả năng nào: file, Git, web, bộ nhớ…
  2. Chuẩn bị công cụ chạyCó npx cho máy chủ TypeScript, hoặc uv/uvx cho máy chủ Python
  3. Thử chạy một máy chủChạy lệnh npx hoặc uvx để xem nó khởi động
  4. Khai báo vào ứng dụng AIThêm đoạn cấu hình JSON vào mục mcpServers của client
  5. Thử bằng MCP InspectorDuyệt và gọi thử công cụ mà không cần client

A.Chọn máy chủ cần dùng

Bạn không cài cả repo. Mỗi máy chủ là một gói riêng. README cho biết hai tên gói rõ ràng: @modelcontextprotocol/server-memory (TypeScript, chạy bằng npx) và mcp-server-git (Python, chạy bằng uvx). Với Filesystem và Fetch, cấu hình mẫu trong README dùng @modelcontextprotocol/server-filesystem và mcp-server-fetch.

B.Chạy thử một máy chủ TypeScript

Mở terminal (PowerShell hoặc Command Prompt trên Windows, Terminal trên macOS) rồi chạy máy chủ Memory:

Terminal
npx -y @modelcontextprotocol/server-memory

Cờ -y cho npx tự đồng ý tải gói về. Lệnh này không mở cửa sổ hay cổng mạng nào, và nhìn bề ngoài như bị treo. Đó là bình thường, vì máy chủ đang chờ client gửi tin nhắn tới. Bạn nhấn Ctrl+C để dừng.

C.Chạy thử một máy chủ Python

Với máy chủ Git, README đưa ra hai cách. Cách khuyên dùng:

Terminal
# With uvx
uvx mcp-server-git

Hoặc dùng pip:

Terminal
# With pip
pip install mcp-server-git
python -m mcp_server_git

Nếu máy báo không có uvx, bạn cần cài uv trước theo link hướng dẫn ở trên.

D.Khai báo vào ứng dụng AI

Đây là bước thật sự đưa máy chủ vào sử dụng. Bạn không tự chạy máy chủ, mà để ứng dụng AI khởi động nó theo cấu hình. Ví dụ cấu hình Claude Desktop cho máy chủ Memory:

JSON
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

Trên Windows, README yêu cầu bọc npx bằng cmd /c:

JSON
{
  "mcpServers": {
    "memory": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

Bạn có thể khai báo nhiều máy chủ cùng lúc. Ví dụ README cho Filesystem, Git và Fetch:

JSON
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
    },
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "path/to/git/repo"]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

Chỗ người mới hay vấp:

  • /path/to/allowed/files là chỗ giữ chỗ. Bạn thay bằng đường dẫn thư mục thật mà bạn muốn AI được phép truy cập.
  • path/to/git/repo cũng vậy, thay bằng đường dẫn tới kho Git của bạn.
  • Trên Windows, với mục filesystem (dùng npx), bạn đổi "command" thành "cmd" và thêm "/c", "npx" vào đầu args. Các mục dùng uvx giữ nguyên.
  • README chỉ nói đây là cấu hình Claude Desktop, không ghi vị trí file cấu hình. Nếu bạn chưa biết mở ở đâu, hãy xem phần cài đặt MCP trong tài liệu của ứng dụng bạn dùng, hoặc trên modelcontextprotocol.io.

Máy chủ Filesystem cho AI đọc và ghi file trong thư mục bạn khai báo. Chỉ cấp những thư mục thật sự cần, đừng cấp cả ổ đĩa hay thư mục chứa mật khẩu, hồ sơ nhạy cảm. Repo cũng nhấn mạnh đây là bản tham khảo, chưa phải sản phẩm đã được kiểm chứng cho môi trường chính thức.

E.Thử bằng MCP Inspector (không cần client)

Nếu chưa muốn đụng vào file cấu hình, README gợi ý dùng MCP Inspector. Nó tự chạy máy chủ giúp bạn rồi cho bạn xem và gọi thử các công cụ:

Terminal
npx @modelcontextprotocol/inspector uvx mcp-server-git

Với máy chủ chạy qua HTTP (chỉ Everything hỗ trợ), bạn khởi động nó trước rồi mới kết nối:

Terminal
npx @modelcontextprotocol/server-everything streamableHttp
npx @modelcontextprotocol/inspector --transport http --server-url http://localhost:3001/mcp

IV.Kiểm tra đã chạy được chưa

Có hai cách để biết bạn cài đúng.

Cách 1: Inspector. Chạy lệnh Inspector ở trên. Nếu máy chủ hoạt động, bạn sẽ thấy danh sách công cụ của nó và có thể bấm gọi thử. Đây là cách nhanh nhất để tách lỗi "máy chủ hỏng" khỏi lỗi "cấu hình client sai".

Cách 2: Trong ứng dụng AI. Sau khi lưu cấu hình, bạn khởi động lại ứng dụng (README không nói bắt buộc phải khởi động lại, nhưng nhiều client chỉ đọc cấu hình lúc mở). Nếu ứng dụng hiển thị công cụ của máy chủ và AI gọi được, bạn đã xong. README không mô tả giao diện cụ thể, nên bạn cần xem tài liệu của client để biết nó hiện danh sách công cụ ở đâu.

Nhớ rằng khi chạy máy chủ stdio trực tiếp trong terminal, việc nó "đứng im" là dấu hiệu bình thường, không phải lỗi.

V.Dùng vào việc thật

Các ví dụ dưới đây bám đúng khả năng được README mô tả. Câu lệnh mẫu là gợi ý của mình, bạn chỉnh theo nhu cầu.

A.Nhân viên văn phòng nhờ AI đọc tài liệu trong một thư mục

Bạn có thư mục báo cáo cần rà soát. Hãy khai báo máy chủ Filesystem chỉ trỏ vào đúng thư mục đó, như cấu hình ở phần cài đặt. Sau đó bạn hỏi:

text
Hãy liệt kê các file trong thư mục được cấp quyền và cho mình biết file nào có tên liên quan đến doanh thu.

Kết quả: AI xem được thư mục bạn cho phép và trả lời dựa trên đó, không cần bạn kéo thả từng file vào khung chat.

Máy chủ MCP chỉ có ích khi một ứng dụng AI khởi động nó, và an toàn nhất khi bạn chỉ mở đúng thư mục cần dùng.

Ông T

B.Chủ shop muốn tóm tắt nhanh một trang web

Bạn thấy một bài viết dài về thị trường hoặc đối thủ và chưa có thời gian đọc. Với máy chủ Fetch (uvx mcp-server-fetch), bạn gửi đường dẫn và hỏi:

text
Đọc trang này và tóm tắt cho mình 5 ý chính: <dán đường dẫn>

Kết quả: máy chủ lấy nội dung trang và chuyển thành dạng gọn để AI đọc, rồi AI trả lời tóm tắt. README mô tả Fetch là công cụ "lấy và chuyển đổi nội dung web để dùng hiệu quả với LLM".

C.Lập trình viên mới hỏi về lịch sử một dự án

Bạn vừa nhận một dự án và chưa hiểu nó đã thay đổi thế nào. Khai báo máy chủ Git với --repository trỏ tới thư mục dự án, rồi hỏi:

text
Cho mình xem các thay đổi gần đây của kho Git này và giải thích ngắn gọn từng thay đổi.

Kết quả: AI dùng các công cụ đọc và tìm kiếm Git để trả lời. Bạn tiết kiệm thời gian so với việc tự gõ lệnh Git và đọc từng dòng.

D.Người làm việc với nhiều múi giờ

Bạn họp với đối tác ở nước khác và hay nhầm giờ. Với máy chủ Time, bạn hỏi:

text
Nếu 9 giờ sáng ở Hà Nội thì lúc đó là mấy giờ ở London?

Kết quả: AI dùng công cụ đổi múi giờ thay vì tự đoán. Máy chủ này làm đúng việc README mô tả là "giờ và đổi múi giờ".

Bạn cũng có thể thêm Memory để AI nhớ thông tin giữa các lần trò chuyện (như thói quen làm việc hay tên khách hàng thường gặp). README mô tả đây là hệ thống bộ nhớ dựa trên đồ thị tri thức. Vì nó lưu thông tin về bạn, hãy tránh bảo AI nhớ dữ liệu nhạy cảm.

VI.Lỗi hay gặp và cách xử lý

Máy chủ chạy xong cứ đứng im. Đây không phải lỗi. Máy chủ stdio chờ client gửi tin nhắn, nên không in gì và không mở cổng. Hãy cấu hình nó vào client, hoặc dùng Inspector để thử.

Trên Windows, client không khởi động được máy chủ npx. Hãy dùng dạng bọc cmd /c mà README hướng dẫn: "command": "cmd" và "args": ["/c", "npx", "-y", ...]. Các mục dùng uvx thì không cần đổi.

Báo không tìm thấy lệnh uvx (hoặc npx). Bạn chưa cài công cụ tương ứng. Cài uv theo link trong README cho uvx. Với npx thì cần có Node.js. README không ghi cách cài Node.js, nên bạn xem trang chủ Node.js.

AI không truy cập được thư mục hoặc kho Git. Kiểm tra bạn đã thay /path/to/allowed/files hoặc path/to/git/repo bằng đường dẫn thật chưa. Filesystem chỉ cho phép đúng các thư mục được khai báo, nên một đường dẫn sai nghĩa là AI không thấy gì.

Sửa cấu hình rồi mà ứng dụng vẫn như cũ. README không nói rõ cách nạp lại cấu hình. Hãy thử đóng hẳn rồi mở lại ứng dụng, và kiểm tra file JSON có bị thiếu dấu phẩy hoặc ngoặc không.

VII.Có nên dùng không

Điểm mạnh:

  • Do chính nhóm duy trì MCP làm, nên là mẫu tham khảo đáng tin để học cách một máy chủ MCP hoạt động.
  • Cài nhẹ: một lệnh npx hoặc uvx, cùng vài dòng JSON để khai báo.
  • Phủ các nhu cầu cơ bản: file, Git, web, bộ nhớ, thời gian.
  • Có MCP Inspector để thử nhanh mà không cần ứng dụng AI.

Giới hạn:

  • README ghi thẳng đây là bản tham khảo giáo dục, không phải giải pháp sẵn sàng cho môi trường chính thức. Bạn phải tự cân nhắc rủi ro bảo mật.
  • Mọi máy chủ trong repo chạy qua stdio, và chỉ Everything còn hỗ trợ Streamable HTTP. Nếu bạn cần một dịch vụ chạy riêng cho nhiều người dùng chung, repo không đáp ứng sẵn.
  • Nhiều máy chủ phổ biến (GitHub, PostgreSQL, Google Drive, Slack…) đã chuyển sang kho lưu trữ. Nếu cần chúng, bạn nên tìm trên MCP Registry mà README gợi ý.
  • Thông tin giấy phép: README ghi Apache 2.0 cho đóng góp mới, còn mã hiện có theo MIT. Nếu dùng cho mục đích thương mại, bạn nên đọc file LICENSE.

Tóm lại, repo hợp với người muốn làm quen với MCP, thử nghiệm trên dữ liệu không nhạy cảm, hoặc học cách viết máy chủ riêng. Nếu bạn cần công cụ chạy ổn định cho doanh nghiệp, hãy tìm máy chủ do nhà cung cấp dịch vụ duy trì và tự đánh giá bảo mật trước.

4.7/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

modelcontextprotocol/servers có miễn phí không?

README nói dự án theo giấy phép Apache 2.0 cho đóng góp mới và MIT cho mã hiện có, nên bạn dùng mã nguồn được mà không phải trả tiền cho repo. README không đề cập chi phí của ứng dụng AI hay dịch vụ bạn kết nối cùng. Phần đó bạn cần xem riêng ở nhà cung cấp.

Repo này có cần GPU không?

README không nhắc tới yêu cầu GPU hay phần cứng đặc biệt nào. Các máy chủ chỉ là chương trình nhỏ chạy bằng npx hoặc uvx, còn mô hình AI nằm ở ứng dụng client bạn dùng.

Chạy được trên Windows không?

Được, README có hướng dẫn riêng cho Windows. Với máy chủ chạy bằng npx, bạn bọc lệnh bằng cmd /c trong cấu hình. Các mục dùng uvx thì để nguyên.

Chạy máy chủ xong thấy đứng im, có phải bị lỗi không?

Không phải lỗi. Máy chủ stdio không mở cổng mạng, và chỉ chờ client gửi tin nhắn qua stdin. Bạn nên để client khởi động nó từ cấu hình, hoặc dùng MCP Inspector để thử.

Dữ liệu của tôi có an toàn không?

README cảnh báo đây là bản tham khảo, không phải giải pháp sẵn sàng cho môi trường chính thức, và khuyên bạn tự đánh giá yêu cầu bảo mật. Với Filesystem, AI chỉ truy cập các thư mục bạn khai báo, nên hãy cấp quyền thật hạn chế. README không có thông tin chi tiết hơn về việc dữ liệu được xử lý thế nào.

Repo này khác gì MCP Registry?

Theo README, repo này chỉ chứa một số ít máy chủ tham khảo do nhóm điều hành MCP duy trì. Nếu bạn cần danh sách máy chủ MCP đã được công bố, README hướng bạn tới MCP Registry.

Máy chủ GitHub hay PostgreSQL còn trong repo này không?

Không. README ghi nhiều máy chủ như GitHub, PostgreSQL, Google Drive, Slack, SQLite đã được lưu trữ sang kho servers-archived. Một số cái đã có bản thay thế do bên khác duy trì, ví dụ Brave Search có máy chủ chính thức riêng.

Chuyển nhanh tới mục

  1. I.Repo này làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Chọn máy chủ cần dùng
    2. B.Chạy thử một máy chủ TypeScript
    3. C.Chạy thử một máy chủ Python
    4. D.Khai báo vào ứng dụng AI
    5. E.Thử bằng MCP Inspector (không cần client)
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Nhân viên văn phòng nhờ AI đọc tài liệu trong một thư mục
    2. B.Chủ shop muốn tóm tắt nhanh một trang web
    3. C.Lập trình viên mới hỏi về lịch sử một dự án
    4. D.Người làm việc với nhiều múi giờ
  6. VI.Lỗi hay gặp và cách xử lý
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.