大家好,我希望 Cursor 雲端代理能夠處理從未接觸 GitHub 的程式碼,因此我開發了 cursor-private-git。這是一個免費、開源(GPL-3.0 授權)的工具包,讓雲端代理可以在您自己的 Forgejo 伺服器上執行複製(clone)、建立分支(branch)、推送(push)等操作,並處理議題(issues)和拉取請求(PRs)。
這個工具包會在您的機器上執行 Forgejo,並透過 Cloudflare Tunnel 將其公開,因此您無需開啟任何連接埠。它還透過 Cloudflare Access 進行鎖定,確保只有持有服務令牌的代理才能存取。
此外,它為 Cursor 環境新增了安裝和啟動腳本,讓每個新的雲端代理在啟動時都能自動設定 Git 驗證。它包含一個 Forgejo MCP 伺服器,為代理提供了 22 種工具,用於處理儲存庫、分支、議題和拉取請求。整個過程無需任何 root 或 sudo 權限,也不需要使用 GitHub Actions。
我驗證了以下成果:一個全新啟動的雲端代理能夠自行執行啟動腳本,透過 Cloudflare Access 從 Forgejo 複製一個私有儲存庫。它成功將一個分支推送到 Forgejo(沒有任何內容到達 GitHub),並使用 MCP 工具列出了所有分支。
在開發過程中,我遇到了一些問題並記錄下來:雲端代理會忽略儲存庫中的 .cursor/mcp.json 檔案。您必須在 Cursor 儀表板中將 MCP 作為個人自訂 MCP 新增,之後啟動的代理才能識別。
此外,在 .cursor/environment.json 檔案存在之前建立的 Cursor 環境,會忽略該檔案。解決方法是將安裝和啟動指令貼到環境的腳本欄位中。更改配置會建立新的建構版本,代理可能會從舊版本啟動,直到新版本生效。貼到 Cursor 中的密鑰可能包含尾隨空格,因此這個工具包現在會自動修剪它們。
設定步驟:README 檔案詳細說明了每個步驟,包括 Forgejo 的設定、Cloudflare Tunnel、Access、Cursor 密鑰、兩行環境腳本,以及如何新增 MCP。
儲存庫連結:GitHub - bee-hive-oss/cursor-private-git: Run Cursor cloud agents against self-hosted Forgejo through Cloudflare Tunnel and Access · GitHub。歡迎提供回饋、錯誤報告和拉取請求。您可以在下方提出任何問題。