# modelcontextprotocol/servers: kết nối AI với công cụ — hướng dẫn cài đặt và dùng

> modelcontextprotocol/servers là tập hợp MCP server tham chiếu do nhóm MCP duy trì, giúp ứng dụng AI dùng công cụ và truy cập dữ liệu có kiểm soát. Repo phù hợp để học, thử nghiệm và xây MCP server riêng; cách dùng thường khá đơn giản qua npx hoặc uvx, nhưng đây không phải bộ giải pháp production hoàn chỉnh.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-06-15 · Cập nhật: 2026-11-14
- URL: https://ongt.vn/bai-viet/modelcontextprotocol-servers-ket-noi-ai-voi-cong-cu

modelcontextprotocol/servers là một tập hợp MCP server tham chiếu, giúp mô hình ngôn ngữ kết nối có kiểm soát với công cụ và nguồn dữ liệu bên ngoài. Repo có các server cho tệp, Git, bộ nhớ, lấy nội dung web, múi giờ, thời gian và kiểm thử MCP.

Repo phù hợp với lập trình viên mới học MCP, đội ngũ muốn thử nhanh khả năng kết nối AI với hệ thống nội bộ, hoặc người xây MCP server riêng bằng TypeScript, Python và các SDK chính thức. Điểm đáng giá nhất là bạn có thể chạy server bằng npx hoặc uvx rồi cấu hình vào MCP client như Claude Desktop, thay vì phải tự viết toàn bộ lớp kết nối từ đầu.

Tuy vậy, cần hiểu đúng mục đích. Đây là các triển khai tham chiếu để minh họa tính năng và cách dùng SDK, không phải sản phẩm production đã được bảo vệ cho mọi môi trường. Bạn vẫn phải tự đánh giá quyền truy cập, dữ liệu nhạy cảm và mô hình rủi ro của mình.

```repo
- repo | modelcontextprotocol/servers
- kind | MCP server
- desc | Bộ MCP server tham chiếu giúp AI truy cập tệp, Git, bộ nhớ, dữ liệu web và thời gian theo cách có kiểm soát.
- stars | 92k
- lang | TypeScript
```

## modelcontextprotocol/servers làm được gì

### Cho AI dùng công cụ và dữ liệu bên ngoài

MCP server đóng vai trò cầu nối giữa MCP client và các công cụ hoặc nguồn dữ liệu. Nhờ đó, ứng dụng AI có thể nhận thêm thông tin hoặc thực hiện thao tác theo phạm vi mà bạn cấu hình, thay vì chỉ trả lời từ nội dung đã học.

Repo tập trung vào các reference server do nhóm chỉ đạo MCP duy trì. Nếu bạn chỉ cần tìm danh sách nhiều server cộng đồng, README hướng bạn đến MCP Registry; còn repo này phù hợp hơn cho việc học giao thức, xem cách triển khai và thử các server nền tảng.

### Làm việc với hệ thống tệp

Filesystem server cung cấp các thao tác tệp an toàn với quyền truy cập có thể cấu hình. Bạn truyền vào các thư mục được phép, nhờ đó client chỉ làm việc trong phạm vi đã định.

Cách này hữu ích khi bạn muốn AI đọc tài liệu dự án, tìm một báo cáo trong thư mục làm việc hoặc hỗ trợ sắp xếp tệp. Việc giới hạn thư mục giúp giảm nguy cơ AI truy cập nhầm dữ liệu nằm ngoài phạm vi công việc.

### Đọc và thao tác với kho Git

Git server cung cấp công cụ để đọc, tìm kiếm và thao tác với repository Git. Nhân viên kỹ thuật có thể nhờ AI tìm đoạn mã, xem cấu trúc repository hoặc hỗ trợ phân tích thay đổi trong kho được cấu hình.

Bạn cần đặc biệt chú ý repository nào được cấp quyền. MCP client sẽ khởi chạy server với đường dẫn repository bạn truyền vào, vì vậy nên bắt đầu bằng một kho thử nghiệm hoặc kho có phạm vi dữ liệu phù hợp.

