Google Antigravity MCP 架設

Part 4: GitHub MCP 設定

讓 AI 助手直接管理你的 GitHub 倉庫

✔ 兩種安裝方式 ✔ 擇一即可 ✔ Windows 可用

🔧 選擇你的安裝方式

GitHub MCP 有兩種安裝方式，擇一即可：

🐳 方法一：Antigravity Install

需要 Docker Desktop

在 Antigravity 內操作
需要 GitHub Token
需要安裝 Docker Desktop
Docker 必須啟動中

適合：已經有裝 Docker 的人

📦 方法二：CLI 版（Node.js）

不需要 Docker！

用終端機操作
需要 GitHub Token
需要安裝 Node.js
不需要 Docker

適合：不想裝 Docker 的人

兩種方法都需要 GitHub Token
先學怎麼建立 Token，再選擇安裝方式

🔑 第一步：建立 GitHub Token（兩種方法都要）

1

進入 GitHub Token 頁面

GitHub → Settings → Developer Settings → Personal access tokens → Fine-grained tokens

👉 點此直接前往

2

點擊「Generate new token」

建立一個新的 Fine-grained token

3

填寫 Token 資訊

欄位	填入值
Token name	取一個名字，例如：`MCP-Token`
Expiration	選擇有效期限（建議 90 天或更長）
Repository access	All repositories

🔑 Token 權限設定

4

設定 Permissions（權限）

展開「Repository permissions」，設定以下權限：

權限項目	設定值	用途
Contents	Read and write	讀寫檔案、push/pull
Metadata	Read-only（自動）	讀取 Repo 資訊

如果需要更多功能，可加選：

Issues	Read and write	管理 Issue
Pull requests	Read and write	管理 PR

5

按「Generate token」產生 Token

🔑 複製你的 Token

6

立即複製 Token！

Token 格式類似：

github_pat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

或舊版格式：ghp_xxxxx...

超級重要！
Token 只會顯示這一次！離開頁面就看不到了！
請立即複製並貼到安全的地方保存！

Token 建立完成！
接下來選擇安裝方式：
• 方法一：Antigravity Install（需要 Docker）
• 方法二：CLI 版（需要 Node.js，不用 Docker）

🐳 方法一：Antigravity Install

在 Antigravity 內直接安裝（需要 Docker Desktop）

前置條件
• 已安裝 Docker Desktop
• Docker Desktop 必須啟動中（右下角有鯨魚圖示）

1

確認 Docker Desktop 已啟動

看到右下角有 🐳 鯨魚圖示，且沒有在轉圈圈

2

打開 Antigravity

進入 MCP Servers 設定頁面

🐳 方法一：Antigravity Install（續）

3

找到 GitHub MCP，點擊「Install」

4

貼入你的 GitHub Token

會出現提示：To configure the GitHub MCP server, add the required inputs below.

把剛剛複製的 Token 貼進去

5

按下確認，等待安裝

如果出現 Docker 錯誤？

docker: failed to connect to the docker API...

解決：啟動 Docker Desktop，等鯨魚圖示停止跳動，再按 Refresh

🐳 方法一：安裝成功！

看到 GitHub MCP 的 Tools 列表 = 成功！

📂 list_repositories

列出所有 Repository

📄 create_file

建立新檔案

✏️ update_file

更新檔案

🔀 create_pull_request

建立 PR

方法一完成！
如果成功，可以跳到「AI 可以幫你做什麼」那一頁
如果失敗或不想裝 Docker，請看「方法二：CLI 版」

📦 方法二：CLI 版（Node.js）

不需要 Docker！用 Node.js 啟動 MCP Server

優點
✔ 不需要 Docker
✔ Windows 完全支援
✔ 成功率高
✔ 適合不想裝 Docker 的人

需要安裝
• Node.js（從 nodejs.org 下載 LTS 版）

📦 CLI Step 1：安裝 Node.js

1

下載 Node.js LTS 版本

👉 https://nodejs.org/

選擇 LTS（長期支援版），下載後執行安裝

安裝時記得勾選 Add to PATH

2

測試是否安裝成功

打開終端機（PowerShell 或 CMD），輸入：

node -v
npm -v

預期結果
node -v → 顯示 v20.x.x 或更高
npm -v → 顯示 10.x.x 或更高

📦 CLI Step 2-3：建立資料夾 & 安裝套件

3

建立資料夾

mkdir github-mcp
cd github-mcp

（資料夾名稱可以自訂，建議用英文）

4

安裝 GitHub MCP 套件

npm install -g @modelcontextprotocol/github-mcp

5

檢查是否安裝成功

npx github-mcp --help

看到指令說明 = 安裝成功！

📦 CLI Step 4-5：啟動 Server & 連線

6

啟動 GitHub MCP Server

npx github-mcp start --token="你的Token"

把 你的Token 換成剛剛複製的 GitHub Token

成功會顯示：

GitHub MCP Server running on http://localhost:3000
Loaded tools: listRepos, createFile, updateFile...

7

在 Antigravity 連線

Add MCP Server → Connect to Running Server

欄位	填入值
Host	`localhost`
Port	`3000`

注意！終端機視窗不要關閉，Server 需要持續運行

📦 CLI 版：安裝成功！

看到 Tools 列表 = 成功！

📂 listRepos

列出所有 Repository

📄 createFile

建立新檔案

✏️ updateFile

更新檔案

🗑️ deleteFile

刪除檔案

👤 getUser

取得個人資訊

恭喜！GitHub MCP 設定完成！

🚀 從現在起，AI 可以幫你...

自動 commit

AI 幫你提交程式碼變更

自動 push

AI 幫你推送到遠端倉庫

新增 repo

AI 幫你建立新的 Repository

改 README

AI 幫你編輯說明文件

你的專案都能自動化管理！

❓ 常見問題排解

方法一：Docker 錯誤

docker: failed to connect to the docker API...

解決：啟動 Docker Desktop，等鯨魚圖示停止跳動，按 Refresh

方法二：npm / node 找不到

解決：重新安裝 Node.js，記得勾選「Add to PATH」

Token 無效 / Unauthorized

解決：重新建立 Token，確認有 Contents (Read & Write) 權限

方法二：Port 3000 被佔用

解決：npx github-mcp start --token="xxx" --port=3001

📋 安裝方式總整理

方法	需要	步驟
🐳 方法一：Antigravity Install	Docker Desktop	Install → 貼 Token → 完成
📦 方法二：CLI 版	Node.js	npm install → 啟動 Server → 連線

兩種方法都需要 GitHub Token！
擇一使用即可，效果一樣

GitHub MCP 設定完成！

接下來學習實戰應用與整合

前往 Part 5 →