Adrianozagallo Home MCP Server

🚀 模型上下文協議（MCP）服務器

本項目倉庫提供了在Azure Kubernetes Service (AKS) 上部署MCP服務器所需的Kubernetes配置文件，助力用戶輕鬆完成MCP服務器的部署工作。

🚀 快速開始

先決條件

在開始部署前，請確保您的環境中已安裝以下工具：

• Azure CLI
• kubectl
• Docker
• Node.js 18+版本

項目結構

項目的整體結構如下：

.
├── k8s/
│   ├── deployment.yaml    # Kubernetes部署配置文件
│   ├── service.yaml      # Kubernetes服務配置文件
│   └── configmap.yaml    # Kubernetes ConfigMap用於環境變量
├── src/                  # 源代碼目錄
├── Dockerfile           # 容器構建配置文件
├── package.json         # Node.js依賴項管理文件
└── tsconfig.json        # TypeScript配置文件

部署步驟

按照以下步驟完成MCP服務器的部署：

1. 構建Docker鏡像：

docker build -t mcp-server:latest .

2. 將鏡像推送到Azure容器註冊表（ACR）：

az acr login --name <your-acr-name>
docker tag mcp-server:latest <your-acr-name>.azurecr.io/mcp-server:latest
docker push <your-acr-name>.azurecr.io/mcp-server:latest

3. 應用Kubernetes配置文件：

kubectl apply -f k8s/

4. 驗證部署狀態：

kubectl get pods
kubectl get services

✨ 主要特性

配置靈活

應用程序可以通過在ConfigMap（k8s/configmap.yaml）中定義的環境變量進行靈活配置。

健康檢查

應用程序暴露了一個/health端點，可用於Kubernetes健康檢查，方便及時掌握應用程序的運行狀態。

監控便捷

• 資源使用情況可通過Azure Monitor進行監控，為資源管理提供有力支持。
• 應用程序日誌可通過kubectl logs命令獲取，便於問題排查和分析。

安全可靠

• 應用程序使用HTTPS協議，保障數據傳輸的安全性。
• 配置了跨域資源共享（CORS），實現安全的跨域請求。
• 實現了速率限制功能，有效防止濫用攻擊。
• 使用Helmet.js增強了HTTP安全頭配置，進一步提升應用程序的安全性。

擴展性強

部署默認配置為3個副本集。可以根據實際需求，通過以下命令進行擴展：

kubectl scale deployment mcp-server --replicas=<數量>