{"id":"johnhuang316-code-index-mcp","name":"code-index-mcp","homepage":null,"repo_url":"https://github.com/johnhuang316/code-index-mcp","category":"devtools","subcategories":[],"tags":["mcp","code-search","code-indexing","tree-sitter","repository-analysis","developer-tools"],"what_it_does":"A Model Context Protocol (MCP) server (Python) that indexes and analyzes local code repositories to help LLMs search for code patterns/files and generate structured summaries (shallow file index and optional deep symbol index via tree-sitter).","use_cases":["Code review assistance (find usages of APIs or patterns)","Refactoring guidance (where functions/classes are referenced)","Documentation generation from code structure","Debugging support (locate error handling and related code paths)","Architecture and component discovery in multi-language projects"],"not_for":["Handling remote/hosted repositories without local checkout (server is described as indexing a project path on the local filesystem)","A secure multi-tenant SaaS API where authentication/authorization between users is required","Use as a general-purpose code search engine without an MCP-capable client"],"best_when":"You have a local codebase and an MCP-capable AI client that can launch/connect to stdio-based MCP servers to perform search and symbol-aware analysis.","avoid_when":"You need fine-grained access control, multi-tenant isolation, or a cloud-hosted service with built-in auth/session management.","alternatives":["MCP-compatible code search/indexers (e.g., Sourcegraph-based workflows, ripgrep/ctags/tree-sitter pipelines)","Local tooling combinations: ripgrep/ugrep for search + language servers (LSP) for symbol extraction","IDE/indexer approaches (e.g., ctags/universal-ctags + AST tooling)"],"af_score":63.2,"security_score":23.2,"reliability_score":37.5,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:25:30.518744+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":"No authentication mechanisms are described; the MCP server is launched locally via stdio (uvx/command args) and operates on a provided project path."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Repository/package is MIT licensed; pricing for a hosted service is not described (appears to be a local tool)."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":63.2,"security_score":23.2,"reliability_score":37.5,"mcp_server_quality":88.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":"README mentions 'fail fast with clear errors' and provides troubleshooting guidance for file watcher issues, but does not show concrete MCP error schemas/messages.","auth_complexity":100.0,"rate_limit_clarity":0.0,"tls_enforcement":0.0,"auth_strength":20.0,"scope_granularity":0.0,"dependency_hygiene":55.0,"secret_handling":50.0,"security_notes":"Operates locally (no auth described), reducing credential exposure but increasing risk if misconfigured project paths or local permissions are used. README does not discuss data exfiltration, sandboxing, or logging/redaction of sensitive code contents. Dependencies include watchdog, tree-sitter, and mcp; specific CVE/status is not provided in the provided content.","uptime_documented":0.0,"version_stability":65.0,"breaking_changes_history":40.0,"error_recovery":45.0,"idempotency_support":"false","idempotency_notes":"No explicit idempotency guarantees are documented for indexing/search tools (e.g., whether repeated calls with same params are side-effect free).","pagination_style":"page-based","retry_guidance_documented":false,"known_agent_gotchas":["Deep symbol extraction may require running build_deep_index before get_file_summary to avoid needs_deep_index responses.","Regex search notes indicate the basic fallback is literal-only; regex=True may require an external native search tool to be installed/detected.","Auto-refresh relies on watchdog and OS file watching; in some environments it may fail without watchdog/polling configuration."]}}