📦

Heuristic MCP

Enhanced MCP server for semantic code search with call-graph proximity, recency ranking, and find-similar-code. Built for AI coding assistants.

0 installs

21 stars

Trust: 75 — Good

Ai

Installation

npx heuristic-mcp

Ask AI about Heuristic MCP

Powered by Claude · Grounded in docs

I know everything about Heuristic MCP. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Heuristic MCP adds smart code search to your editor or MCP client.

Node.js 18+
npm (for global install)
Internet access at least once to download the embedding model (if install-time download is skipped, it downloads on first run)
64-bit Node.js recommended for native ONNX performance; on Windows, install Microsoft Visual C++ 2015-2022 Redistributable (x64) if native bindings fail

npm install -g @softerist/heuristic-mcp

Then enable it for your client:

heuristic-mcp --start

If your editor was already open, reload it once.

The server scans your workspace and builds a searchable index of your code.
IDE AI models/MCP tools query that index using plain language so you can find relevant code quickly.
Results improve as your index stays up to date with project changes.

heuristic-mcp --status
heuristic-mcp --logs
heuristic-mcp --stop

Use heuristic-mcp --status first if something looks off. Use heuristic-mcp --cache to see the cache status or file index progress.

Detailed configuration, tool reference, troubleshooting, and release notes are in:

License: MIT