aieph — Claude Code MCP server: a shared answer cache
A shared cache that answers an AI assistant's web lookup before it happens. On a miss the original search runs untouched.
claude mcp add --transport http aieph https://aieph.dev/mcpWhat aieph does
aieph sits in front of web search. A hook asks the shared cache whether the answer already exists, and hands it back if it does. A miss, a timeout or an error changes nothing — the lookup proceeds the way it always would.
On Claude the wiring is one PreToolUse hook matching WebSearch|WebFetch in ~/.claude/settings.json, running node /path/to/aieph/hook/aieph-cache.mjs. Node.js 18+ is required. There is no signup and no API key. Two environment variables are optional: AIEPH_API_BASE and LOOKUP_TIMEOUT_MS. To undo it, drop the PreToolUse block.
Only the query text leaves your machine. The cache is young, so plenty of lookups will miss, and a miss is meant to feel like no cache at all. A separate local-only memory CLI lives in cli/ and never leaves the machine.
What it helps with
- stop re-searching the same error message
- reuse an answer about a library's behaviour
- cut down web lookups while debugging
- keep a project fact in local memory across sessions
- revert to the plain setup by deleting one block
Example prompts for the agent
- Wire the aieph hook for WebSearch into
~/.claude/settings.json - Check whether the aieph cache has anything on this build error
- Save to aieph local memory that the project builds with
pnpm
How to install aieph
Platform CLI: remote server
claude mcp add --transport http aieph https://aieph.dev/mcpPlatform CLI: remote server
codex mcp add aieph --url https://aieph.dev/mcpConfig file
{
"mcpServers": {
"aieph": {
"url": "https://aieph.dev/mcp"
}
}
}Config file
{
"servers": {
"aieph": {
"type": "http",
"url": "https://aieph.dev/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http aieph https://aieph.dev/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about aieph
How do I install aieph in Claude Code?
Run claude mcp add --transport http aieph https://aieph.dev/mcp. For the search cache, also clone the repo and add the PreToolUse hook to ~/.claude/settings.json.
What does aieph do?
It checks a shared cache before a web search and returns the answer if one is already stored. Otherwise the search runs as usual.
What does aieph need to run?
Node.js 18+. No account and no API key. Only the search query text is sent out.
