arrayo avatar

Smart Context Mcp

arrayo/smart-context-mcp

If you're burning tokens on full file reads and massive grep results, this MCP gives you compressed alternatives. It indexes your codebase and exposes tools like smart_read (outline or focused chunks), smart_search (ranked, limited results), and smart_context (curated multi-file context). The real win is task checkpoints that persist between sessions so you don't re-explain the same context. Ships with workflow metrics showing 85-90% token reduction on debugging and refactoring tasks, though that requires multi-file work where you actually need the index. For single-file edits or when you already know what to touch, native tools are faster. Includes a reactive file watcher, semantic search via local embeddings, and declarative playbooks that chain multiple operations in one call.

GitHub stars
4
tools
15
transport
STDIO
last updated
Sep 18, 2026

Tools

15 tools

Public tool metadata for what this MCP can expose to an agent.

smart_readRead files in compressed modes instead of loading full content.

Read files in compressed modes instead of loading full content.

No parameter schema in public metadata yet.

smart_searchIntent-aware code search with ranked, deduplicated results and index boosting.

Intent-aware code search with ranked, deduplicated results and index boosting.

No parameter schema in public metadata yet.

smart_contextOne-call context builder: search + read + graph expansion.

One-call context builder: search + read + graph expansion.

No parameter schema in public metadata yet.

build_indexBuild a symbol index for the project (functions, classes, imports).

Build a symbol index for the project (functions, classes, imports).

No parameter schema in public metadata yet.

smart_metricsInspect token savings and usage statistics.

Inspect token savings and usage statistics.

No parameter schema in public metadata yet.

smart_summaryMaintain compressed task state across sessions.

Maintain compressed task state across sessions.

No parameter schema in public metadata yet.

smart_doctorRun one operational preflight across repo hygiene, SQLite health, compaction, and legacy cleanup.

Run one operational preflight across repo hygiene, SQLite health, compaction, and legacy cleanup.

No parameter schema in public metadata yet.

smart_statusDisplay current session context with progress visibility.

Display current session context with progress visibility.

No parameter schema in public metadata yet.

smart_editBatch edit multiple files with pattern replacement.

Batch edit multiple files with pattern replacement.

No parameter schema in public metadata yet.

smart_turnOrchestrate turn start/end with automatic task checkpoint recovery.

Orchestrate turn start/end with automatic task checkpoint recovery.

No parameter schema in public metadata yet.

smart_read_batchRead multiple files in one call.

Read multiple files in one call.

No parameter schema in public metadata yet.

smart_shellSafe diagnostic command execution (allowlisted commands only).

Safe diagnostic command execution (allowlisted commands only).

No parameter schema in public metadata yet.

warm_cachePreload frequently accessed files into OS cache.

Preload frequently accessed files into OS cache.

No parameter schema in public metadata yet.

git_blameFunction-level code attribution.

Function-level code attribution.

No parameter schema in public metadata yet.

cross_projectShare context across monorepos and microservices.

Share context across monorepos and microservices.

No parameter schema in public metadata yet.

Sponsors

Readme

smart-context-mcp

MCP server that reduces AI agent token usage by up to 90% through intelligent context compression (measured on this project).

npm version MIT License

Smart Context MCP on MCPRush

What it is

An MCP (Model Context Protocol) server that provides specialized tools for reading, searching, and managing code context efficiently. Instead of loading full files or returning massive search results, it compresses information while preserving what matters for the task.


View the full README on GitHub

Details

Repository
github.com/arrayo/smart-context-mcp
Categories
AI & LLM Tools, Productivity & Office
Package
smart-context-mcp
Transport
STDIO
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1c5huracan avatarMeyhem — MCP Server Discovery & Agent Searchc5huracan/meyhemDiscover 6,700+ MCP servers and 15,000+ OpenClaw skills. Agent-native search with outcome ranking.4stars
2bananacrystal avatarBananaCrystal: FX rates, swaps and payments in 140+ currenciesbananacrystal/mcp-server-bananacrystalGive your AI agent a wallet: live FX rates, swaps and payments in 140+ local currencies.4stars
3feedthrough avatarFeedthroughfeedthrough/feedthroughDebug bridge inside your web app: an agent reads the DOM, console and network. Any browser.4stars
4astrotomic avatarArchivist AIastrotomic/mcp.myarchivist.aiOfficial remote MCP server for Archivist AI TTRPG campaign memory: characters, sessions, and more.0stars
5korext avatarKorext: AI Code Governancekorext/enforce-actionGovernance copilot for AI-assisted coding. 72 packs, 532 rules, proof bundles.0stars
6glim-sh avatarglim.shglim-sh/glim-mcpGive your agent live data from Twitter, Reddit, the web and GitHub. No API keys, no scraping stack.4stars