Cortex
Integrates with Obsidian vaults to provide semantic search, entity extraction, and knowledge graph capabilities for AI coding assistants.
Click on "Deploy 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., "@Cortexremind me about the forgetting curve design"
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.
š§ Cortex ā Proactive Memory Agent for AI Coding Assistants
Obsidian-backed knowledge graph with semantic search, entity extraction, and cross-session memory. 11 MCP tools. Works with Claude Code, Cursor, Windsurf, and any MCP-compatible editor.
What It Does
You: "How does the memory system handle forgetting?"
Cortex: š” This reminds me of your previous work on:
1. decisions/memory-architecture-choice ā Ebbinghaus decay with 14-day half-life
2. daily/2026-06-19 ā You designed the three-tier memory architecture
3. moc/system-architecture ā Full system diagramSemantic search ā Find concepts across languages (EN query ā CN content)
Knowledge graph ā 928 entities, 106K relationships, auto-extracted from your notes
Proactive context ā
memory_monitorwatches conversation topics, surfaces relevant memoriesGap analysis ā Compare your learning goals against actual knowledge coverage
Cross-session ā Every session loads your memory index + recent daily logs automatically
Related MCP server: MegaMem
Architecture
MCP Client (Claude Code / Cursor / Windsurf)
ā stdio JSON-RPC
ā¼
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā Cortex MCP Server (TypeScript) ā
ā 11 tools + 1 resource ā
ā āāāāāāāāāāāāāāāāāāāāāāāāāāāāā ā
ā ā SQLite (sql.js) ā ā ā Knowledge graph (8 tables)
ā ā LanceDB ā ā ā Vector embeddings (384-dim)
ā ā ONNX (all-MiniLM-L6-v2) ā ā ā Local, zero API cost
ā āāāāāāāāāāāāāāāāāāāāāāāāāāāāā ā
āāāāāāāāāāāāāāāā¬āāāāāāāāāāāāāāāāāāā
ā reads & indexes
ā¼
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā Obsidian Vault (source of truth)ā
ā daily/ decisions/ moc/ ā
ā å¦ä¹ č®”å/ ... ā
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāQuick Start
# 1. Install
cd Cortex/mcp-server
npm install --ignore-scripts
npx tsc
# 2. Configure (Claude Code)
# Copy the MCP config to your global Claude Code settings:
# ~/.claude/.mcp.json
# 3. Use
# Start a Claude Code session. The MCP server starts automatically.
# Say: "memory_ingest" to index your vault
# Say: "search for architecture decisions" to find memoriesMCP Tools
Tool | Description |
| Hybrid keyword + vector semantic search |
| Scan vault, extract entities, build index |
| System health report |
| Extract typed entities from text |
| Query the knowledge graph (multi-hop) |
| Suggest |
| Process conversation, return proactive context |
| Detect contradictions with existing memories |
| Analyze knowledge gaps vs learning goals |
| Apply decay, find archive candidates |
| Generate daily note (portable Stop hook) |
Editor Support
Editor | Setup |
Claude Code |
|
Cursor | Copy |
Windsurf | Copy |
Cline / VS Code | Copy |
Project Structure
Cortex/
āāā mcp-server/ ā TypeScript MCP server (32 source files)
ā āāā src/
ā ā āāā tools/ ā 11 MCP tools
ā ā āāā graph/ ā Knowledge graph + decay + gap detection
ā ā āāā ingest/ ā Vault scanner, chunker, entity extractor
ā ā āāā embeddings/ ā ONNX pipeline (all-MiniLM-L6-v2)
ā ā āāā db/ ā SQLite + LanceDB
ā ā āāā resources/ ā MCP resource endpoints
ā āāā editors/ ā Config templates for other editors
ā āāā tests/
āāā src/
ā āāā hooks/ ā Bash hooks (SessionStart, Stop, etc.)
ā āāā lib/ ā Bash utilities
ā āāā templates/ ā Vault file templates
āāā skills/ ā Claude Code skills
āāā commands/ ā Slash commands
āāā docs/ ā Architecture docs
āāā tests/ ā Hook testsLicense
MIT ā see LICENSE
This server cannot be deployed
Maintenance
Related MCP Connectors
Private persistent memory for Claude, ChatGPT & Gemini via MCP - semantic search, zero-code setup.
Persistent memory, knowledge graph, task management and more for AI agents via MCP.
Persistent AI memory shared across Claude, ChatGPT, coding agents, and compatible MCP clients.
Personal knowledge graph as an AI memory layer over MCP - read, save, and link your memories.
Related MCP Servers
- AlicenseAqualityAmaintenanceCross-agent memory bridge for AI coding assistants. Persistent knowledge graph shared across 10 IDEs (Cursor, Windsurf, Claude Code, Codex, Copilot, Kiro, Antigravity, OpenCode, Trae, Gemini CLI) via MCP. 22 tools including team collaboration, auto-cleanup, mini-skills, session management, and workspace sync. 100% local, zero API keys required.91,053 npm856Apache 2.0
- AlicenseNot gradedqualityAmaintenanceSyncs Obsidian notes into a temporal knowledge graph and exposes 23 MCP tools for AI assistants to read, search, and write to your vault, enabling persistent memory across conversations.82MIT
- AlicenseNot gradedqualityBmaintenanceExposes a shared graph-based context engine as MCP tools for Claude, Copilot, and other AI agents, enabling knowledge ingestion, recall, search, and LLM-ready context assembly across sessions.1Apache 2.0
- AlicenseAqualityAmaintenanceGives any MCP client (Claude, ChatGPT, Cursor, and others) one shared knowledge-graph memory where agents record decisions, problems, and approaches together with their reasoning, then retrieve them by meaning rather than keyword. Spreading activation pulls in linked context and decay lets unused knowledge fade without deleting it.916Apache 2.0