MCP Sse Authenticated Cloud Run

🚀 在Google Cloud Run上託管MCP SSE服務器

本項目提供了一種在Google Cloud Run上託管MCP SSE服務器的解決方案，解決了當前MCP身份驗證和授權功能不完善的問題，讓您能安全地通過互聯網訪問自定義的MCP服務器。

截至2024年3月4日，MCP仍在處理身份驗證和授權問題，計劃於2025年上半年完成此功能。目前，若要在Cursor等工具中使用MCP服務器，唯一直接的方法是基於網絡層的解決方案（如代理），基本身份驗證、API密鑰等其他功能暫不可用。而本方案利用Google Cloud Run和基於用戶的IAM身份驗證，為客戶端訪問自定義MCP服務器提供了簡單且安全的途徑。

MCP路線圖

🚀 快速開始

如果您的環境已配置好Docker和gcloud CLI，且只需少量設置，此方案應該可以開箱即用。具體步驟如下：

1. 更新deploy.sh文件：在deploy.sh中填入您的項目ID、服務賬戶電子郵件等信息。
2. 獲取並添加URL：部署成功後，獲取Cloud Run提供的URL，並將其添加到mcp_proxy.ts文件中，同時包含您的項目ID。
3. 運行代理：執行命令 npx ts-node mcp_proxy.ts。
4. 訪問服務器：通過http://localhost:3030訪問您的MCP服務器，並在Cursor的設置中添加它（記得選擇SSE而不是命令）。

✨ 主要特性

• 安全訪問：藉助Google Cloud Run的IAM身份驗證功能，安全地將MCP服務器連接到互聯網。
• 簡單部署：只需對deploy.sh文件進行簡單配置，即可完成服務器的部署。

📦 安裝指南

克隆倉庫

1. 將此倉庫克隆到本地環境：

git clone [倉庫地址]

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

該腳本將完成以下操作：

• 使用Docker構建MCP服務器容器。
• 將容器推送到Google Container Registry。
• 配置並部署到Cloud Run，同時啟用身份驗證功能。

連接到已部署的MCP服務器

1. 在本地運行代理：

npx ts-node mcp_proxy.ts

2. 打開瀏覽器並訪問 http://localhost:3030。

使用Cursor配置MCP服務器

1. 打開Cursor的設置界面。
2. 添加新的MCP服務器，輸入相關URL和端點信息。

🔧 技術細節

MCP服務器託管在Google Cloud Run上，利用Cloud Run的IAM身份驗證功能，通過Google Cloud SDK創建代理連接，將服務器安全地連接到互聯網。

📚 詳細文檔

安全注意事項

⚠️ 重要提示

• 確保所有敏感信息（如API密鑰）不在代碼庫中明文存儲。
• 使用IAM策略限制對Cloud Run服務的訪問權限，確保只有經過授權的服務和用戶可以調用它。

解決連接問題

如果遇到無法連接的問題，請檢查以下內容：

1. 確認代理正在運行，並且可以在本地訪問 http://localhost:3030。
2. 檢查網絡防火牆設置，確保端口未被阻止。
3. 查看Cloud Run服務的訪問日誌，確認是否有權限問題。

貢獻信息

我們歡迎社區貢獻！如果發現任何錯誤或有改進建議，請提交GitHub問題或直接 fork 倉庫並創建pull request。

📄 許可證

該項目遵循MIT許可證。

⚠️ 重要提示

本文檔中的圖片路徑和示例可能需要根據實際項目結構進行調整。