{"id":"softerist-heuristic-mcp","name":"heuristic-mcp","homepage":"https://www.npmjs.com/package/@softerist/heuristic-mcp","repo_url":"https://github.com/softerist/heuristic-mcp","category":"search","subcategories":[],"tags":["mcp","code-search","semantic-search","embeddings","ai-coding","nodejs","local-indexing","workspace-index"],"what_it_does":"An MCP server (Node.js) that scans a local workspace, builds a semantic index of code, and exposes tools for AI/editor clients to search relevant code in response to natural-language queries. It also maintains an up-to-date index (via file watching) and supports debugging/status/log commands.","use_cases":["Semantic code search from an MCP-capable IDE/agent","Find similar code snippets/functions across a repository","Recency-aware or proximity-enhanced retrieval for coding assistants","Accelerating navigation for large codebases via natural-language queries"],"not_for":["Serving remote users over the public internet (no clear auth/network security surfaced in the README)","Multi-tenant environments without strong operational isolation","Use cases requiring strict data residency/compliance guarantees (not documented here)","High-availability deployments where local indexing must not impact responsiveness"],"best_when":"You want local, editor-integrated semantic code search over a codebase and can accept initial indexing and local storage.","avoid_when":"You need a hosted/scalable SaaS with robust access controls, documented SLAs, and clearly specified network/security boundaries.","alternatives":["Other MCP code search servers (e.g., smart-coding-mcp forks/variants)","Local semantic search tools (embedding-based ripgrep alternatives) with a UI/CLI","Repository-aware search platforms (if you can use hosted solutions) such as Sourcegraph-style tools","IDE-native code search plus embeddings (where available)"],"af_score":38.5,"security_score":18.8,"reliability_score":28.8,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:32:54.590515+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":[],"oauth":false,"scopes":false,"notes":"The README does not describe any authentication mechanism for connecting to the MCP server. Since this appears intended to run locally and be enabled via a CLI command, auth may be implicit/omitted; this is a notable uncertainty."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing information in the provided README/manifest. As an npm package, it is likely paid only in terms of infrastructure/compute used to download models and index locally."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":38.5,"security_score":18.8,"reliability_score":28.8,"mcp_server_quality":55.0,"documentation_accuracy":45.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":20.0,"rate_limit_clarity":0.0,"tls_enforcement":0.0,"auth_strength":10.0,"scope_granularity":0.0,"dependency_hygiene":55.0,"secret_handling":40.0,"security_notes":"Security details are limited in the provided materials: no authentication/scopes, no TLS/network guidance, and no explicit secret-handling practices documented. Dependencies include @huggingface/transformers and other libraries; without lockfile/CVE info we can only score dependency hygiene as moderate-to-uncertain. The package will download embedding models at install or first run and scans local workspaces, which increases the need for careful operational isolation and least-privilege execution.","uptime_documented":0.0,"version_stability":55.0,"breaking_changes_history":30.0,"error_recovery":30.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Initial indexing may require significant resources and/or downloads (embedding model).","No explicit mention of network/auth boundaries; agents should assume local-only and carefully control where the process listens.","Cache/index state may affect results; use --cache and --status when behavior is unexpected."]}}