memocean-mcp
Provides tools for searching and managing knowledge stored in Obsidian vaults, including full-text search, BM25/INSTR hybrid search, and file ingestion into Obsidian.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@memocean-mcpsearch my notes about machine learning"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
memocean-mcp — Local-first AI Memory MCP Server

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.dbFATQ task queue — File-Atomic Task Queue for agent coordination
Quick Start
pip install memocean-mcpAdd to Claude Desktop / Claude Code .mcp.json:
{
"mcpServers": {
"memocean": {
"command": "memocean-mcp",
"env": {
"MEMOCEAN_VAULT_ROOT": "/path/to/your/obsidian/vault"
}
}
}
}Or register with Claude Code CLI:
MEMOCEAN_VAULT_ROOT=/path/to/vault claude mcp add memocean memocean-mcpRelated MCP server: obsidian-hybrid-search
Environment Variables
Variable | Default | Description |
|
| Root of your Obsidian vault |
|
| Data directory (databases, task queue) |
|
| Ocean subdirectory for full-text search |
|
| Skills markdown directory |
|
| Enable GBrain hybrid search delegate |
|
| Enable BGE-m3 KNN vector search |
| unset | Enable Haiku query expansion (requires |
| unset | Enable Haiku LLM reranker |
| unset | Required only for AI-assisted features above |
Backward-compat: CHANNELLAB_BOTS_ROOT → MEMOCEAN_DATA_DIR, CHANNELLAB_OCEAN_VAULT_ROOT → MEMOCEAN_VAULT_ROOT.
Available Tools
Tool | Description |
| Unified search across Radar (sonar index) + message history. Default entry point. |
| Search CLSC sonar index — fast keyword search, ~13% of verbatim token cost. |
| Retrieve full content by slug (verbatim or sonar mode). |
| Full-text search over Ocean vault |
| BM25 search over cross-agent message history. |
| Query the temporal knowledge graph by entity name. |
| List or retrieve approved skills from the skill library. |
| Create a task in the FATQ pending queue (agent coordination). |
| Ingest local file (PDF/DOCX/XLSX/HTML/CSV/JSON) into Radar via MarkItDown. |
| Store a verbatim markdown report into Ocean vault Reports folder. |
Search Architecture
Two-path retrieval, zero AI dependency by default:
CJK query → SQLite INSTR on radar.clsc → ranked by match_count
EN query → FTS5 BM25 → fallback to INSTR on missBenchmark (pure BM25/INSTR, no AI):
Dataset | Language | Hit@5 |
Internal corpus | Chinese (mixed) | 94.4% |
DRCD | Traditional Chinese | 91.9% |
CMRC | Simplified Chinese | 93.3% |
BEIR SciFact | English | 70.7% |
CLSC Sonar Compression
CLSC (Closet Lossy Summary for Chinese) extracts each document into a compact single-line sonar entry. Format:
[SLUG|ENTITIES|topics|"key_quote"|WEIGHT|EMOTIONS|FLAGS]Compression ratio: 1,716,211 raw tokens → 129,529 sonar tokens = 13x (92.5% reduction).
Requirements
Python 3.11+
SQLite 3.35+
Optional:
markitdown[all]for file ingestionOptional:
anthropicpackage for AI-assisted features (query expansion, reranking)
License
MIT — see LICENSE.
Acknowledgements
Built on MemPalace (dual-layer architecture, AAAK skeleton format) and inspired by GBrain (Compiled Truth + Dream Cycle design).
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ChannelLabAI/memocean'
If you have feedback or need assistance with the MCP directory API, please join our Discord server