describeNode() — mcp Function Reference

Architecture documentation for the describeNode() function in explore-function.ts from the mcp codebase.

Function typescript AnalysisTools CallStackTracing calls 3 called by 1

Entity Profile

AnalysisTools→ CallStackTracing→ describeNode() — mcp Function Reference

Dependency Diagram

graph TD
  129c63b6_9648_d4bb_3c4d_03d461c6ad68["describeNode()"]
  1767161e_720a_f6c8_bf00_3dc68740b823["handler()"]
  1767161e_720a_f6c8_bf00_3dc68740b823 -->|calls| 129c63b6_9648_d4bb_3c4d_03d461c6ad68
  d6ed9355_f977_306b_b0ef_d7220fdefe68["get()"]
  129c63b6_9648_d4bb_3c4d_03d461c6ad68 -->|calls| d6ed9355_f977_306b_b0ef_d7220fdefe68
  6666a1f2_0912_ade3_4b0e_42190c41cd97["normalizePath()"]
  129c63b6_9648_d4bb_3c4d_03d461c6ad68 -->|calls| 6666a1f2_0912_ade3_4b0e_42190c41cd97
  70483507_2c71_464c_1cbc_d74d4479f5e1["resolveDomain()"]
  129c63b6_9648_d4bb_3c4d_03d461c6ad68 -->|calls| 70483507_2c71_464c_1cbc_d74d4479f5e1
  style 129c63b6_9648_d4bb_3c4d_03d461c6ad68 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

src/tools/explore-function.ts lines 138–166

function describeNode(
  graph: IndexedGraph,
  nodeId: string,
  refSubdomain: string | null,
  subdomainToParent: Map<string, string>
): string {
  const node = graph.nodeById.get(nodeId);
  if (!node) return '(unknown)';

  const name = node.properties?.name as string || '(unknown)';
  const filePath = normalizePath(node.properties?.filePath as string || '');
  const { subdomain, domain } = resolveDomain(graph, nodeId, subdomainToParent);

  let loc = '';
  if (subdomain && domain) loc = `${subdomain} subsystem, ${domain} domain`;
  else if (subdomain) loc = `${subdomain} subsystem`;
  else if (domain) loc = `${domain} domain`;

  let line = `\`${name}\``;
  if (filePath) line += ` — ${filePath}`;
  if (loc) line += ` — ${loc}`;

  // Flag cross-subsystem edges
  if (refSubdomain && subdomain && subdomain !== refSubdomain) {
    line += '  ← DIFFERENT SUBSYSTEM';
  }

  return line;
}