About Heuristic MCP
Heuristic MCP is an MCP server published by softerist in the AI category: enhanced MCP server for semantic code search with call-graph proximity, recency ranking, and find-similar-code. Built for AI coding assistants.
The repository has 20 stars and 2 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/softerist/heuristic-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Heuristic MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 2 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- !No dynamic code executionSource scan found eval or shell execution. Review how tool inputs reach it before granting credentials.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
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-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
README fetched from the repository 2 hours ago. The original is authoritative.