我怎麼在 Cursor 裡直接管 GitHub,不開瀏覽器
我寫程式時最討厭切到瀏覽器查 GitHub issues、看 PR review、找另一個 repo 的程式碼。現在我在 Cursor 裡直接說「找 repo 裡所有用到 OAuth 的檔案」「把這個 bug 開成 issue」,不用離開編輯器。
這篇你會學到
- 在 Cursor 裡直接搜尋 GitHub repo 的程式碼
- 不離開編輯器就能開 issue、查 PR
- 搜尋 vs 讀檔的差別,什麼時候用哪個
- GitHub API 回傳筆數限制的解法
我的流程
寫程式到一半需要查東西時,直接在 Cursor chat 裡說。
你可以直接複製這段:
搜尋 GitHub repo [owner/repo] 裡所有用到 error handling 的檔案,列出檔名和相關程式碼片段。
或者發現 bug 時,你可以直接複製這段:
我剛剛發現 auth middleware 沒有檢查 token 過期。幫我在 GitHub 開一個 issue,標題「修復 auth middleware 未檢查 token 過期」,描述裡貼上相關的程式碼片段。
關鍵細節
搜程式碼用 search_code 不用 get_file。 get_file 需要你知道確切檔名,但很多時候你不知道 bug 在哪個檔。search_code 可以搜關鍵字找到相關檔案。
開 issue 時讓 AI 自己組織描述。 不要只說「開 issue」,說「開 issue,描述裡包含相關的程式碼、影響範圍、建議修法」。AI 因為剛剛看過程式碼,能寫出比你手動寫更完整的 issue。
💡 GitHub API 預設只回 30 筆。 如果你的 repo 有 50+ 個 open issues,AI 只看到前 30 個。在 prompt 裡加 per_page: 100 就能拿到更多。
我踩過的坑
⚠️ 已棄用的 npm 套件。 @modelcontextprotocol/server-github 已於 2025 年 4 月棄用。很多教學文章還在推薦它。請用官方 Docker image ghcr.io/github/github-mcp-server。
⚠️ 不同 branch 的檔案讀取。 預設讀主分支。如果你想看某個 feature branch,要在 prompt 裡指定,否則 AI 會拿到舊版程式碼。
工具設定
Cursor 裡加 GitHub MCP server:在 .cursor/mcp.json 加入 GitHub 官方 server 設定。
如果你同時需要 Notion、Gmail 等其他工具,到 OctoDock 用一個 MCP URL 連接所有 App,不用一個一個設定。