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

modelcontextprotocol/servers: bộ MCP server mẫu chính thức 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: bộ MCP server mẫu chính thức cho Claude — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

modelcontextprotocol/servers là kho các MCP server mẫu do nhóm điều hành Model Context Protocol duy trì, gồm Everything, Fetch, Filesystem, Git, Memory, Sequential Thinking và Time. Chúng cho phép một ứng dụng AI (như Claude Desktop) dùng công cụ và dữ liệu ngoài khung chat. Cài khá dễ nếu bạn có Node.js hoặc uv, chỉ cần một đoạn cấu hình JSON, nhưng README nhấn mạnh đây là bản mẫu để học, chưa phải sản phẩm sẵn sàng cho môi trường chính thức.

modelcontextprotocol/servers là một kho mã nguồn chứa các MCP server mẫu, do nhóm điều hành Model Context Protocol (MCP) duy trì. MCP là giao thức mở để một ứng dụng AI kết nối với công cụ và dữ liệu bên ngoài: đọc file trong máy, xem lịch sử Git, tải nội dung một trang web, nhớ thông tin giữa các lần trò chuyện. Mỗi server trong kho là một "cánh tay" nhỏ mà bạn gắn thêm cho AI.

Nếu bạn dùng Claude Desktop hoặc một ứng dụng khác hỗ trợ MCP, kho này là nơi nhanh nhất để thấy MCP hoạt động ra sao. Chủ shop, nhân viên văn phòng có thể cho AI đọc một thư mục tài liệu. Lập trình viên mới có thể xem cách một server được viết rồi tự làm server của mình. Hiện kho có khoảng 91.956 sao và 11.960 fork, nên tài liệu và ví dụ trên mạng rất nhiều.

Điểm đáng giá nhất: lệnh khởi động ngắn, cấu hình chỉ vài dòng JSON. Điểm cần nhớ nhất: chính README ghi rõ các server này là bản tham khảo để học, không phải sản phẩm sẵn sàng cho môi trường chính thức. Bài này giúp bạn cài, thử và dùng chúng đúng cách.

Danh sách tuyển chọn

modelcontextprotocol/servers

Bộ MCP server mẫu chính thức (Filesystem, Git, Fetch, Memory, Time...) giúp AI như Claude đọc file, xem Git, lấy nội dung web và nhớ thông tin.

★ 92kTypeScript
Xem repo trên GitHub

I.Bộ server mẫu này làm được gì

Kho hiện giữ một số ít server tham khảo. Mỗi server làm một việc rõ ràng:

  • Filesystemthao tác file an toàn, có kiểm soát quyền truy cập. Bạn chỉ định thư mục nào AI được đụng tới. Lợi ích: AI đọc được tài liệu thật của bạn mà không phải mở cả máy.
  • Gitđọc, tìm kiếm và thao tác với kho Git. Hợp với lập trình viên muốn AI tóm tắt lịch sử thay đổi hoặc tìm một đoạn code.
  • Fetchlấy nội dung web và chuyển thành dạng gọn để mô hình AI dùng hiệu quả. Bạn khỏi phải copy từng trang dán vào khung chat.
  • Memorybộ nhớ lâu dài dựa trên đồ thị tri thức. AI có thể giữ lại thông tin như sở thích khách hàng hay quy ước làm việc.
  • Sequential Thinkinghỗ trợ giải quyết vấn đề qua chuỗi các bước suy nghĩ, có thể xem xét lại.
  • Timechuyển đổi múi giờ và xử lý thời gian. Hữu ích khi họp với đối tác ở nhiều nước.
  • Everythingserver thử nghiệm có đủ prompt, resource và tool. Nó dùng để học và kiểm thử, ít dùng cho việc hằng ngày.

Ngoài ra README liệt kê nhiều server đã lưu trữ (archived) sang kho riêng tên servers-archived, như GitHub, Google Drive, PostgreSQL, Slack, SQLite. Chúng không còn nằm trong kho chính. Nếu bạn muốn danh sách server đã công bố, README trỏ tới MCP Registry.

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

Theo README, bạn cần:

  • Một MCP client (ứng dụng AI hỗ trợ MCP). README lấy Claude Desktop làm ví dụ. Chạy server riêng lẻ trong terminal thì ít có ích, nên cần client để dùng thật.
  • Node.js (có sẵn lệnh npx) nếu dùng các server viết bằng TypeScript như Memory và Filesystem. README không ghi phiên bản Node cụ thể, nên mình không nêu số phiên bản.
  • uv (có lệnh uvx) hoặc pip nếu dùng các server viết bằng Python như Git và Fetch. README khuyên dùng uvx vì dễ cài và dễ dùng.
  • Windows: README có hướng dẫn riêng, bọc npx bằng cmd /c (xem phần cài đặt).

