30 lines
1.2 KiB
Markdown
30 lines
1.2 KiB
Markdown
# metal-kompanion-mcp
|
||
|
||
MCP backend and memory provider for Kompanion. Uses `qtmcp` (Qt-based MCP) to expose tools under namespace `kom.memory.v1`.
|
||
|
||
## Build
|
||
```bash
|
||
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/`.
|