模型上下文协议服务器部署方案

.
├── ARCHITECTURE.md              # Detailed architecture documentation
├── README.md                    # This file
├── docker-compose.yml           # Local development with Docker
├── .github/
│   └── workflows/
│       └── deploy.yml          # CI/CD pipeline
├── infrastructure/
│   ├── terraform/              # Terraform infrastructure code
│   │   ├── main.tf
│   │   ├── variables.tf
│   │   ├── outputs.tf
│   │   ├── resources.tf
│   │   ├── terraform.tfvars.example
│   │   └── README.md
│   └── apim-policies/          # APIM policy configurations
│       ├── rate-limiting-policy.xml
│       ├── jwt-validation-policy.xml
│       ├── ip-whitelist-policy.xml
│       ├── caching-policy.xml
│       ├── transformation-policy.xml
│       ├── production-policy.xml
│       └── README.md
├── scripts/
│   ├── deploy.sh               # Automated deployment script
│   ├── test-api.sh             # API testing script
│   └── cleanup.sh              # Resource cleanup script
└── src/
    ├── mcp_server.py           # MCP server implementation
    ├── app.py                  # Flask web wrapper
    ├── requirements.txt        # Python dependencies
    └── Dockerfile              # Container image definition

# Clone the repository
git clone <your-repo-url>
cd MCP-build

# Login to Azure
az login
az account set --subscription <subscription-id>

# Create Terraform variables file
cd infrastructure/terraform
cp terraform.tfvars.example terraform.tfvars

# Edit terraform.tfvars with your settings
nano terraform.tfvars

# Run the deployment script from project root
./scripts/deploy.sh

# Deploy infrastructure
cd infrastructure/terraform
terraform init
terraform plan
terraform apply

# Build and deploy application
cd ../../src
zip -r deploy.zip . -x "*.pyc" -x "__pycache__/*"

# Get deployment details
RG_NAME=$(terraform output -raw resource_group_name)
APP_NAME=$(terraform output -raw web_app_name)

# Deploy to Web App
az webapp deployment source config-zip \
  --resource-group $RG_NAME \
  --name $APP_NAME \
  --src deploy.zip

# Run automated tests
./scripts/test-api.sh

# Or test manually
curl https://<your-apim>.azure-api.net/mcp/api/v1/tools \
  -H "Ocp-Apim-Subscription-Key: <your-key>"

# Start the server
docker-compose up

# The server will be available at http://localhost:8000
curl http://localhost:8000/health

# Create virtual environment
cd src
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run the server
python app.py

# Test locally
curl http://localhost:8000/health

# Stream logs
az webapp log tail \
  --resource-group <resource-group> \
  --name <webapp-name>

# Download logs
az webapp log download \
  --resource-group <resource-group> \
  --name <webapp-name>

// Request performance
requests
| where timestamp > ago(1h)
| summarize count(), avg(duration) by bin(timestamp, 5m)
| render timechart

// Error analysis
exceptions
| where timestamp > ago(24h)
| summarize count() by type, outerMessage

# Apply a policy to your API
az apim api policy create \
  --resource-group <rg> \
  --service-name <apim-name> \
  --api-id <api-id> \
  --xml-policy @infrastructure/apim-policies/production-policy.xml

# Create Azure service principal
az ad sp create-for-rbac \
  --name "mcp-server-github" \
  --role contributor \
  --scopes /subscriptions/<subscription-id> \
  --sdk-auth

# Add to GitHub Secrets:
# - AZURE_CREDENTIALS (output from above command)
# - AZURE_RESOURCE_GROUP
# - AZURE_WEBAPP_NAME

curl -X POST https://<apim-url>/mcp/api/v1/tools/call \
  -H "Ocp-Apim-Subscription-Key: <key>" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_name": "calculate",
    "arguments": {
      "operation": "add",
      "a": 10,
      "b": 5
    }
  }'

# Using cleanup script
./scripts/cleanup.sh

# Or manually with Terraform
cd infrastructure/terraform
terraform destroy