Chuyển đến nội dung

github / github-mcp-server

GitHub MCP Server

Máy chủ MCP chính thức của GitHub để AI đọc repo, quản lý issue, pull request và theo dõi Actions

GitHub MCP Server là cầu nối chính thức từ GitHub giúp trợ lý AI như Copilot, Claude hay Cursor làm việc với GitHub bằng ngôn ngữ thường: đọc mã và file, tìm kiếm, tạo và cập nhật issue, pull request, xem kết quả GitHub Actions, xem cảnh báo bảo mật. Có bản do GitHub tự chạy (remote) và bản chạy trên máy bạn bằng Docker. Hợp với lập trình viên và người quản lý dự án trên GitHub.

  • 34.501 sao
  • 5.356 fork
  • Go
  • Cập nhật hôm nay
  • MIT (dùng tự do, kể cả thương mại)
Độ khó
Vừa Cần gõ vài lệnh hoặc dùng Docker
Dạng
Plugin / mở rộng
Chạy trên
Docker, Windows, macOS, Linux
Chi phí
Miễn phí hoàn toàn

Trải nghiệm khi dùng GitHub MCP Server

Cách dễ nhất là dùng bản remote do GitHub chạy sẵn: trong VS Code (từ phiên bản 1.101 trở lên), bạn dùng nút cài một chạm trong README hoặc dán khối cấu hình với địa chỉ https://api.githubcopilot.com/mcp/. Lần đầu dùng, trình duyệt mở ra để bạn đăng nhập GitHub qua OAuth, không phải tự tạo token.

Sau khi bật chế độ agent trong khung chat Copilot, bạn hỏi bằng tiếng thường: liệt kê các issue đang mở có nhãn bug, tóm tắt pull request này, hay vì sao workflow build lại fail. AI gọi công cụ của máy chủ MCP để đọc dữ liệu thật rồi trả lời, và nếu bạn cho phép thì có thể tạo issue hoặc bình luận.

Nếu ứng dụng của bạn chưa hỗ trợ máy chủ từ xa, hoặc dùng GitHub Enterprise Server, bạn chạy bản cục bộ bằng Docker (image ghcr.io/github/github-mcp-server) và đăng nhập bằng OAuth hay token cá nhân (PAT). Bạn cũng có thể bật chỉ một số nhóm công cụ để AI không bị rối và không có quyền thừa.

Tính năng nổi bật

Quản lý repo và mã nguồn

Duyệt repo, đọc file, tìm kiếm mã, xem commit để AI hiểu cấu trúc dự án bạn có quyền truy cập.

Issue và pull request

Tạo, cập nhật, phân loại issue và pull request, hỗ trợ xem xét thay đổi mã.

Theo dõi CI/CD

Xem các lần chạy GitHub Actions, phân tích vì sao build lỗi, quản lý bản phát hành.

Phân tích bảo mật

Xem kết quả quét bảo mật và cảnh báo Dependabot để biết dự án có lỗ hổng nào.

Chọn nhóm công cụ, chế độ chỉ đọc

Dùng cờ toolsets để bật đúng nhóm cần thiết; cờ read-only chặn mọi công cụ ghi.

Hai kiểu chạy

Bản remote do GitHub lo hạ tầng và bản cục bộ chạy bằng Docker hoặc chương trình riêng khi cần kiểm soát hơn.

Tận dụng GitHub MCP Server vào việc gì?

Quản lý dự án, trưởng nhóm

Hỏi nhanh về tình trạng dự án

Nhờ AI liệt kê issue, pull request đang chờ, ai đang làm gì thay vì lục từng trang.

Lập trình viên

Trợ giúp review và hiểu mã

Nhờ AI tóm tắt thay đổi của một pull request hoặc tìm chỗ dùng một hàm trong repo.

Lập trình viên, DevOps

Điều tra build bị đỏ

Cho AI xem log GitHub Actions và gợi ý nguyên nhân.

Người duy trì dự án mã nguồn mở

Phân loại issue từ cộng đồng

