diff --git a/.roo/rules-mcp-builder/00-mcp-builder-behavior.md b/.roo/rules-mcp-builder/00-mcp-builder-behavior.md index e24a615..b7a1db3 100644 --- a/.roo/rules-mcp-builder/00-mcp-builder-behavior.md +++ b/.roo/rules-mcp-builder/00-mcp-builder-behavior.md @@ -20,6 +20,28 @@ Patrick is in MCP Builder mindset. He is building or extending MCP servers in th README.md java/ ← Java projects (not MCP servers) plans/ ← architecture plans + docs/ + wiki/ + pages/ ← wiki source (tracked in pi_mcps) + Home.md, _Sidebar.md, ... + deploy_wiki.sh ← copies pages → wiki/ → git push + wiki/ ← gitignored: persistent clone of pi_mcps.wiki.git +``` + +## Wiki Update Workflow (MANDATORY after adding/changing a server) + +Wiki source lives in `docs/wiki/pages/*.md` — real Markdown files, tracked in the main repo. + +```bash +# 1. Edit the relevant page(s) in docs/wiki/pages/ +# 2. Deploy to Gitea wiki: +./docs/wiki/deploy_wiki.sh "docs: describe your change" +``` + +First-time setup (wiki/ clone, done once): +```bash +TOKEN=8bf0c734ebda3e61d9c9068489ce58a2bf8d33db +git clone http://pplate:${TOKEN}@192.168.188.119:30008/pplate/pi_mcps.wiki.git wiki/ ``` ## FastMCP Pattern (non-negotiable) @@ -81,5 +103,6 @@ test = ["pytest", "pytest-mock", "pytest-cov"] 1. **Store Fact:** `memory_store_fact("codebase", "mcp/{name} has N tools: [list]. Stack: X. Env vars: Y.")` 2. **Wire into .roo/mcp.json:** Add the server entry with correct uv path 3. **Update root README.md:** Add to MCPs table -4. **Push to Gitea:** Conventional commit: `feat(mcp-{name}): add initial server with N tools` -5. **Resolve Hypothesis:** Was the tool count and auth pattern as predicted? +4. **Update wiki:** Create or update `docs/wiki/pages/{server-name}.md` + update `MCP-Servers-Overview.md`, then run `./docs/wiki/deploy_wiki.sh` +5. **Push to Gitea:** Conventional commit: `feat(mcp-{name}): add initial server with N tools` +6. **Resolve Hypothesis:** Was the tool count and auth pattern as predicted? diff --git a/.roo/skills/gitea-push/SKILL.md b/.roo/skills/gitea-push/SKILL.md index 5a6481f..828dde4 100644 --- a/.roo/skills/gitea-push/SKILL.md +++ b/.roo/skills/gitea-push/SKILL.md @@ -9,6 +9,7 @@ description: Commits and pushes code to the homelab Gitea server using conventio - Finished a homelab change and need to commit + push - Finished an MCP server build or update - BigMind feature complete +- Wiki pages were added or updated (always deploy wiki after docs changes) ## When NOT to use - ADP/Paisy work — that goes to the corporate Bitbucket, not homelab Gitea diff --git a/README.md b/README.md index 59eeab4..33f2f3f 100644 --- a/README.md +++ b/README.md @@ -18,12 +18,24 @@ workshop/ --- -## 🐍 MCP Servers (`mcp/`) +## 📖 Wiki + +Full documentation lives in the [Gitea wiki](http://192.168.188.119:30008/pplate/pi_mcps/wiki). + +**Wiki source:** [`docs/wiki/pages/`](docs/wiki/pages/) — edit here, deploy with: +```bash +./docs/wiki/deploy_wiki.sh +``` + +--- + +## � MCP Servers (`mcp/`) | Server | Description | Stack | |---|---|---| | [`mcp/bigmind/`](mcp/bigmind/) | Persistent AI memory — sessions, facts, hypotheses, profile UI | Python, FastMCP, SQLite, Flask | -| [`mcp/webscraper/`](mcp/webscraper/) | Web scraping — fetch, links, tables, sections, sitemaps | Python, FastMCP, httpx, BeautifulSoup | +| [`mcp/webscraper/`](mcp/webscraper/) | Web scraping, search — fetch, links, tables, Brave Search | Python, FastMCP, httpx, BeautifulSoup | +| [`mcp/mcp-image-gen/`](mcp/mcp-image-gen/) | AI image generation — text-to-image via ComfyUI + FLUX.1-schnell | Python, FastMCP, httpx, ComfyUI | **Run a server:** ```bash