README không nói cần API key, tài khoản hay phần cứng đặc biệt (như GPU) cho các server này. Riêng client bạn chọn có thể có yêu cầu tài khoản của nó, phần đó mình không có thông tin trong tư liệu.

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

  1. Cài công cụ nềnCài Node.js để có npx, và uv để có uvx
  2. Chạy thử bằng InspectorDùng MCP Inspector để xem server có hoạt động không
  3. Khai báo vào clientDán đoạn cấu hình JSON vào cấu hình MCP của client
  4. Chỉnh cho WindowsBọc npx bằng cmd /c nếu bạn dùng Windows
  5. Khởi động lại và hỏi thửMở lại client rồi nhờ AI dùng server

Các server trong kho này không cài như một phần mềm có giao diện. Client của bạn sẽ tự chạy server mỗi khi cần, dựa vào cấu hình bạn khai báo.

A.Cài công cụ nền (Node.js và uv)

Bạn cần npx cho server TypeScript và uvx cho server Python. README chỉ trang hướng dẫn cài uv và pip chính thức: https://docs.astral.sh/uv/getting-started/installation/ và https://pip.pypa.io/en/stable/installation/. README không ghi cách cài Node.js, bạn cài từ trang chính thức của Node.js.

Sau khi cài, mở terminal mới (PowerShell trên Windows) để máy nhận lệnh. Mở terminal cũ là lỗi hay gặp.

B.Thử chạy một server trong terminal

Theo README, server TypeScript chạy được bằng npx. Ví dụ khởi động server Memory:

Terminal
npx -y @modelcontextprotocol/server-memory

Server Python chạy được bằng uvx hoặc pip. Ví dụ server Git:

Terminal
# With uvx
uvx mcp-server-git

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

Chỗ người mới hay vấp: sau khi chạy, terminal gần như đứng im, chỉ in nhiều nhất một dòng thông báo. Đó là bình thường. Server dùng kiểu kết nối stdio nên đang đợi client gửi tin vào. Nó không mở cổng nào. Bạn bấm Ctrl+C để thoát.

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

Muốn xem server có những công cụ nào mà chưa cần cấu hình client, dùng MCP Inspector. Nó tự chạy server giúp bạn và cho bạn bấm gọi từng công cụ:

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

Lệnh này chạy server Git qua Inspector. Bạn có thể thay phần sau inspector bằng lệnh khởi động của server khác.

D.Khai báo server vào client

Chạy riêng một server không có nhiều ích lợi. Bạn khai báo nó vào client. Đây là cấu hình Claude Desktop theo README, cho server Memory:

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

Bạn có thể khai báo nhiều server trong cùng một khối mcpServers. Ví dụ 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"]
    }
  }
}

Hãy thay /path/to/allowed/files bằng thư mục thật mà bạn cho phép AI truy cập, và path/to/git/repo bằng đường dẫn tới kho Git của bạn. README không nói tệp cấu hình của Claude Desktop nằm ở đâu, nên bạn xem trong phần cài đặt (Settings) của ứng dụng hoặc tài liệu của client.

Server Filesystem chỉ truy cập các thư mục bạn liệt kê. Hãy cho phép đúng thư mục cần dùng, đừng cho cả ổ đĩa. Bản chất các server này là bản mẫu, nên tự cân nhắc yêu cầu bảo mật của bạn trước khi dùng với dữ liệu quan trọng.

E.Chỉnh cho Windows

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"]
    }
  }
}

Với server Filesystem cũng làm tương tự: đổi "command" thành "cmd" và thêm "/c", "npx" vào đầu args. Các mục dùng uvx thì giữ nguyên.

F.Khởi động lại client

Lưu cấu hình, rồi đóng hẳn và mở lại client. README không mô tả bước này chi tiết, nhưng thông thường client chỉ đọc cấu hình khi khởi động. Khi server nhận ra, client sẽ tự chạy nó.

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

