modelcontextprotocol/servers: máy chủ MCP mẫu cho Claude — hướng dẫn cài đặt và dùng
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 →

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.
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.
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
uvxcho 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
npxbằngcmd /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
- Chọn máy chủQuyết định bạn cần khả năng nào: file, Git, web, bộ nhớ…
- Chuẩn bị công cụ chạyCó npx cho máy chủ TypeScript, hoặc uv/uvx cho máy chủ Python
- Thử chạy một máy chủChạy lệnh npx hoặc uvx để xem nó khởi động
- 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
- 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:
npx -y @modelcontextprotocol/server-memoryCờ -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:
# With uvx
uvx mcp-server-gitHoặc dùng pip:
# With pip
pip install mcp-server-git
python -m mcp_server_gitNế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:
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"]
}
}
}Trên Windows, README yêu cầu bọc npx bằng cmd /c:
{
"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:
{
"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/fileslà 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/repocũ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 đầuargs. Các mục dùnguvxgiữ 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ụ:
npx @modelcontextprotocol/inspector uvx mcp-server-gitVớ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:
npx @modelcontextprotocol/server-everything streamableHttp
npx @modelcontextprotocol/inspector --transport http --server-url http://localhost:3001/mcpIV.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:
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:
Đọ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:
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:
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
npxhoặcuvx, 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.
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.


