findDefinitionHandler() — mcp Function Reference

Source Code

src/tools/tool-variants.ts lines 113–150

const findDefinitionHandler: HandlerFunction = async (client, args, defaultWorkdir) => {
  const name = typeof args?.name === 'string' ? args.name.trim() : '';
  if (!name) {
    return asErrorResult({
      type: 'validation_error',
      message: 'Missing required "name" parameter.',
      code: 'MISSING_NAME',
      recoverable: false,
    });
  }

  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, name);
  if (matches.length === 0) {
    return asTextContentResult(`No symbol matching "${name}" found.`);
  }

  // Ultra-compact: just location lines
  const lines = matches.slice(0, 5).map(node => {
    const sym = node.properties?.name as string || '(unknown)';
    const fp = normalizePath(node.properties?.filePath as string || '');
    const start = node.properties?.startLine as number || 0;
    const end = node.properties?.endLine as number || 0;
    const kind = node.labels?.[0]?.toLowerCase() || 'symbol';
    return `${sym} (${kind}) — ${fp}:${start}-${end}`;
  });

  return asTextContentResult(lines.join('\n'));
};