Merge pull request #639 from microsoft/dev-v3

fix: merging dev to main

Author: Roopan-Microsoft

docs/DeploymentGuide.md

@@ -326,6 +326,7 @@ If you are done trying out the application, you can delete all resources by runn
 ```shell
 azd down
 ```
+> **Note:** If you deployed with `enableRedundancy=true` and Log Analytics workspace replication is enabled, you must first disable replication before running `azd down` else resource group delete will fail. Follow the steps in [Handling Log Analytics Workspace Deletion with Replication Enabled](./LogAnalyticsReplicationDisable.md), wait until replication returns `false`, then run `azd down`.
 
 # Local setup
 
@@ -442,7 +443,8 @@ The files for the dev container are located in `/.devcontainer/` folder.
    - Make sure to set APP_ENV to "**dev**" in `.env` file.
    - For local development, make sure to include below env variables in the `.env`
      - `BACKEND_API_URL=http://localhost:8000`
-     - `FRONTEND_SITE_NAME=http://127.0.0.1:3000` .
+     - `FRONTEND_SITE_NAME=http://127.0.0.1:3000` 
+     - `MCP_SERVER_ENDPOINT=http://localhost:9000/mcp`.
 
 7. **(Optional) Set up a virtual environment:**
 
@@ -474,7 +476,16 @@ The files for the dev container are located in `/.devcontainer/` folder.
       npm run build
       ```
 
-10. **Run the application:**
+10. **Install requirements - MCP server:**
+
+   - To install the requirement for mcp server -
+     Open a terminal in the `src/mcp_server` folder and run:
+     ```bash
+     pip install uv
+     uv sync
+     ```
+
+11. **Run the application:**
 
 - From the `src/backend` directory activate the virtual environment created through step 8 and Run:
 
@@ -494,14 +505,20 @@ or Run
   npm run dev
   ```
 
+- From the `src/mcp_server` directory activate the virtual environment created through step 10 and Run:
+
+```bash
+python mcp_server.py --transport streamable-http --host 0.0.0.0 --port 9000
+```
+
 11. Open a browser and navigate to `http://localhost:3000`
 12. To see swagger API documentation, you can navigate to `http://localhost:8000/docs`
 
 ## Deploy Your local changes
 To Deploy your local changes rename the below files.
    1. Rename `azure.yaml` to `azure_custom2.yaml` and `azure_custom.yaml` to `azure.yaml`.
    2. Go to `infra` directory
-        - Remove `main.bicep` to `main_custom2.bicep` and `main_custom.bicep` to `main.bicep`.
+        - Rename `main.bicep` to `main_custom2.bicep` and `main_custom.bicep` to `main.bicep`.
 Continue with the [deploying steps](#deploying-with-azd).
 
 
@@ -510,15 +527,26 @@ Continue with the [deploying steps](#deploying-with-azd).
 You can debug the API backend running locally with VSCode using the following launch.json entry:
 
 ```
-    {
-      "name": "Python Debugger: Backend",
-      "type": "debugpy",
-      "request": "launch",
-      "cwd": "${workspaceFolder}/src/backend",
-      "module": "uvicorn",
-      "args": ["app:app", "--reload"],
-      "jinja": true
-    }
+      {
+        "name": "Debug Backend (FastAPI)",
+        "type": "debugpy",
+        "request": "launch",
+        "program": "${workspaceFolder}/src/backend/app_kernel.py",
+        "cwd": "${workspaceFolder}/src/backend",
+        "console": "integratedTerminal",
+        "justMyCode": false,
+        "python": "${workspaceFolder}/src/backend/.venv/Scripts/python.exe",
+        "env": {
+            "PYTHONPATH": "${workspaceFolder}/src/backend",
+            "UVICORN_LOG_LEVEL": "debug"
+        },
+        "args": [],
+        "serverReadyAction": {
+            "pattern": "Uvicorn running on (https?://[^\\s]+)",
+            "uriFormat": "%s",
+            "action": "openExternally"
+        }
+      }
 ```
 
 To debug the python server in the frontend directory (frontend_server.py) and related, add the following launch.json entry:
@@ -534,3 +562,26 @@ To debug the python server in the frontend directory (frontend_server.py) and re
       "jinja": true
     }
 ```
+
+To debug the MCP server by adding the following launch.json entry:
+
+```
+     {
+        "name": "Debug MCP Server",
+        "type": "debugpy",
+        "request": "launch",
+        "program": "${workspaceFolder}/src/mcp_server/mcp_server.py",
+        "cwd": "${workspaceFolder}/src/mcp_server",
+        "console": "integratedTerminal",
+        "justMyCode": false,
+        "python": "${workspaceFolder}/src/mcp_server/.venv/Scripts/python.exe",
+        "env": {
+            "PYTHONPATH": "${workspaceFolder}/src/mcp_server"
+        },
+        "args": [
+            "--transport", "streamable-http",
+            "--host", "0.0.0.0",
+            "--port", "9000"
+        ]
+      }
+```

docs/LogAnalyticsReplicationDisable.md

@@ -0,0 +1,28 @@
+# 🛠 Handling Log Analytics Workspace Deletion with Replication Enabled
+
+If redundancy (replication) is enabled for your Log Analytics workspace, you must disable it before deleting the workspace or resource group. Otherwise, deletion will fail.
+
+## ✅ Steps to Disable Replication Before Deletion
+Run the following Azure CLI command. Note: This operation may take about 5 minutes to complete.
+
+```bash
+az resource update --ids "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{logAnalyticsName}" --set properties.replication.enabled=false
+```
+
+Replace:
+- `{subscriptionId}` → Your Azure subscription ID
+- `{resourceGroupName}` → The name of your resource group
+- `{logAnalyticsName}` → The name of your Log Analytics workspace
+
+Optional: Verify replication disabled (should output `false`):
+```bash
+az resource show --ids "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{logAnalyticsName}" --query properties.replication.enabled -o tsv
+```
+
+## ✅ After Disabling Replication
+You can safely delete:
+- The Log Analytics workspace (manual)
+- The resource group (manual), or
+- All provisioned resources via `azd down`
+
+Return to: [Deployment Guide](./DeploymentGuide.md)