### Lưu bộ nhớ dạng đồ thị tri thức

Memory server cung cấp hệ thống bộ nhớ bền vững dựa trên knowledge graph. Nó phù hợp cho thử nghiệm các quy trình mà AI cần ghi nhớ những thực thể và mối quan hệ giữa chúng qua nhiều lần làm việc.

Ví dụ, bạn có thể lưu quan hệ giữa một dự án, khách hàng, người phụ trách và các quyết định đã ghi nhận. Đây là khả năng để học và thử nghiệm, không nên mặc định xem nó là hệ thống quản trị dữ liệu quan trọng nếu chưa đánh giá bảo mật và độ tin cậy.

### Lấy nội dung web cho AI

Fetch server hỗ trợ lấy và chuyển đổi nội dung web để AI sử dụng hiệu quả hơn. Nó phù hợp khi bạn muốn đưa nội dung từ một trang vào quy trình phân tích mà không phải tự viết lớp tải và chuyển đổi dữ liệu.

Khả năng này vẫn phụ thuộc vào trang đích, mạng và chính sách truy cập của môi trường chạy. Không nên coi Fetch server là công cụ tự động vượt qua mọi giới hạn của website.

### Hỗ trợ suy nghĩ tuần tự, thời gian và múi giờ

Sequential Thinking minh họa cách xây quy trình giải quyết vấn đề động và có tính phản hồi. Time cung cấp khả năng chuyển đổi thời gian và múi giờ. Everything là server tham chiếu để kiểm thử, có prompt, resource và tool.

Các server này hữu ích với lập trình viên muốn xem MCP biểu diễn nhiều loại khả năng khác nhau. Chúng cũng giúp bạn kiểm tra MCP client trước khi kết nối vào hệ thống thật.

### Hỗ trợ hai kiểu transport

Mọi server trong repo đều hỗ trợ stdio. Chỉ Everything hỗ trợ thêm Streamable HTTP. Với stdio, client tự khởi chạy server như một subprocess và giao tiếp qua stdin, stdout; server không mở cổng mạng.

Với Streamable HTTP, server chạy như một dịch vụ HTTP và nhiều client có thể kết nối qua URL. Đây là khác biệt quan trọng khi bạn chuyển từ thử nghiệm trên máy cá nhân sang một kiến trúc có dịch vụ riêng.

## Cần chuẩn bị gì

Bạn cần một máy có thể chạy Node.js và npm để dùng các server TypeScript qua npx. README không nêu phiên bản Node.js cụ thể, nên nếu gặp lỗi tương thích, bạn cần kiểm tra hướng dẫn của từng gói hoặc cấu hình trong repo.

Với Git server và các server Python, bạn cần uvx hoặc pip. README khuyến nghị uvx vì cách thiết lập thuận tiện hơn. Nếu dùng pip, bạn cần Python có thể cài gói và chạy module Python.

Bạn cũng cần một MCP client để dùng server trong công việc thật. Ví dụ được README hướng dẫn là Claude Desktop. Chạy server riêng trong terminal thường chưa đủ, vì server stdio đang chờ client gửi thông điệp qua stdin.

Nếu dùng Filesystem, bạn phải xác định thư mục được phép truy cập. Nếu dùng Git, bạn cần có đường dẫn đến repository muốn làm việc. Các ví dụ trong README không yêu cầu API key cho những server được trình bày ở đây.

Nếu chỉ muốn thử mà chưa cấu hình MCP client, bạn có thể dùng MCP Inspector. Inspector có thể tự khởi chạy một stdio server hoặc kết nối đến URL của Streamable HTTP server.

README không ghi rõ phần cứng tối thiểu. Repo cũng không yêu cầu GPU trong hướng dẫn sử dụng được cung cấp.

```note
Các server trong repo là reference implementations, không phải mặc định đã sẵn sàng cho production. Hãy giới hạn thư mục và repository được cấp quyền, tránh đưa dữ liệu nhạy cảm vào thử nghiệm, và tự đánh giá bảo mật trước khi kết nối hệ thống thật.
```

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

