memocean-mcp

# memocean-mcp — Local-first AI Memory MCP Server  [](LICENSE) [](https://www.python.org/) A local MCP server for AI agents to search and manage knowledge stored in Obsidian vaults. Built for CJK (Chinese/Japanese/Korean) developers — 94.4% Hit@5 on Chinese queries with zero AI components required. **Core features:** - BM25/INSTR hybrid search — CJK-optimized, pure SQLite, no embeddings needed - CLSC sonar compression — 92.5% token reduction (13x compression) on Obsidian notes - Temporal knowledge graph — entity-relationship store with non-destructive invalidation - Cross-agent memory sharing — multiple agents share one `memory.db` - FATQ task queue — File-Atomic Task Queue for agent coordination --- ## Quick Start ```bash pip install memocean-mcp ``` Add to Claude Desktop / Claude Code `.mcp.json`: ```json { "mcpServers": { "memocean": { "command": "memocean-mcp", "env": { "MEMOCEAN_VAULT_ROOT": "/path/to/your/obsidian/vault" } } } } ``` Or register with Claude Code CLI: ```bash MEMOCEAN_VAULT_ROOT=/path/to/vault claude mcp add memocean memocean-mcp ``` --- ## Environment Variables | Variable | Default | Description | |---|---|---| | `MEMOCEAN_VAULT_ROOT` | `~/Documents/Obsidian Vault` | Root of your Obsidian vault | | `MEMOCEAN_DATA_DIR` | `~/.memocean` | Data directory (databases, task queue) | | `MEMOCEAN_VAULT_PATH` | `MEMOCEAN_VAULT_ROOT/Ocean` | Ocean subdirectory for full-text search | | `MEMOCEAN_SKILLS_DIR` | `MEMOCEAN_VAULT_ROOT/Ocean/Pearl/skills` | Skills markdown directory | | `MEMOCEAN_USE_GBRAIN` | `false` | Enable GBrain hybrid search delegate | | `KNN_ENABLED` | `false` | Enable BGE-m3 KNN vector search | | `ENABLE_QUERY_EXPANSION` | unset | Enable Haiku query expansion (requires `ANTHROPIC_API_KEY`) | | `ENABLE_HAIKU_RERANKE…