LocalNest MCP

Instructions

Implementation Reference

• src/mcp/tools/retrieval.js:321-358 (handler)

  Registration and handler definition for the localnest_search_hybrid tool, which delegates to the search.searchHybrid service method.

  registerJsonTool(
    'localnest_search_hybrid',
    {
      title: 'Search Hybrid',
      description: 'Run lexical + semantic retrieval and return RRF-ranked results.',
      inputSchema: {
        query: z.string().min(1),
        project_path: z.string().optional(),
        all_roots: z.boolean().default(false),
        glob: z.string().default('*'),
        max_results: z.number().int().min(1).max(1000).default(defaultMaxResults),
        case_sensitive: z.boolean().default(false),
        min_semantic_score: z.number().min(0).max(1).default(0.05),
        auto_index: z.boolean().default(true),
        use_reranker: z.boolean().default(false)
      },
      annotations: {
        readOnlyHint: false,
        destructiveHint: false,
        idempotentHint: false,
        openWorldHint: false
      }
    },
    async ({ query, project_path, all_roots, glob, max_results, case_sensitive, min_semantic_score, auto_index, use_reranker }) => normalizeSearchHybridResult(
      await search.searchHybrid({
        query,
        projectPath: project_path,
        allRoots: all_roots,
        glob,
        maxResults: max_results,
        caseSensitive: case_sensitive,
        minSemanticScore: min_semantic_score,
        autoIndex: auto_index,
        useReranker: use_reranker
      }),
      query
    )
  );