AI đề xuất nhãn và trả lời mẫu cho issue mới; bạn xem và duyệt trước khi đăng.

Cần chuẩn bị gì?

  • Tài khoản GitHub; muốn truy cập repo riêng tư thì phải có quyền tương ứng.
  • Ứng dụng hỗ trợ MCP: VS Code 1.101 trở lên cho bản remote với OAuth, hoặc Claude Desktop, Claude Code, Cursor, Windsurf...
  • Docker đang chạy nếu dùng bản cục bộ bằng image ghcr.io/github/github-mcp-server.
  • Personal Access Token nếu bạn chọn đăng nhập bằng token thay vì OAuth.

Hướng dẫn cài đặt chi tiết

Cài trên Remote (VS Code)

  1. Cách nhanh nhất: dùng nút Install Server trong README của dự án, hoặc thêm cấu hình sau vào file cấu hình MCP của VS Code (phiên bản 1.101 trở lên). Dùng OAuth nên không cần tạo token.

    JSON
    {
      "servers": {
        "github": {
          "type": "http",
          "url": "https://api.githubcopilot.com/mcp/"
        }
      }
    }
  2. Bật chế độ Agent trong Copilot Chat để máy chủ khởi động, rồi làm theo cửa sổ đăng nhập GitHub.

  3. Nếu ứng dụng khác như Claude, Cursor, Windsurf, xem các hướng dẫn riêng trong thư mục docs/installation-guides của repo.

Cài trên Docker (cục bộ)

  1. Cài Docker và bật lên. Thêm cấu hình sau vào ứng dụng MCP của bạn. Lệnh dùng OAuth và công khai cổng gọi lại cục bộ 8085 để quá trình đăng nhập hoạt động.

    JSON
    {
      "mcp": {
        "servers": {
          "github": {
            "command": "docker",
            "args": [
              "run", "-i", "--rm",
              "-p", "127.0.0.1:8085:8085",
              "-e", "GITHUB_OAUTH_CALLBACK_PORT",
              "ghcr.io/github/github-mcp-server"
            ],
            "env": { "GITHUB_OAUTH_CALLBACK_PORT": "8085" }
          }
        }
      }
    }
  2. Nếu pull image báo lỗi, README gợi ý chạy docker logout ghcr.io để bỏ token hết hạn.

    Terminal
    docker logout ghcr.io

Cài trên Claude Code (token)

  1. Tạo Personal Access Token trên GitHub với quyền tối thiểu cần thiết, lưu vào biến môi trường GITHUB_PAT trên máy, rồi thêm máy chủ vào Claude Code bằng lệnh theo README.

    Terminal
    claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=$GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server
  2. Lệnh trên viết cho bash; trên Windows chạy trong Git Bash hoặc WSL, hoặc xem hướng dẫn riêng cho Claude trong repo.

Dùng thử lần đầu

  1. Cài bằng một trong các cách trên và đăng nhập GitHub khi được hỏi.

  2. Bắt đầu bằng yêu cầu chỉ đọc, ví dụ nhờ AI liệt kê repo hoặc issue đang mở của một dự án bạn có quyền xem.

  3. Hỏi AI tóm tắt một pull request cụ thể hoặc giải thích vì sao một lần chạy GitHub Actions bị lỗi.

  4. Chỉ sau khi tin tưởng, mới cho AI tạo issue hoặc bình luận, và luôn đọc lại trước khi chấp nhận.

Mẹo dùng hay

  • Bật chế độ chỉ đọc (cờ --read-only) khi bạn chỉ cần tra cứu; README ghi chế độ này ưu tiên cao hơn cả khi bạn bật riêng từng công cụ.
  • Chỉ bật các toolsets cần thiết như repos, issues, pull_requests để AI chọn công cụ chính xác và tiết kiệm ngữ cảnh.
  • Với token, cấp quyền tối thiểu, dùng token riêng cho từng dự án và đổi định kỳ; đừng commit token vào repo.
  • Dùng GitHub Enterprise Server thì phải chạy bản cục bộ và đặt GITHUB_HOST theo README.

