MCP Bundler

🚀 MCP 打包服務

這是一個微服務，用於打包來自 GitHub 倉庫的代碼並將其準備好進行部署。它支持直接返回打包後的代碼或將代碼上傳到 Google Cloud Storage，為代碼部署提供了便利。

🚀 快速開始

# 安裝依賴
pnpm install

# 啟動開發服務器
pnpm run dev

# 訪問 API 文檔
open http://localhost:8080/docs

📚 詳細文檔

📄 API 文檔

當服務運行時，在 /docs 路徑下可以訪問交互式 API 文檔。

🔌 核心端點

🏠 主頁路由

GET /

返回一個靜態 HTML 頁面，顯示有關服務的信息。

💪 健康檢查

GET /health

返回一個簡單的狀態檢查以驗證服務是否運行正常。

📦 V1 打包程序（舊版本）

GET /bundler?url=<github_url>&commit=<commit_hash>&format=<mjs|cjs>

參數：

• url（必填）：GitHub 倉庫 URL
• commit（可選）：特定提交哈希（默認為最新）
• format（可選）：輸出格式 - mjs（默認）或 cjs

響應：

{
  "data": "<打包後的代碼作為字符串>"
}

📦 V2 打包程序（帶可選 GCP 上傳）

GET /v2/bundler?url=<github_url>&commit=<commit_hash>&mcpId=<your_mcp_id>

參數：

• url（必填）：GitHub 倉庫 URL
• commit（可選）：特定提交哈希（默認為最新）
• mcpId（可選）：唯一的服務器打包標識符（如果未提供則自動生成）

GCP 上傳啟用響應：

{
  "success": true,
  "gcp_upload": {
    "bucket": "your-bucket-name",
    "path": "your-mcp-id/commit-hash/",
    "files": [
      "bundle-commit-hash.tar.gz"
    ]
  }
}

GCP 上傳禁用響應：

{
  "success": true,
  "data": "<打包後的代碼作為字符串>"
}

☁️ GCP 集成（可選）

V2 打包程序可以將打包後的代碼上傳到 Google Cloud Storage 以供其他服務使用，或者直接返回打包後的代碼。

🚫 禁用 GCP 上載

如果你想禁用 GCP 上載並直接在 API 響應中獲取打包後的代碼，設置：

DISABLE_GCP_INTEGRATION=true

在你的環境或 .env 文件中。當 GCP 集成被禁用時：

1. 打包後的代碼直接在 API 響應中返回
2. 打包後的代碼存檔副本保存到項目根目錄的 bundled 目錄
3. 存檔文件名格式為 bundle-[提交哈希].tar.gz

🔑 設置 GCP 憑據

如果你想使用 GCP 上傳，你需要提供你的 Google Cloud Platform 憑證： 將你的服務賬戶密鑰 JSON 直接添加到 .env 文件中：

GOOGLE_CLOUD_KEY=your-service-account-key.json

⚠️ 注意事項

• 如果你禁用了 GCP 集成，則需要自行處理打包後的文件存儲。
• 確保你的服務賬戶具有足夠的權限以上傳文件到 Google Cloud Storage。

🚀 部署說明

📦 依賴項

在開始之前，請確保安裝以下依賴項：

npm install @mcp/bundler

🔧 環境變量

設置以下環境變量：

SENTRY_INGEST_URL=your-sentry-ingest-url

⚠️ 注意事項

• 打包程序支持以下格式：tar.gz, zip, tgz.
• 支持的平臺包括：Linux, Windows, macOS.
• 確保你的 GitHub 令牌具有讀取倉庫內容的權限。

👥 貢獻

歡迎貢獻！請隨時提交 Pull Request。