```steps
- Chuẩn bị công cụ | Cài Node.js/npm và uvx hoặc pip theo loại server muốn dùng
- Lấy mã nguồn | Clone repository nếu bạn muốn đọc, sửa hoặc phát triển server
- Chạy server mẫu | Dùng npx cho Memory hoặc uvx/pip cho Git
- Cấu hình MCP client | Thêm command và args vào cấu hình client
- Kiểm tra bằng Inspector | Mở tool và gọi server nếu chưa dùng client
```

### Chuẩn bị môi trường chạy

README không ghi một lệnh cài Node.js, uv hay pip cụ thể. Bạn cần cài những công cụ này theo hệ điều hành của mình trước. Node.js/npm phục vụ các gói TypeScript; uvx hoặc pip phục vụ các gói Python.

README có nhắc tài liệu cài uv/uvx và pip, nhưng không đưa lệnh cài trực tiếp trong nội dung được cung cấp. Vì vậy, không nên tự đoán thêm cờ lệnh hoặc phiên bản. Sau khi cài, hãy kiểm tra công cụ có thể gọi được trong terminal trước khi tiếp tục.

### Clone repository để xem mã nguồn

Nếu muốn đọc cách triển khai, sửa mã nguồn hoặc đóng góp, mở PowerShell hoặc terminal tại thư mục bạn muốn lưu project rồi chạy:

```powershell
git clone https://github.com/modelcontextprotocol/servers.git
cd servers
```

`git clone` tải repository về máy. `cd servers` chuyển terminal vào thư mục dự án. Nếu terminal báo không nhận diện `git`, bạn chưa cài Git hoặc Git chưa được thêm vào PATH.

Việc clone không bắt buộc nếu bạn chỉ muốn chạy các gói đã được phát hành bằng npx hoặc uvx. Repo có `package.json`, `package-lock.json`, `src/`, `scripts/` và cấu hình TypeScript để bạn xem cách phát triển; README không đưa quy trình build hoặc start trực tiếp từ mã nguồn ở phần Getting Started.

### Chạy Memory server bằng npx

README đưa ví dụ chạy Memory server như sau:

```bash
npx -y @modelcontextprotocol/server-memory
```

`npx` tải và chạy package. Cờ `-y` tự xác nhận việc dùng package để bạn không phải trả lời câu hỏi xác nhận trong terminal. Tên package cần giữ chính xác là `@modelcontextprotocol/server-memory`.

Lần đầu chạy có thể mất thời gian tải package. Sau khi chạy, server thường không hiện giao diện cửa sổ riêng. Vì đây là stdio server, nó có thể chỉ hiện thông báo khởi động rồi chờ client. Trạng thái trông như bị đứng thường là hành vi bình thường.

### Chạy Git server bằng uvx hoặc pip

README đưa hai cách chạy Git server:

