arcana-mcp

# arcana-mcp Semantic vector DB as an MCP server for Claude Code — SQLite + FTS5 + local ONNX embeddings. Gives Claude persistent, searchable project knowledge across conversations. Index files, store findings, search semantically — all through MCP tools. ## Install ### Claude Code Plugin (recommended) ```bash claude plugin marketplace add samelie/arcana-mcp claude plugin install arcana-mcp ``` This installs the MCP server, skills (`/arcana:context`, `/arcana:absorb`), and orientation protocol automatically. ### Manual ```bash pip install arcana-mcp ``` Add to your `.mcp.json`: ```json { "mcpServers": { "arcana": { "command": "uvx", "args": ["arcana-mcp", "serve"] } } } ``` ## Tools | Tool | Description | |------|-------------| | `arcana_add_resource` | Index a file or directory into the DB | | `arcana_add_memory` | Store a memory entry with embedding | | `arcana_search` | Hybrid semantic + FTS5 search (best default) | | `arcana_find` | Pure semantic (cosine similarity) search | | `arcana_grep` | Keyword/regex search via FTS5 | | `arcana_read` | Read full content of a resource | | `arcana_ls` | List direct children at a URI | | `arcana_tree` | Show recursive tree at a URI | | `arcana_stat` | Get metadata + chunk count for a resource | | `arcana_rm` | Remove a resource (with optional recursive) | | `arcana_mkdir` | Create a directory at a URI | | `arcana_mv` | Move/rename a resource | ## Skills ### `/arcana:absorb <path>` Generates knowledge files optimized for Claude retrieval. Surveys a directory, synthesizes structured knowledge, and indexes it into Arcana. Re-runnable — updates stale files, removes orphans. ### `/arcana:context` Quick access to search, store, and browse project knowledge. Use `arcana_search` for hybrid search, `arcana_add_memory` for quick findings, `arcana_add_resource` for indexing files. ## Configuration | Environment Variable | Default | Description | |---------------------|---------|-------------| | …