MCP Sse Authenticated Cloud Run

🚀 Google Cloud Run上でのMCP SSEサーバーのホスティング

このプロジェクトは、Google Cloud Runを利用して、安全かつ簡単にMCP SSEサーバーをホスティングする方法を提供します。現在MCPは認証と承認機能の開発中で、2025年上半年に完成予定です。その間、このソリューションを使ってチームとMCPサーバーを共有できます。

MCPロードマップ

🚀 クイックスタート

環境にDockerとgcloud CLIが設定されていれば、このソリューションはすぐに使えるはずです。

第1ステップ：deploy.shファイルの更新

deploy.shに、プロジェクトID、サービスアカウントのメールアドレスなどの情報を記入します。

第2ステップ：Cloud RunのURLの取得とmcp_proxy.tsへの追加

デプロイが成功したら、Cloud Runが提供するURLを取得し、mcp_proxy.tsファイルに追加します。同時に、プロジェクトIDも含めます。

第3ステップ：プロキシの実行

npx ts-node mcp_proxy.tsを実行します。

第4ステップ：MCPサーバーへのアクセスとCursorへの追加

http://localhost:3030を通じてMCPサーバーにアクセスし、Cursorの設定に追加します（SSEを選択することを忘れないでください）。

✨ 主な機能

• Google Cloud Runを利用して、MCP SSEサーバーを安全にホスティングできます。
• Cloud RunのIAM認証機能を使って、サーバーを安全にインターネットに接続できます。
• 簡単な設定で、すぐにMCPサーバーを使い始めることができます。

📦 インストール

リポジトリのクローン

1. このリポジトリをローカル環境にクローンします。
2. npm installを実行して、すべての依存関係をインストールします。
3. npm run devを実行して、ローカル開発用のサーバーを起動します。

Google Cloud Runへのデプロイ

1. Google Cloud SDKをインストールします。
2. deploy.shスクリプトのプロジェクト情報を更新します。
   • PROJECT_ID: Google CloudのプロジェクトID
   • REGION: 選択したGCPリージョン
   • SERVICE_ACCOUNT_EMAIL: 適切な権限を持つサービスアカウントのメールアドレス
3. デプロイスクリプトを実行します。

   chmod +x deploy.sh
   ./deploy.sh
   

💻 使用例

基本的な使用法

1. プロキシを起動します。

   npx ts-node mcp_proxy.ts
   

2. http://localhost:3030を通じてMCPサーバーにアクセスします。

高度な使用法

Cursorを使ってMCPサーバーを設定するには、以下の手順を実行します。

1. Cursorの設定画面を開きます。
2. 新しいMCPサーバーを追加し、関連するURLとエンドポイント情報を入力します。

📚 ドキュメント

接続の問題の解決

接続できない場合は、以下の点を確認してください。

1. プロキシが実行中で、http://localhost:3030にアクセスできることを確認します。
2. ネットワークのファイアウォール設定を確認し、ポートがブロックされていないことを確認します。
3. Cloud Runサービスのアクセスログを確認し、権限の問題がないことを確認します。

コントリビューション

コミュニティからの貢献を歓迎します。エラーを見つけたり、改善提案がある場合は、GitHubのIssueを作成するか、リポジトリをforkしてPull Requestを作成してください。

🔧 技術詳細

MCPサーバーはGoogle Cloud Run上にホスティングされています。Cloud RunのIAM認証機能を利用して、Google Cloud SDKを使ってプロキシ接続を作成することで、サーバーを安全にインターネットに接続します。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。

⚠️ 重要提示

本文書内の画像パスとサンプルは、実際のプロジェクト構造に合わせて調整する必要があります。

💡 使用建议

すべての機密情報（APIキーなど）は、コードリポジトリに平文で保存しないでください。また、IAMポリシーを使用して、Cloud Runサービスへのアクセス権を制限し、承認されたサービスとユーザーのみが呼び出せるようにしてください。