```bash
# With uvx
uvx mcp-server-git

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

Cách đầu dùng `uvx` để chạy `mcp-server-git`. Cách thứ hai cài package bằng pip rồi chạy module Python `mcp_server_git`.

Để Git server biết repository nào cần làm việc, cấu hình MCP client phải truyền thêm `--repository` và đường dẫn repository. Chỉ chạy lệnh mẫu trong terminal giúp bạn thấy server khởi động, nhưng chưa tạo được trải nghiệm sử dụng thuận tiện nếu chưa nối vào client.

Nếu terminal không nhận `uvx`, hãy kiểm tra lại phần cài uv/uvx. Nếu `pip install` lỗi, kiểm tra Python và quyền cài package. Không tự đổi tên module hoặc package khi chưa có hướng dẫn từ tài liệu tương ứng.

### Cấu hình Memory vào MCP client

README đưa cấu hình cho Claude Desktop như sau:

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

Bạn đặt phần cấu hình này vào nơi MCP client yêu cầu, rồi khởi động lại client nếu client cần. `command` là chương trình client sẽ gọi; `args` là các tham số truyền cho chương trình đó.

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

Lỗi thường gặp ở bước này là đặt sai dấu phẩy, dùng đường dẫn JSON không đúng với MCP client hoặc quên khởi động lại client. Hãy giữ nguyên tên `command`, `args` và package như ví dụ.

### Cấu hình Filesystem, Git và Fetch

README đưa một cấu hình kết hợp ba server:

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

Bạn phải thay `/path/to/allowed/files` bằng thư mục thật được phép cho Filesystem, và thay `path/to/git/repo` bằng repository thật cho Git. Đây là hai giá trị mẫu trong README, không phải đường dẫn có sẵn trên máy bạn.

Trên Windows, chỉ bọc entry Filesystem dùng npx bằng `cmd` và thêm `"/c", "npx"` vào args. Các entry dùng `uvx` giữ nguyên theo README. Không cấp cả ổ đĩa hoặc thư mục chứa dữ liệu ngoài phạm vi công việc nếu chưa hiểu rõ quyền mà server cung cấp.

### Thử bằng MCP Inspector

Để Inspector tự khởi chạy một stdio server, dùng:

```bash
npx @modelcontextprotocol/inspector uvx mcp-server-git
```

Lệnh này không dùng URL. Inspector gọi `uvx mcp-server-git`, sau đó cho bạn xem và gọi các tool của server.

Với Everything chạy bằng Streamable HTTP, README đưa hai lệnh:

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

Lệnh đầu khởi động Everything ở chế độ Streamable HTTP. Lệnh thứ hai kết nối Inspector đến URL `http://localhost:3001/mcp`. Hai lệnh này cần được chạy theo thứ tự phù hợp: server HTTP phải chạy trước khi Inspector kết nối.

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

Cách kiểm tra đơn giản nhất là cấu hình Memory vào MCP client rồi xem client có nhận server `memory` hay không. Nếu server được nhận, các khả năng liên quan đến bộ nhớ sẽ xuất hiện trong giao diện hoặc ngữ cảnh công cụ của client.

Với server stdio, việc terminal không hiện giao diện và có vẻ đứng không phải bằng chứng server hỏng. README nói server đang chờ client gửi thông điệp qua stdin, thường chỉ hiện tối đa một dòng thông báo khởi động và không mở port.

Bạn cũng có thể dùng MCP Inspector để kiểm tra. Với Git, lệnh Inspector phải khởi chạy được `uvx mcp-server-git`, sau đó Inspector cho phép bạn duyệt và gọi tool. Với Everything, mở URL `http://localhost:3001/mcp` trong Inspector; nếu kết nối thành công, bạn có thể xem các tool, resource và prompt tham chiếu.

Nếu cấu hình Filesystem hoặc Git sai đường dẫn, hãy kiểm tra lại giá trị trong `args`. Đường dẫn mẫu trong README chỉ có tính minh họa, không tự động trỏ đến thư mục của bạn.

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

### Chủ shop muốn AI đọc tài liệu vận hành

Một chủ shop có thư mục chứa quy trình đóng gói, bảng hướng dẫn đổi trả và mẫu trả lời khách hàng. Bạn cấu hình Filesystem với đúng thư mục tài liệu được phép, rồi yêu cầu trong MCP client: “Đọc quy trình đổi trả trong thư mục được cấp quyền và tóm tắt thành checklist cho nhân viên mới”.

Kết quả mong đợi là AI dùng các tệp trong phạm vi đã cấu hình để tạo checklist. Cách này hữu ích hơn việc mở toàn bộ máy tính cho AI, vì thư mục được phép đã giới hạn dữ liệu có thể truy cập.

### Nhân viên văn phòng tìm nội dung trong repository

Một nhân viên quản lý tài liệu có một repository Git chứa mẫu biểu và hướng dẫn nội bộ. Bạn cấu hình Git server với `--repository` trỏ đến repository đó, sau đó hỏi: “Tìm các tệp có hướng dẫn xử lý yêu cầu hoàn tiền và tóm tắt điểm cần làm”.

