searchSymbolHandler() — mcp Function Reference

Source Code

src/tools/tool-variants.ts lines 49–83

const searchSymbolHandler: HandlerFunction = async (client, args, defaultWorkdir) => {
  const query = typeof args?.query === 'string' ? args.query.trim() : '';
  if (!query) {
    return asErrorResult({
      type: 'validation_error',
      message: 'Missing required "query" parameter.',
      code: 'MISSING_QUERY',
      recoverable: false,
      suggestion: 'Provide the name of a function, class, or method to search for.',
    });
  }

  const rawDir = args?.directory as string | undefined;
  const directory = (rawDir && rawDir.trim()) || defaultWorkdir || process.cwd();

  let graph: IndexedGraph;
  try {
    graph = await resolveOrFetchGraph(client, directory);
  } catch (error: any) {
    return asErrorResult({ type: 'internal_error', message: error.message, code: 'GRAPH_ERROR', recoverable: false });
  }

  const matches = findSymbol(graph, query);
  if (matches.length === 0) {
    return asTextContentResult(`No symbol matching "${query}" found.`);
  }

  // Always brief — keep response small so model doesn't "wait for it"
  const parts = matches.slice(0, 3).map(node => renderBriefSymbolContext(graph, node));
  let result = parts.join('\n---\n\n');
  if (matches.length > 3) {
    result += `\n\n*... and ${matches.length - 3} more matches.*`;
  }
  return asTextContentResult(result);
};