Cách Sử Dụng Máy Chủ GitHub MCP

Giới thiệu về GitHub MCP và Mục đích của nó

Máy chủ GitHub MCP đại diện cho một bước tiến thú vị trong công cụ phát triển, cung cấp sự tích hợp mượt mà giữa trí tuệ nhân tạo và hệ sinh thái mạnh mẽ của GitHub. Giao thức Ngữ cảnh Mô hình (MCP) là một phương thức tiêu chuẩn hóa cho các Mô hình Ngôn ngữ Lớn (LLMs) để tương tác với các công cụ và nguồn dữ liệu bên ngoài. Máy chủ MCP chính thức của GitHub làm cầu nối này một cách cụ thể cho các kho lưu trữ GitHub, cho phép các trợ lý AI truy cập, tìm kiếm và tương tác với dữ liệu GitHub thông qua một giao diện có cấu trúc.

Trong hướng dẫn này, chúng ta sẽ khám phá cách thiết lập, cấu hình và sử dụng hiệu quả Máy chủ GitHub MCP để nâng cao quy trình phát triển của bạn. Dù bạn muốn tự động hóa các tác vụ lặp đi lặp lại trên GitHub, có cái nhìn sâu sắc hơn về các kho lưu trữ, hay xây dựng các công cụ được hỗ trợ bởi AI tương tác với GitHub, hướng dẫn này sẽ cung cấp cho bạn kiến thức để bắt đầu.

💡

Trước khi bắt đầu thiết lập Máy chủ Github MCP, hãy xem Apidog—một công cụ mạnh mẽ để thiết kế, kiểm tra và tài liệu hóa các API. Apidog cho phép bạn tích hợp các API của mình một cách liền mạch, nâng cao quy trình làm việc của bạn với các mô hình có cấu trúc và dễ dàng cộng tác. Nếu bạn đang tìm cách tăng cường tự động hóa và quản lý API của mình, Apidog là một công cụ đồng hành tuyệt vời để sử dụng cùng với Zapier MCP.

button

Hiểu biết cơ bản về Máy chủ GitHub MCP

Máy chủ GitHub MCP triển khai Giao thức Ngữ cảnh Mô hình để cung cấp một giao diện tiêu chuẩn hóa giữa các mô hình AI và các API của GitHub. Thay vì để các công cụ AI phân tích HTML thô hoặc tương tác với GitHub theo những cách không thể đoán trước, máy chủ MCP cung cấp các công cụ và tài nguyên có cấu trúc mà các trợ lý AI có thể tin cậy sử dụng.

Dưới đây là những gì mà Máy chủ GitHub MCP cho phép:

Thực hiện quy trình làm việc tự động trên GitHub
Rút trích và phân tích dữ liệu kho lưu trữ
Tương tác với vấn đề, yêu cầu kéo và mã
Tích hợp với các trợ lý lập trình AI như GitHub Copilot

Khi một trợ lý AI cần thông tin từ GitHub, nó gửi yêu cầu đến máy chủ MCP, sau đó máy chủ xử lý yêu cầu này và trả về dữ liệu có cấu trúc. Điều này tạo ra một trải nghiệm đáng tin cậy và nhất quán hơn khi làm việc với các công cụ AI cần truy cập tài nguyên GitHub.

Thiết lập Môi trường Máy chủ GitHub MCP của bạn

Trước khi bạn có thể bắt đầu sử dụng Máy chủ GitHub MCP, bạn sẽ cần thiết lập môi trường của mình. Điều kiện tiên quyết chính là Docker, điều này là cần thiết để chạy máy chủ trong một container. Bạn cũng sẽ cần một Mã truy cập cá nhân GitHub (PAT) để xác thực với các API của GitHub.

Tạo Mã truy cập cá nhân GitHub MCP

Đi đến cài đặt tài khoản GitHub của bạn
Đi đến Cài đặt nhà phát triển > Mã truy cập cá nhân > Mã truy cập chi tiết
Nhấp vào "Tạo mã mới"
Đặt tên mô tả cho mã truy cập của bạn
Đặt ngày hết hạn
Chọn các kho lưu trữ mà bạn muốn mã truy cập này truy cập
Chọn các quyền cần thiết dựa trên công cụ GitHub MCP mà bạn sẽ sử dụng
Nhấp vào "Tạo mã" và sao chép nó vào một vị trí an toàn

Nhớ giữ an toàn cho mã truy cập của bạn, vì nó cung cấp quyền truy cập vào tài khoản GitHub của bạn. Các quyền bạn cấp nên được giới hạn trong những gì cần thiết cho trường hợp sử dụng cụ thể của bạn.