Git server được thiết kế để đọc, tìm kiếm và thao tác với repository Git. Câu trả lời phụ thuộc vào nội dung thật trong repository; server không tự tạo ra chính sách nếu tài liệu không có thông tin đó.

### Lập trình viên mới phân tích một dự án Git

Một lập trình viên mới muốn hiểu dự án trước khi sửa code. Bạn dùng Git server qua MCP client hoặc Inspector và yêu cầu: “Tìm các file cấu hình chính, giải thích vai trò của chúng và chỉ ra nơi bắt đầu chạy dự án”.

AI có thể dùng khả năng đọc và tìm kiếm repository để tạo bản đồ ban đầu. Đây là cách học nhanh cấu trúc dự án, nhưng bạn vẫn nên kiểm tra lại các kết luận bằng mã nguồn và tài liệu chính thức.

### Đội nhóm thử bộ nhớ cho trợ lý nội bộ

Một đội muốn thử trợ lý ghi nhớ quan hệ giữa dự án, khách hàng và người phụ trách. Bạn chạy Memory server rồi yêu cầu: “Lưu rằng dự án A thuộc khách hàng B và người phụ trách là C”, sau đó ở lượt khác hỏi: “Ai phụ trách dự án A?”.

Memory server minh họa bộ nhớ bền vững dựa trên knowledge graph. Trước khi dùng dữ liệu thật, đội nên xác định dữ liệu nào được phép lưu và đánh giá rủi ro bảo mật.

> MCP biến AI từ một hộp trả lời thành trợ lý có thể làm việc với công cụ trong phạm vi bạn cho phép.
>
> — Ông T

### Dev kiểm tra giao thức bằng Inspector

Một lập trình viên đang viết MCP server riêng có thể dùng Everything hoặc Inspector để làm quen với prompt, resource và tool. Với server stdio, truyền command chạy server cho Inspector. Với Everything, chạy Streamable HTTP rồi kết nối Inspector đến URL được README nêu.

Kết quả là bạn có một môi trường thử nghiệm trực quan trước khi tích hợp vào client đầy đủ. Đây là bước phù hợp để phát hiện lỗi transport, tên tool hoặc dữ liệu đầu vào sớm.

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

### Terminal trông như bị treo

Đây thường là hành vi bình thường của stdio server. Server không mở giao diện hay cổng mạng; nó chờ MCP client gửi thông điệp qua stdin.

Hãy cấu hình server vào MCP client hoặc dùng MCP Inspector. Không nên tự kết luận rằng tiến trình lỗi chỉ vì terminal không trả lại dấu nhắc lệnh.

### Windows không chạy được entry dùng npx

README yêu cầu Windows bọc `npx` bằng `cmd /c`. Với Memory, dùng `command` là `cmd` và args bắt đầu bằng `/c`, `npx` như cấu hình đã nêu.

Với Filesystem, áp dụng cùng cách bọc và giữ các tham số package, thư mục ở sau. Các entry dùng `uvx` không cần đổi sang `cmd` theo README.

### Không tìm thấy npx, uvx hoặc pip

Lỗi này thường xuất hiện khi công cụ chưa được cài hoặc terminal chưa nhận PATH mới. Kiểm tra lại Node.js/npm cho server TypeScript, hoặc uvx/pip cho server Python.

README không cung cấp lệnh cài cụ thể, nên hãy dùng hướng dẫn cài chính thức tương ứng thay vì đoán thêm tham số.

### Server không đọc được thư mục hoặc repository

Kiểm tra đường dẫn trong `args`, đặc biệt là `/path/to/allowed/files` và `path/to/git/repo`, vì đây chỉ là giá trị minh họa. Đảm bảo thư mục hoặc repository tồn tại và tài khoản chạy MCP client có quyền đọc.

Nên thử với một thư mục hoặc repository nhỏ trước. Khi lỗi đã rõ, mới mở rộng phạm vi quyền truy cập.

### Inspector không kết nối được Everything

Nếu dùng Streamable HTTP, hãy chạy Everything trước bằng chế độ `streamableHttp`, rồi mới chạy Inspector với `--transport http` và URL `http://localhost:3001/mcp`.

