@softerist/heuristic-mcp
v3.2.13
Published
An enhanced MCP server providing intelligent semantic code search with find-similar-code, recency ranking, and improved chunking. Fork of smart-coding-mcp.
Maintainers
Readme
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-mcpThen enable it for your client:
heuristic-mcp --startIf 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 --stopUse 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
