📦
heuristic
An enhanced MCP server providing intelligent semantic code search with find-similar-code, recency ranking, and improved chunking. Fork of smart-coding-mcp.
0 installs
Trust: 39 — Low
Ai
Installation
npx @softerist/heuristic-mcpAsk AI about heuristic
Powered by Claude · Grounded in docs
I know everything about heuristic. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
Heuristic MCP Server
Heuristic MCP adds smart code search to your editor or MCP client.
Requirements
- 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
Install
npm install -g @softerist/heuristic-mcp
Then enable it for your client:
heuristic-mcp --start
If your editor was already open, reload it once.
How It Works
- 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.
Basic Commands
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.
Advanced Docs
Detailed configuration, tool reference, troubleshooting, and release notes are in:
License: MIT