Nếu server chưa chạy hoặc URL không khớp, Inspector không thể kết nối. Cũng cần phân biệt Streamable HTTP với stdio: stdio nhận command, còn HTTP nhận URL.

## Có nên dùng không

Bạn nên dùng repo này nếu muốn học MCP bằng ví dụ có sẵn, thử kết nối AI với tệp và Git, kiểm tra MCP client, hoặc lấy nền tảng để xây server riêng. Bộ server có phạm vi minh họa rõ, hỗ trợ nhiều tình huống cơ bản và có cả stdio lẫn Streamable HTTP cho Everything.

Cách chạy qua npx và uvx khá gọn. Người mới có thể bắt đầu bằng Memory, sau đó thử Filesystem hoặc Git trong một thư mục an toàn. Lập trình viên có thể đọc mã TypeScript, cấu hình package và các thư mục trong repo để hiểu cách tổ chức dự án.

Giới hạn lớn nhất là đây là reference implementations. README cảnh báo chúng nhằm minh họa tính năng và cách dùng SDK, không phải giải pháp production đã bao quát mọi yêu cầu bảo mật. Bạn không nên cấp quyền rộng, đưa dữ liệu nhạy cảm vào thử nghiệm hoặc coi Memory, Filesystem và Git là hệ thống hoàn chỉnh nếu chưa tự kiểm tra.

Nếu bạn chỉ cần tìm server cho một dịch vụ cụ thể, hãy xem MCP Registry hoặc server cộng đồng phù hợp. Nếu cần một hệ thống đã vận hành ổn định cho dữ liệu quan trọng, hãy đánh giá sản phẩm chuyên dụng, cơ chế phân quyền, log, backup và threat model trước khi chọn. README cũng cho biết nhiều server trước đây như GitHub, PostgreSQL, Slack và SQLite đã được chuyển sang kho archived hoặc đơn vị khác duy trì; vì vậy nên kiểm tra trạng thái của server bạn định dùng.

Về giấy phép, phần thông tin được cung cấp ở đầu tư liệu không ghi rõ, còn README nêu đóng góp mới dùng Apache License 2.0 và code hiện có dùng MIT. Nếu bạn định đóng gói hoặc phân phối lại, hãy đọc LICENSE và các điều khoản liên quan trong repo trước khi quyết định.

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

### Repo này có miễn phí không?

Tư liệu không nêu chính sách giá cho repo. README mô tả dự án là mã nguồn mở và nêu giấy phép Apache License 2.0 cho đóng góp mới, còn code hiện có dưới MIT; hãy đọc LICENSE trước khi phân phối lại.

### Có cần GPU để chạy không?

README không nêu yêu cầu GPU và các lệnh mẫu chỉ chạy server bằng npx, uvx hoặc pip. Vì vậy tư liệu hiện có không cho thấy cần GPU.

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

Có hướng dẫn riêng cho Windows khi dùng npx: đặt command là cmd và thêm /c trước npx trong args. Các entry dùng uvx được giữ nguyên theo README.

### Có cần API key không?

Các ví dụ Memory, Git, Filesystem, Fetch, Everything và Inspector trong README không yêu cầu API key. Tư liệu không khẳng định yêu cầu của mọi server hoặc biến thể khác.

### Vì sao chạy server rồi terminal giống như bị treo?

Đó thường là hành vi bình thường của stdio server. Server chờ MCP client gửi thông điệp qua stdin, không mở port; bạn nên cấu hình nó vào client hoặc dùng MCP Inspector.

### Repo này có dùng cho production được không?

README cảnh báo đây là reference implementations để minh họa MCP và SDK, không phải giải pháp production sẵn sàng. Bạn phải tự đánh giá bảo mật, quyền truy cập và threat model trước khi dùng dữ liệu thật.

### Khác gì MCP Registry?

Repo này chứa một số reference server do nhóm MCP duy trì. README hướng người cần danh sách MCP server đến MCP Registry, còn repo hiện tại chủ yếu dành cho ví dụ tham chiếu và học cách triển khai.
