CodeAnalysis MCP Server

Implementation Reference

• src/features/knowledge-graph/index.ts:108-142 (handler)

  The handler implementation for the 'export-knowledge-graph' MCP tool. It queries the full knowledge graph for the repository and exports it in the specified format (json, mermaid, dot, cypher) using the exportKnowledgeGraph helper.

  server.tool(
    "export-knowledge-graph",
    {
      repositoryUrl: z.string(),
      format: z.enum(["json", "mermaid", "dot", "cypher"]).default("json")
    },
    async ({ repositoryUrl, format }) => {
      try {
        // First query the graph to get all nodes and relationships
        const results = await queryKnowledgeGraph({
          query: "MATCH (n)-[r]-(m) WHERE n.repository = $repositoryUrl RETURN n, r, m",
          repositoryUrl
        });
        
        // Export in requested format
        const exported = await exportKnowledgeGraph(results, format);
        
        return {
          content: [{
            type: "text",
            text: exported,
            _metadata: format === "mermaid" ? { format: "mermaid" } : undefined
          }]
        };
      } catch (error) {
        return {
          content: [{
            type: "text",
            text: `Error exporting knowledge graph: ${(error as Error).message}`
          }],
          isError: true
        };
      }
    }
  );

• src/features/knowledge-graph/index.ts:111-113 (schema)

  Input schema for the export-knowledge-graph tool using Zod validation.

    repositoryUrl: z.string(),
    format: z.enum(["json", "mermaid", "dot", "cypher"]).default("json")
  },

• src/features/knowledge-graph/index.ts:107-142 (registration)

  Registration of the export-knowledge-graph tool on the MCP server within registerKnowledgeGraphFeatures.

  // Tool to export the knowledge graph
  server.tool(
    "export-knowledge-graph",
    {
      repositoryUrl: z.string(),
      format: z.enum(["json", "mermaid", "dot", "cypher"]).default("json")
    },
    async ({ repositoryUrl, format }) => {
      try {
        // First query the graph to get all nodes and relationships
        const results = await queryKnowledgeGraph({
          query: "MATCH (n)-[r]-(m) WHERE n.repository = $repositoryUrl RETURN n, r, m",
          repositoryUrl
        });
        
        // Export in requested format
        const exported = await exportKnowledgeGraph(results, format);
        
        return {
          content: [{
            type: "text",
            text: exported,
            _metadata: format === "mermaid" ? { format: "mermaid" } : undefined
          }]
        };
      } catch (error) {
        return {
          content: [{
            type: "text",
            text: `Error exporting knowledge graph: ${(error as Error).message}`
          }],
          isError: true
        };
      }
    }
  );

• src/features/knowledge-graph/graph-manager.ts:305-324 (helper)

  Helper function that performs the actual export formatting, called by the tool handler. Dispatches to format-specific exporters.

  export async function exportKnowledgeGraph(results: GraphQueryResult, format: string): Promise<string> {
    const { nodes, relationships } = results;
    
    switch (format) {
      case "json":
        return JSON.stringify({ nodes, relationships }, null, 2);
      
      case "mermaid":
        return exportToMermaid(nodes, relationships);
      
      case "dot":
        return exportToDot(nodes, relationships);
      
      case "cypher":
        return exportToCypher(nodes, relationships);
      
      default:
        throw new Error(`Unsupported export format: ${format}`);
    }
  }