chore: checkpoint ai search comments and i18n foundation

README.md

@@ -8,6 +8,7 @@ Monorepo for the Termi blog system.
 .
 ├─ frontend/   # Astro blog frontend
 ├─ backend/    # Loco.rs backend and admin
+├─ mcp-server/ # Streamable HTTP MCP server for articles/categories/tags
 ├─ .codex/     # Codex workspace config
 └─ .vscode/    # Editor workspace config
 ```
@@ -22,6 +23,12 @@ From the repository root:
 .\dev.ps1
 ```
 
+Frontend + backend + MCP:
+
+```powershell
+.\dev.ps1 -WithMcp
+```
+
 Only frontend:
 
 ```powershell
@@ -34,11 +41,18 @@ Only backend:
 .\dev.ps1 -BackendOnly
 ```
 
+Only MCP:
+
+```powershell
+.\dev.ps1 -McpOnly
+```
+
 Direct scripts:
 
 ```powershell
 .\start-frontend.ps1
 .\start-backend.ps1
+.\start-mcp.ps1
 ```
 
 ### Frontend
@@ -57,6 +71,32 @@ $env:DATABASE_URL="postgres://postgres:postgres%402025%21@10.0.0.2:5432/termi-ap
 cargo loco start 2>&1
 ```
 
+### MCP Server
+
+```powershell
+.\start-mcp.ps1
+```
+
+Default MCP endpoint:
+
+```text
+http://127.0.0.1:5151/mcp
+```
+
+Default local development API key:
+
+```text
+termi-mcp-local-dev-key
+```
+
+The MCP server wraps real backend APIs for:
+
+- Listing, reading, creating, updating, and deleting Markdown posts
+- Listing, creating, updating, and deleting categories
+- Listing, creating, updating, and deleting tags
+- Reading and updating public site settings
+- Rebuilding the AI index
+
 ## Repo Name
 
 Recommended repository name: `termi-blog`