Files

T

Patrick Plate 9c2422d0a7 chore(roo): document git-based wiki workflow in rules, skill, and README

- mcp-builder rules: add wiki/ to structure diagram, add Wiki Update
  Workflow section (MANDATORY), update After Building a Server checklist
- gitea-push skill: add wiki deploy as a valid use case
- README.md: add wiki section with deploy_wiki.sh pointer, add
  mcp-image-gen to MCP servers table

2026-04-05 09:53:05 +02:00

2.4 KiB

Raw Blame History

Workshop — Patrick's Homelab Monorepo

A polyglot monorepo for personal engineering projects: MCP servers, Java web apps, and whatever comes next. Hosted on Gitea @ TrueNAS.local.

See plans/REPO_STRATEGY.md for the full structure rationale and conventions.

📂 Structure

workshop/
├── mcp/          Python MCP servers (FastMCP + uv)
├── java/         Java web projects (Maven + Jakarta EE)
├── plans/        Architecture & strategy docs
└── .roo/         IDE config (Roo Code, MCP wiring)

📖 Wiki

Full documentation lives in the Gitea wiki.

Wiki source: docs/wiki/pages/ — edit here, deploy with:

./docs/wiki/deploy_wiki.sh

� MCP Servers (`mcp/`)

Server	Description	Stack
`mcp/bigmind/`	Persistent AI memory — sessions, facts, hypotheses, profile UI	Python, FastMCP, SQLite, Flask
`mcp/webscraper/`	Web scraping, search — fetch, links, tables, Brave Search	Python, FastMCP, httpx, BeautifulSoup
`mcp/mcp-image-gen/`	AI image generation — text-to-image via ComfyUI + FLUX.1-schnell	Python, FastMCP, httpx, ComfyUI

Run a server:

cd mcp/bigmind   # or mcp/webscraper
./run.sh

Each server is an independent Python package. uv sync handles dependencies, no shared virtualenv.

☕ Java Projects (`java/`)

Project	Description	Stack
`java/mss-failsafe/`	MSS Failsafe — multi-module Java EE web application	Java EE, Maven, WildFly
`java/wellmann-shop/`	Wellmann online shop — JSF/PrimeFaces e-commerce	Java 8, JSF, PrimeFaces, EclipseLink, MySQL

Build a project:

cd java/wellmann-shop
mvn clean package

📐 Plans & Architecture (`plans/`)

Document	Description
`plans/REPO_STRATEGY.md`	Monorepo strategy, taxonomy, naming conventions, migration log

🔧 IDE Wiring

MCP servers are wired into VS Code via .roo/mcp.json.

BigMind memory DB lives at ~/.mcp/bigmind/memory.db (outside the repo — not committed).

License

MIT — personal homelab use.

2.4 KiB Raw Blame History