Có hai cách, theo tư liệu:

  1. Qua Inspector: chạy lệnh npx @modelcontextprotocol/inspector ... như trên. Nếu mở được giao diện và thấy danh sách công cụ của server, nghĩa là server khởi động được. Bạn thử gọi một công cụ ngay trong đó.
  2. Qua client: sau khi khởi động lại, hỏi AI một việc mà server đó làm được. Ví dụ với server Filesystem, nhờ liệt kê file trong thư mục đã cho phép. Nếu AI trả về đúng nội dung, bạn đã cài xong.

Nếu chạy server trong terminal và thấy nó đứng im thì chưa phải là lỗi, như đã nói ở trên.

Với server Everything, README còn cho cách chạy kiểu Streamable HTTP và kết nối Inspector tới địa chỉ của nó:

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

Đây là cách duy nhất README nêu để server trong kho phục vụ qua HTTP. Các server còn lại chỉ dùng stdio.

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

Lưu ý: các ví dụ dưới đây là câu bạn gõ vào client. Chúng dựa trên chức năng mà README mô tả cho từng server. Kết quả cụ thể phụ thuộc vào client và mô hình AI bạn dùng.

A.Chủ shop nhờ AI đọc thư mục báo giá và đơn hàng

Chị Lan bán đồ gia dụng online, lưu báo giá nhà cung cấp trong một thư mục trên máy. Chị khai báo server Filesystem, chỉ cho phép đúng thư mục đó. Sau đó chị gõ:

text
Đọc các file trong thư mục báo giá và cho mình bảng so sánh giá của từng nhà cung cấp.

AI đọc file qua server Filesystem rồi tổng hợp thành bảng trong khung chat. Chị khỏi phải mở từng file, và AI không đụng tới thư mục nào chị chưa cho phép.

Cho AI đúng một thư mục để làm việc an toàn hơn nhiều so với đưa cả máy.

Ông T

B.Nhân viên văn phòng tóm tắt nhanh một trang web

Anh Minh làm marketing, cần nắm nội dung vài bài viết của đối thủ trước giờ họp. Anh bật server Fetch và gõ:

text
Lấy nội dung trang này và tóm tắt 5 ý chính cho mình: <dán địa chỉ trang>

Server Fetch lấy nội dung web và chuyển thành dạng gọn cho AI xử lý. Anh nhận bản tóm tắt mà không cần copy dán thủ công. Với trang cần đăng nhập, README không nói server xử lý được, nên anh nên kiểm tra thêm.

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

Bạn vừa nhận một dự án cũ, chưa hiểu ai sửa gì. Khai báo server Git trỏ tới thư mục dự án bằng cờ --repository như ở trên, rồi hỏi:

text
Gần đây dự án có những thay đổi gì? Tóm tắt cho mình theo từng nhóm.

Server Git cho AI đọc và tìm kiếm trong kho, nên bạn có câu trả lời bám đúng dữ liệu thật. Server này cũng có thể thao tác với kho, vì vậy hãy cẩn thận với các yêu cầu làm thay đổi, và nên xem lại trước khi đồng ý.

D.Nhờ AI nhớ thông tin giữa các lần làm việc

Bạn quản lý nhiều khách hàng và muốn AI nhớ sở thích từng người. Bật server Memory rồi gõ:

text
Ghi nhớ: khách hàng A thích nhận báo giá qua email, không gọi điện.

Server Memory lưu thông tin theo kiểu đồ thị tri thức. Ở lần trò chuyện sau, bạn nhờ AI gợi lại và nó có thể dùng thông tin đã lưu. Đừng lưu dữ liệu nhạy cảm nếu bạn chưa rõ nơi lưu và cách bảo vệ, vì README không mô tả chi tiết phần này.

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

A.Chạy server trong terminal thấy đứng im

Đây không phải lỗi. Server stdio đợi client gửi tin nên trông như treo. Bấm Ctrl+C thoát, rồi dùng Inspector hoặc cấu hình trong client để thử thật.

B.Lệnh npx hoặc uvx báo không tìm thấy

Nghĩa là Node.js hoặc uv chưa cài, hoặc terminal chưa nhận. Cài công cụ còn thiếu, rồi đóng và mở lại terminal. Nếu client không thấy lệnh dù terminal đã thấy, hãy mở lại cả client.

C.Trên Windows, server npx không lên

Rất hay gặp. Hãy đổi cấu hình theo hướng dẫn của README: đặt "command" là "cmd" và thêm "/c", "npx" vào đầu args. Các mục dùng uvx thì giữ nguyên.

D.Filesystem không đọc được file