Cài đặt Máy chủ GitHub MCP cho Các IDE khác nhau

Thiết lập GitHub MCP cho VS Code

VS Code cung cấp một trong những cách đơn giản nhất để tích hợp với Máy chủ GitHub MCP. Dưới đây là cách thiết lập:

Mở VS Code
Nhấn Ctrl + Shift + P (hoặc Cmd + Shift + P trên macOS)
Gõ "Preferences: Mở Cài đặt người dùng (JSON)"
Thêm cấu hình JSON sau vào tệp cài đặt của bạn:

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "github_token",
        "description": "Mã truy cập cá nhân GitHub",
        "password": true
      }
    ],
    "servers": {
      "github": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "GITHUB_PERSONAL_ACCESS_TOKEN",
          "ghcr.io/github/github-mcp-server"
        ],
        "env": {
          "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
        }
      }
    }
  }
}

Xem xét, bạn có thể tạo một tệp .vscode/mcp.json trong workspace của bạn để chia sẻ cấu hình này với người khác. Trong trường hợp này, bạn không cần khóa cấp cao "mcp".

Triển khai GitHub MCP cho Claude Desktop

Claude Desktop cũng hỗ trợ các máy chủ MCP. Dưới đây là cách cấu hình nó:

Tạo cấu hình sau:

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Thay thế <YOUR_TOKEN> bằng Mã truy cập cá nhân GitHub thực tế của bạn

Máy chủ GitHub MCP cho Người dùng Doanh nghiệp

Nếu bạn đang sử dụng Máy chủ GitHub Doanh nghiệp thay vì github.com, bạn sẽ cần chỉ định tên miền của phiên bản Doanh nghiệp của bạn. Điều này có thể được thực hiện bằng cách sử dụng cờ --gh-host khi chạy máy chủ hoặc bằng cách thiết lập biến môi trường GH_HOST.

Ví dụ, trong cấu hình VS Code của bạn, bạn sẽ sửa đổi mảng "args" để bao gồm:

"args": [
  "run",
  "-i",
  "--rm",
  "-e",
  "GITHUB_PERSONAL_ACCESS_TOKEN",
  "-e",
  "GH_HOST=github.mycompany.com",
  "ghcr.io/github/github-mcp-server"
]

Điều này đảm bảo rằng máy chủ MCP giao tiếp với phiên bản GitHub Doanh nghiệp của bạn thay vì với github.com công khai.

Khám phá Các công cụ Máy chủ GitHub MCP

Máy chủ GitHub MCP cung cấp một bộ công cụ toàn diện được phân loại theo chức năng. Dưới đây là một số loại công cụ chính:

Tổng quan về Công cụ Người dùng GitHub MCP

Các công cụ Người dùng cho phép các trợ lý AI truy xuất thông tin về người dùng GitHub đã xác thực. Công cụ chính là:

get_me: Lấy thông tin chi tiết về người dùng đang xác thực mà không cần bất kỳ tham số nào.

Công cụ Quản lý Vấn đề GitHub MCP

Các công cụ vấn đề cho phép các trợ lý AI tương tác với các vấn đề trên GitHub:

get_issue: Lấy chi tiết vấn đề bằng cách chỉ định chủ sở hữu, kho lưu trữ và số vấn đề
create_issue: Tạo các vấn đề mới với tiêu đề, nội dung, người được giao và nhãn tùy chỉnh
add_issue_comment: Thêm nhận xét vào các vấn đề hiện có
list_issues: Liệt kê và lọc các vấn đề kho lưu trữ với các tiêu chí khác nhau
update_issue: Cập nhật các vấn đề hiện có
search_issues: Tìm kiếm các vấn đề trên toàn bộ GitHub

Quản lý Yêu cầu Kéo GitHub MCP

Các công cụ Yêu cầu Kéo cho phép tương tác với các PR trên GitHub:

get_pull_request: Lấy chi tiết PR
list_pull_requests: Liệt kê và lọc các PR kho lưu trữ
merge_pull_request: Gộp các yêu cầu kéo đang mở
get_pull_request_files: Lấy các tệp đã thay đổi trong một PR
create_pull_request: Tạo các PR mới
update_pull_request_branch: Cập nhật nhánh PR với các thay đổi mới nhất từ cơ sở

Khám phá Công cụ Kho lưu trữ GitHub MCP

Các công cụ kho lưu trữ cung cấp quyền truy cập vào nội dung kho lưu trữ và quản lý:

