metal-kompanion/README.md

metal-kompanion-mcp

MCP backend and memory provider for Kompanion. Uses qtmcp (Qt-based MCP) to expose tools under namespace kom.memory.v1.

Build

cmake -S . -B build
cmake --build build -j

Layout

• src/main.cpp – entry point (stub until qtmcp wired)
• src/mcp/ToolSchemas.json – JSON Schemas for MCP tools
• src/memory/ – interfaces for embedder and vector store
• docs/ – design notes

Next

• Add qtmcp dependency and implement server with tool registration.
• Implement adapters: embedder(s) + vector store(s).
• Flesh out Postgres DAL paths (prepared statements + pgvector wiring).

Memory Tools

• kom.memory.v1.save_context persists conversational or workspace state in a namespace.
• kom.memory.v1.recall_context retrieves stored context by key, tags, or time window.
• See docs/using-memory-tools.md for integration notes (Codey, Claude Code) and request samples.

Integrations

• Kompanion-Konsole — demo plugin for KDE Konsole that lets agents hand terminals over to the Kompanion runtime. See integrations/konsole/README.md.
• JavaScript helpers — Node.js utilities that call the MCP memory tools from scripts or web extensions. See integrations/js/.