Lưu ý và hạn chế

  • AI có thể tạo issue, bình luận hay thay đổi dữ liệu thật trên GitHub nếu bạn cho quyền ghi; cẩn thận với repo của tổ chức và công ty.
  • Máy chủ có thể đọc những gì tài khoản hoặc token của bạn xem được, kể cả repo riêng tư; đừng cho AI chạm tới dữ liệu bạn không muốn gửi cho dịch vụ AI.
  • Một số chính sách của tổ chức hoặc Copilot có thể cần bật thì bản remote mới dùng được.

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

Có miễn phí không?

Máy chủ mã nguồn mở theo giấy phép MIT và miễn phí. Chi phí nếu có đến từ ứng dụng AI hoặc gói Copilot bạn dùng cùng.

Bản remote và bản cục bộ khác gì?

Bản remote do GitHub lo hạ tầng nên cài nhanh nhất; bản cục bộ chạy bằng Docker trên máy bạn, dùng khi ứng dụng chưa hỗ trợ máy chủ từ xa hoặc khi dùng GitHub Enterprise Server.

Tôi có cần tạo token không?

Với OAuth thì không. README nói trên github.com bạn có thể đăng nhập bằng trình duyệt, còn token cá nhân là lựa chọn thay thế.

Tải mã nguồn về máy

Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.

Terminal
git clone https://github.com/github/github-mcp-server.git

Repo tương tự nên xem

MCP: nối AI với công cụ92K

MCP Reference Servers

modelcontextprotocol / servers

Bộ máy chủ MCP mẫu chính thức: đọc file, lấy nội dung web, Git, bộ nhớ, giờ giấc cho Claude và các AI khác

VừaNode.jsPythonWindowsmacOS+1
MCP: nối AI với công cụ97,8K

Awesome MCP Servers

punkpeye / awesome-mcp-servers

Danh sách tuyển chọn hàng nghìn máy chủ MCP để cho AI dùng file, trình duyệt, cơ sở dữ liệu, ứng dụng...

DễWeb
AI hỗ trợ lập trình156K

Claude Code

anthropics / claude-code

Trợ lý AI viết code của Anthropic chạy trong Terminal, đọc hiểu dự án, sửa file và xử lý Git bằng lời thường

VừaWindowsmacOSLinux

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: MCP: nối AI với công cụ

MCP: nối AI với công cụ64,9K

Context7

upstash / context7

Đưa tài liệu thư viện mới nhất, đúng phiên bản vào trợ lý AI viết code để hết cảnh AI bịa hàm không tồn tại

VừaNode.jsWindowsmacOSLinux
MCP: nối AI với công cụ57,5K

Chrome DevTools MCP

ChromeDevTools / chrome-devtools-mcp

Cho trợ lý AI điều khiển và soi lỗi trang web trong Chrome thật: hiệu năng, console, mạng, ảnh chụp

VừaNode.jsWindowsmacOSLinux
MCP: nối AI với công cụ39,7K

Playwright MCP

microsoft / playwright-mcp

Cho trợ lý AI như Claude, Copilot, Cursor tự mở trình duyệt, bấm nút, điền form và đọc trang web giúp bạn

VừaNode.jsWindowsmacOSLinux
MCP: nối AI với công cụ34,6K

MCP for Blender (blender-mcp)

ahujasid / mcp-for-blender

Nối Claude hay AI khác vào Blender để dựng cảnh 3D, đổi vật liệu và tải mô hình bằng lời dặn

VừaWindowsmacOSLinuxPython
MCP: nối AI với công cụ31,4K

Serena

oraios / serena

Bộ công cụ MCP cho AI viết code hiểu mã ở mức hàm, lớp như một IDE: tìm, sửa, đổi tên xuyên nhiều file

KhóPythonWindowsmacOSLinux
MCP: nối AI với công cụ28,5K

FastMCP

PrefectHQ / fastmcp

Khung Python để viết MCP server và client nhanh: viết một hàm Python là có công cụ cho AI dùng

KhóPython

Xem cả 12 repo MCP: nối AI với công cụ Về Kho Repo