create_or_update_file: Chỉnh sửa các tệp đơn trong các kho lưu trữ
push_files: Cam kết nhiều thay đổi tệp cùng một lúc
search_repositories: Tìm kiếm các kho lưu trữ trên toàn bộ GitHub
create_repository: Tạo các kho lưu trữ mới
get_file_contents: Lấy nội dung tệp từ các kho lưu trữ
create_branch: Tạo các nhánh mới trong các kho lưu trữ

Tài nguyên GitHub MCP cho Nội dung Kho lưu trữ

Bên cạnh các công cụ, Máy chủ GitHub MCP cung cấp các mẫu tài nguyên cho phép truy cập trực tiếp vào nội dung kho lưu trữ. Những mẫu này tuân theo các định dạng URL cụ thể:

Nội dung Kho lưu trữ Cơ bản: repo://{owner}/{repo}/contents{/path*}
Nội dung Theo Nhánh Cụ thể: repo://{owner}/{repo}/refs/heads/{branch}/contents{/path*}
Nội dung Theo Cam Kết Cụ thể: repo://{owner}/{repo}/sha/{sha}/contents{/path*}
Nội dung Theo Thẻ Cụ thể: repo://{owner}/{repo}/refs/tags/{tag}/contents{/path*}
Nội dung Theo Yêu cầu Kéo Cụ thể: repo://{owner}/{repo}/refs/pull/{prNumber}/head/contents{/path*}

Các tài nguyên này cho phép các trợ lý AI truy cập trực tiếp vào các phiên bản cụ thể của nội dung kho lưu trữ.

Tùy chỉnh Mô tả Máy chủ GitHub MCP

Bạn có thể tùy chỉnh các mô tả của các công cụ GitHub MCP để phù hợp hơn với quy trình làm việc hoặc sở thích ngôn ngữ của bạn. Có hai cách tiếp cận chính:

Sử dụng tệp cấu hình:
Tạo một tệp github-mcp-server-config.json trong cùng thư mục với nhị phân với các mô tả bị ghi đè:

{
  "TOOL_ADD_ISSUE_COMMENT_DESCRIPTION": "mô tả thay thế",
  "TOOL_CREATE_BRANCH_DESCRIPTION": "Tạo nhánh mới trong kho lưu trữ GitHub"
}

Sử dụng biến môi trường:
Thiết lập các biến môi trường với tiền tố GITHUB_MCP_:

export GITHUB_MCP_TOOL_ADD_ISSUE_COMMENT_DESCRIPTION="mô tả thay thế"

Để xuất các bản dịch hiện tại như một điểm khởi đầu, hãy chạy:

./github-mcp-server --export-translations

Xây dựng Máy chủ GitHub MCP từ Mã nguồn

Nếu bạn không muốn sử dụng Docker, bạn có thể xây dựng Máy chủ GitHub MCP từ mã nguồn:

Nhân bản kho lưu trữ: git clone https://github.com/github/github-mcp-server.git
Đi đến thư mục kho lưu trữ: cd github-mcp-server
Sử dụng Go để xây dựng nhị phân trong thư mục cmd/github-mcp-server
Chạy máy chủ bằng github-mcp-server stdio với biến môi trường GITHUB_PERSONAL_ACCESS_TOKEN đã được thiết lập

Kết luận: Tối đa hóa GitHub MCP cho Phát triển

Máy chủ GitHub MCP đại diện cho một bước tiến đáng kể trong việc tích hợp các công cụ AI với hệ sinh thái của GitHub. Bằng cách cung cấp một giao diện tiêu chuẩn hóa thông qua Giao thức Ngữ cảnh Mô hình, nó cho phép các trợ lý AI tương tác với dữ liệu GitHub theo cách có cấu trúc và dễ đoán.

Trong suốt hướng dẫn này, chúng ta đã đề cập đến cách thiết lập và cấu hình Máy chủ GitHub MCP, khám phá các công cụ và tài nguyên khác nhau của nó, và học cách tùy chỉnh nó để đáp ứng nhu cầu cụ thể. Bằng cách tận dụng Máy chủ GitHub MCP trong quy trình phát triển của bạn, bạn có thể tăng cường năng suất, hợp lý hóa các tương tác GitHub và mở khóa những khả năng mới cho các công cụ phát triển được hỗ trợ bởi AI.

Khi AI tiếp tục biến đổi phát triển phần mềm, các công cụ như Máy chủ GitHub MCP sẽ đóng một vai trò ngày càng quan trọng trong việc tạo ra sự tích hợp liền mạch giữa các trợ lý AI và các nền tảng phát triển. Bằng cách thành thạo Máy chủ GitHub MCP ngay bây giờ, bạn đang định vị mình ở vị trí dẫn đầu của giao điểm thú vị này giữa AI và phát triển phần mềm.