README.md
Semantic Intelligence for Large-Scale Engineering.
Context+
Semantic Intelligence for Large-Scale Engineering.
Context+ is an MCP server designed for developers who demand 99% accuracy. By combining RAG, Tree-sitter AST, Spectral Clustering, and Obsidian-style linking, Context+ turns a massive codebase into a searchable, hierarchical feature graph.
https://github.com/user-attachments/assets/a97a451f-c9b4-468d-b036-15b65fc13e79
Tools
Discovery
| Tool | Description |
|---|---|
get_context_tree |
Structural AST tree of a project with file headers and symbol ranges (line numbers for functions/classes/methods). Dynamic pruning shrinks output automatically. |
get_file_skeleton |
Function signatures, class methods, and type definitions with line ranges, without reading full bodies. Shows the API surface. |
semantic_code_search |
Search by meaning, not exact text. Uses embeddings over file headers/symbols and returns matched symbol definition lines. |
semantic_identifier_search |
Identifier-level semantic retrieval for functions/classes/variables with ranked call sites and line numbers. |
semantic_navigate |
Browse codebase by meaning using spectral clustering. Groups semantically related files into labeled clusters. |
Analysis
| Tool | Description |
|---|---|
get_blast_radius |
Trace every file and line where a symbol is imported or used. Prevents orphaned references. |
run_static_analysis |
Run native linters and compilers to find unused variables, dead code, and type errors. Supports TypeScript, Python, Rust, Go. |
Code Ops
| Tool | Description |
|---|---|
propose_commit |
The only way to write code. Validates against strict rules before saving. Creates a shadow restore point before writing. |
get_feature_hub |
Obsidian-style feature hub navigator. Hubs are .md files with [[wikilinks]] that map features to code files. |
Version Control
| Tool | Description |
|---|---|
list_restore_points |
List all shadow restore points created by propose_commit. Each captures file state before AI changes. |
undo_change |
Restore files to their state before a specific AI change. Uses shadow restore points. Does not affect git. |
Memory & RAG
| Tool | Description |
|---|---|
upsert_memory_node |
Create or update a memory node (concept, file, symbol, note) with auto-generated embeddings. |
create_relation |
Create typed edges between nodes (relates_to, depends_on, implements, references, similar_to, contains). |
search_memory_graph |
Semantic search with graph traversal — finds direct matches then walks 1st/2nd-degree neighbors. |
prune_stale_links |
Remove decayed edges (e^(-λt) below threshold) and orphan nodes with low access counts. |
add_interlinked_context |
Bulk-add nodes with auto-similarity linking (cosine ≥ 0.72 creates edges automatically). |
retrieve_with_traversal |
Start from a node and walk outward — returns all reachable neighbors scored by decay and depth. |
Setup
Quick Start (npx / bunx)
No installation needed. Add Context+ to your IDE MCP config.
For Claude Code, Cursor, and Windsurf, use mcpServers:
{
"mcpServers": {
"contextplus": {
"command": "bunx",
"args": ["contextplus"],
"env": {
"OLLAMA_EMBED_MODEL": "no
Tools (17)
get_context_treeStructural AST tree of a project with file headers and symbol ranges.get_file_skeletonFunction signatures, class methods, and type definitions with line ranges.semantic_code_searchSearch by meaning using embeddings over file headers and symbols.semantic_identifier_searchIdentifier-level semantic retrieval for functions, classes, and variables.semantic_navigateBrowse codebase by meaning using spectral clustering.get_blast_radiusTrace every file and line where a symbol is imported or used.run_static_analysisRun native linters and compilers to find unused variables, dead code, and type errors.propose_commitValidates code against strict rules before saving and creates a shadow restore point.get_feature_hubObsidian-style feature hub navigator for mapping features to code files.list_restore_pointsList all shadow restore points created by propose_commit.undo_changeRestore files to their state before a specific AI change.upsert_memory_nodeCreate or update a memory node with auto-generated embeddings.create_relationCreate typed edges between nodes.search_memory_graphSemantic search with graph traversal.prune_stale_linksRemove decayed edges and orphan nodes.add_interlinked_contextBulk-add nodes with auto-similarity linking.retrieve_with_traversalStart from a node and walk outward to return reachable neighbors.Environment Variables
OLLAMA_EMBED_MODELThe embedding model to use for semantic search and memory nodes.Configuration
claude_desktop_config.json
{"mcpServers": {"contextplus": {"command": "bunx", "args": ["contextplus"], "env": {"OLLAMA_EMBED_MODEL": "nomic-embed-text"}}}}Try it
→Show me the structural AST tree for the authentication module.
→Find all files related to the payment processing logic using semantic search.
→What is the blast radius if I modify the User class constructor?
→List all recent shadow restore points and undo the last change.
→Create a memory node for the new API integration and link it to the existing service layer.