docs: add VitePress documentation site

- 22 content pages across Guide, Concepts, and Reference sections - Custom indigo/cyan theme with Lucide icons and Mermaid diagrams - GitHub Actions workflow for GitHub Pages deployment - Live preview: https://mempalace-docs.netlify.app/
2026-04-09 19:11:23 -03:00
parent 2981433535
commit dfb22f5345
37 changed files with 3673 additions and 0 deletions
@@ -0,0 +1,92 @@
+# MCP Integration
+
+MemPalace provides 19 tools through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/), giving any MCP-compatible AI full read/write access to your palace.
+
+## Setup
+
+### Manual Connection
+
+```bash
+claude mcp add mempalace -- python -m mempalace.mcp_server
+```
+
+### With Custom Palace Path
+
+```bash
+claude mcp add mempalace -- python -m mempalace.mcp_server --palace /path/to/palace
+```
+
+Now your AI has all 19 tools available. Ask it anything:
+
+> *"What did we decide about auth last month?"*
+
+Claude calls `mempalace_search` automatically, gets verbatim results, and answers you.
+
+## Compatible Tools
+
+MemPalace works with any tool that supports MCP:
+
+- **Claude Code** — native via plugin or manual MCP
+- **ChatGPT** — via MCP bridge
+- **Cursor** — native MCP support
+- **Gemini CLI** — see [Gemini CLI guide](/guide/gemini-cli)
+
+## Memory Protocol
+
+When the AI first calls `mempalace_status`, it receives the **Memory Protocol** — a behavior guide that teaches it to:
+
+1. **On wake-up**: Call `mempalace_status` to load the palace overview
+2. **Before responding** about any person, project, or past event: search first, never guess
+3. **If unsure**: Say "let me check" and query the palace
+4. **After each session**: Write diary entries to record what happened
+5. **When facts change**: Invalidate old facts, add new ones
+
+This protocol is what turns storage into memory — the AI knows to verify before speaking.
+
+## Tool Overview
+
+### Palace (read)
+
+| Tool | What |
+|------|------|
+| `mempalace_status` | Palace overview + AAAK spec + memory protocol |
+| `mempalace_list_wings` | Wings with counts |
+| `mempalace_list_rooms` | Rooms within a wing |
+| `mempalace_get_taxonomy` | Full wing → room → count tree |
+| `mempalace_search` | Semantic search with wing/room filters |
+| `mempalace_check_duplicate` | Check before filing |
+| `mempalace_get_aaak_spec` | AAAK dialect reference |
+
+### Palace (write)
+
+| Tool | What |
+|------|------|
+| `mempalace_add_drawer` | File verbatim content |
+| `mempalace_delete_drawer` | Remove by ID |
+
+### Knowledge Graph
+
+| Tool | What |
+|------|------|
+| `mempalace_kg_query` | Entity relationships with time filtering |
+| `mempalace_kg_add` | Add facts |
+| `mempalace_kg_invalidate` | Mark facts as ended |
+| `mempalace_kg_timeline` | Chronological entity story |
+| `mempalace_kg_stats` | Graph overview |
+
+### Navigation
+
+| Tool | What |
+|------|------|
+| `mempalace_traverse` | Walk the graph from a room across wings |
+| `mempalace_find_tunnels` | Find rooms bridging two wings |
+| `mempalace_graph_stats` | Graph connectivity overview |
+
+### Agent Diary
+
+| Tool | What |
+|------|------|
+| `mempalace_diary_write` | Write AAAK diary entry |
+| `mempalace_diary_read` | Read recent diary entries |
+
+For detailed schemas and parameters, see [MCP Tools Reference](/reference/mcp-tools).