Semantic Cache MCP server
io.github.CoderDayton/semantic-cache-mcp·v0.7.0·3 starsFile cache for coding agents: re-reads cost ~40 tokens, changed files return diffs.
3 stars206 downloads/wk
Reviews
Write oneNobody has reviewed Semantic Cache MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Semantic Cache MCP tools (15, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
batch_editApply many exact edits to one file in a single atomic call.
batch_readRead several files at once under a shared token budget.
clearEmpty the cache. Does not touch any project file.
deletewrite actionDelete one file or symlink and evict its cache entries.
editEdit one file by exact text replacement.
edit_previewShow where `old_string` would match in a file, without editing it.
globList files matching a glob and show which are already cached.
grepSearch cached file contents for an exact string or regex.
mainreadRead a file, returning as few tokens as possible. For 2+ files, use `batch_read`.
read_imageRead an image file so the model can see it.
searchFind cached files by keyword relevance (BM25 ranking).
statsReport cache health, token savings, and runtime diagnostics.
warmIndex files into the cache so `grep` and `search` can see them, returning counts only.
writewrite actionCreate a file or replace its entire contents.
Public scan report
scanner v0.1.10 · 2026-10-24 · same rubric, same numbers if you re-run it
- Code scan52 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 1 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Semantic Cache MCP compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 95% of 48,255 servers
- Tools
- 15
- the typical server has 7
- Tools that change things
- 13%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 3
- more than 80% of 28,688 servers
- Downloads a week
- 206
- more than 76% of 12,191 servers with a package
What its tools let an agent do: 11 read · 1 create · 2 change · 1 delete
Install Semantic Cache MCP in Claude Code, Cursor or VS Code
claude mcp add semantic-cache-mcp -- uvx semantic-cache-mcp
What the publisher says
From the Semantic Cache MCP repository's README, as published. We do not edit it. Read it on GitHub
Semantic Cache MCP
Stop paying for the same file twice. An MCP file cache for AI coding agents: a re-read costs ~40 tokens instead of the whole file.
<!-- mcp-name: io.github.CoderDayton/semantic-cache-mcp -->
Coding agents read the same files over and over: before an edit, after an edit, after every context compaction. A built-in Read sends the whole file each time. Semantic Cache MCP knows what your agent already holds. Measured on one 7,891-token file:
Across a 48-file project it saves 98.7% of re-read tokens, and an unchanged read takes 0.17 ms. It also gives your agent grep, BM25 search and glob over the cache, atomic edits with dry_run, and token-budgeted batch reads. Three runtime dependencies, no API keys, no GPU.
Quick start
You need uv. In Claude Code:
claude mcp add semantic-cache --scope user -- uvx semantic-cache-mcpAny other client (Cursor, Claude Desktop, and others that take mcpServers JSON):
{
"mcpServers": {
"semantic-cache": {
"command": "uvx",
"args": ["semantic-cache-mcp"]
}
}
}Configs for VS Code, Codex and OpenCode, and how to turn off the built-in file tools so the agent uses the cache: docs/clients.md.
How it works
Every file the server sends comes with a contenthash. The agent passes it back as knownhash on the next read:
flowchart LR
R["read(path, known_hash)"] --> M{"hash matches<br/>the file now?"}
M -- yes --> U["unchanged<br/>~40 tokens"]
M -- "no, older version" --> D["diff of changed lines"]
M -- "no hash" --> F["full file + content_hash"]- No stale content. Every read checks the file on disk first. unchanged only answers when the hash matches the current bytes.
- Forgetting is safe. After a compaction, the agent reads without the hash and gets the full file back.
- Large files become maps. A file over max_size returns an outline of its definitions, not a blind cut.
- Everything stays local. The cache is a SQLite file. One background daemon serves every client on your machine.
Tools
read · batchread · readimage · write · edit · batchedit · editpreview · delete · warm · grep · search · glob · stats · clear
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Semantic Cache MCP: common questions
- Is Semantic Cache MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Semantic Cache MCP safety report
- How do I install Semantic Cache MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Semantic Cache MCP need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Semantic Cache MCP maintained?
- The last commit was 12 days ago (2026-10-23). The latest release is v0.7.0.
- What can I use instead of Semantic Cache MCP?
- Servers from other publishers that do the same job: Sem MCP server and Token Optimizer MCP server.
- How does Semantic Cache MCP compare with other MCP servers?
- safety score 92/100 (higher than 95% of 48,255 servers); tools 15 (the typical server has 7); tools that change things 13% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Semantic Cache MCP
Same job from other publishers: the closest match first, then the best rated.
- SemEntity-level code intelligence: semantic diff, impact analysis, blame, and context for AI agentsnot reviewedWidely usedB
- Token OptimizerContext-window optimization: caching, compression & smart file tools that cut tokens 60-90%.not reviewedEstablishedC