103 lines
1.5 KiB
Markdown
103 lines
1.5 KiB
Markdown
# termi-blog
|
|
|
|
Monorepo for the Termi blog system.
|
|
|
|
## Structure
|
|
|
|
```text
|
|
.
|
|
├─ 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
|
|
```
|
|
|
|
## Run
|
|
|
|
### Monorepo scripts
|
|
|
|
From the repository root:
|
|
|
|
```powershell
|
|
.\dev.ps1
|
|
```
|
|
|
|
Frontend + backend + MCP:
|
|
|
|
```powershell
|
|
.\dev.ps1 -WithMcp
|
|
```
|
|
|
|
Only frontend:
|
|
|
|
```powershell
|
|
.\dev.ps1 -FrontendOnly
|
|
```
|
|
|
|
Only backend:
|
|
|
|
```powershell
|
|
.\dev.ps1 -BackendOnly
|
|
```
|
|
|
|
Only MCP:
|
|
|
|
```powershell
|
|
.\dev.ps1 -McpOnly
|
|
```
|
|
|
|
Direct scripts:
|
|
|
|
```powershell
|
|
.\start-frontend.ps1
|
|
.\start-backend.ps1
|
|
.\start-mcp.ps1
|
|
```
|
|
|
|
### Frontend
|
|
|
|
```powershell
|
|
cd frontend
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
### Backend
|
|
|
|
```powershell
|
|
cd backend
|
|
$env:DATABASE_URL="postgres://postgres:postgres%402025%21@10.0.0.2:5432/termi-api_development"
|
|
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`
|