Thường do đường dẫn trong cấu hình sai, hoặc file nằm ngoài thư mục đã cho phép. Kiểm tra lại đường dẫn thư mục và chắc rằng file nằm bên trong. Đừng vội mở rộng quyền ra cả ổ đĩa để chữa lỗi.

E.Sửa cấu hình xong mà client không đổi

Thông thường client chỉ đọc cấu hình lúc khởi động. Hãy đóng hẳn client rồi mở lại. Nếu vẫn lỗi, thử chạy cùng lệnh đó qua Inspector để biết lỗi nằm ở server hay ở cấu hình. Cũng kiểm tra dấu phẩy và ngoặc trong JSON, vì thiếu một dấu là cả tệp hỏng.

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

Điểm mạnh: đây là kho chính thức của hệ sinh thái MCP, có nhiều người dùng và tài liệu. Lệnh khởi động ngắn, cấu hình vài dòng JSON, không thấy README đòi API key hay GPU. Nó là nơi rất tốt để hiểu MCP làm việc ra sao, và để học cách tự viết server.

Giới hạn: README nói rõ các server nà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. Mỗi server chỉ phục vụ qua stdio (trừ Everything còn có HTTP), nên chạy dùng chung cho nhiều người không phải mục tiêu. Nhiều server phổ biến như GitHub, Slack, PostgreSQL đã được chuyển sang kho lưu trữ. Về giấy phép, README ghi giấy phép Apache 2.0 cho đóng góp mới, phần code cũ giữ MIT; chi tiết xem tệp LICENSE.

Khi nào chọn cách khác: nếu bạn cần một server cho công việc thật với dữ liệu quan trọng, hãy xem MCP Registry mà README gợi ý để tìm server do nhà cung cấp duy trì, và tự đánh giá bảo mật. Nếu chỉ muốn học và thử, kho này là lựa chọn hợp lý.

4.0/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 không nói về giá, và không nhắc yêu cầu trả phí để chạy các server trong kho. Về giấy phép, README ghi Apache 2.0 cho đóng góp mới, code cũ theo MIT. Client AI bạn dùng có thể có chi phí riêng, phần đó chưa có trong tư liệu.

Cài các server này có cần GPU hoặc API key không?

README không nhắc GPU hay API key cho các server trong kho. Bạn chỉ cần công cụ chạy lệnh như npx hoặc uvx và một MCP client. Các server đã lưu trữ (như Brave Search, Google Maps) có thể cần key riêng, nhưng tư liệu không nói chi tiết.

Có chạy trên Windows được không?

Có hướng dẫn riêng cho Windows. Với server dùng npx, bạn đặt command là cmd và thêm /c, npx vào đầu args. Với server dùng uvx thì giữ nguyên cấu hình.

Chạy lệnh xong terminal đứng im, có phải bị treo không?

Không. Theo README, server stdio không mở cổng, chỉ in nhiều nhất một dòng thông báo rồi đợi client gửi tin. Bạn không cần tự chạy server như vậy, vì client sẽ khởi động nó từ cấu hình.

Làm sao thử server mà chưa cấu hình client?

Dùng MCP Inspector. Ví dụ lệnh npx @modelcontextprotocol/inspector uvx mcp-server-git sẽ chạy server Git và cho bạn duyệt, gọi thử các công cụ của nó.

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 để học, người dùng tự đánh giá yêu cầu bảo mật và thêm biện pháp bảo vệ. Server Filesystem có kiểm soát quyền truy cập theo thư mục bạn cho phép. Tư liệu chưa có thêm thông tin về nơi lưu dữ liệu của từng server.

Các server này khác gì danh sách MCP server trên MCP Registry?

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

Chuyển nhanh tới mục

  1. I.Bộ server mẫu 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.Cài công cụ nền (Node.js và uv)
    2. B.Thử chạy một server trong terminal
    3. C.Thử bằng MCP Inspector (không cần client)
    4. D.Khai báo server vào client
    5. E.Chỉnh cho Windows
    6. F.Khởi động lại client
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop nhờ AI đọc thư mục báo giá và đơn hàng
    2. B.Nhân viên văn phòng 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 kho Git
    4. D.Nhờ AI nhớ thông tin giữa các lần làm việc
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Chạy server trong terminal thấy đứng im
    2. B.Lệnh npx hoặc uvx báo không tìm thấy
    3. C.Trên Windows, server npx không lên
    4. D.Filesystem không đọc được file
    5. E.Sửa cấu hình xong mà client không đổi
  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ỏ.