structured-code-search-mcplisted

# Structured Code Search MCP ## When to use Use when an agent needs to search, navigate, or extract code using structural queries — AST patterns, symbol lookups, or cross-file reference tracing — beyond what simple grep or glob can provide, via an MCP-backed code search server. ## Requirements / Checks - Prefer installed/pinned structured code search binaries over remote `npx -y ...@latest` execution. - Confirm the MCP client supports the required transport and method filtering. - Bound any search path to the current workspace unless the user explicitly approves otherwise. ## Workflow 1. **Choose the right tool for the query**: | Need | Tool | |---|---| | Text/boolean search across files | `search_code` | | Structural pattern (function shape, class with field) | `query_code` | | Extract a specific file, range, or symbol | `extract_code` | | List all symbols in target files | `symbols_code` | 2. **Bound scope before searching** — set base path and default paths to the workspace. Set a result limit before running broad queries (e.g., max 20 results). 3. **Iterate from broad to narrow**: - Start with `search_code` or `symbols_code` to identify candidate files. - Use `query_code` to narrow to the specific structural pattern. - Use `extract_code` to retrieve the exact code range needed. 4. **Filter methods at the server** — use allowlists for read/search methods. Block write and edit methods by default; only enable if code modification is explici