MCP Bundler

🚀 MCP パッケージングサービス

このマイクロサービスは、GitHub リポジトリからコードをパッケージングし、デプロイの準備を行います。パッケージングされたコードを直接返すことも、Google Cloud Storage にアップロードすることもサポートしています。

🚀 クイックスタート

# 依存関係のインストール
pnpm install

# 開発サーバーの起動
pnpm run dev

# APIドキュメントのアクセス
open http://localhost:8080/docs

📚 ドキュメント

サービスが実行されているとき、/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 トークンには、リポジトリの内容を読み取る権限があることを確認してください。

🤝 貢献

貢献を歓迎します！プルリクエストをいつでも送信してください。