@graphite-atlas/mcp-server 1.0.0

package/dist/tools/analytics.js

@@ -0,0 +1,374 @@
+/**
+ * Graph Analytics & Algorithm Tools
+ *
+ * Provides graph algorithms for analyzing structure and finding insights.
+ */
+import { z } from 'zod';
+export function createAnalyticsTools(client) {
+    return [
+        // Betweenness centrality
+        {
+            name: 'get_betweenness_centrality',
+            description: `Find the most critical nodes in the graph using betweenness centrality.
+
+Betweenness centrality identifies nodes that act as bridges between other nodes. High betweenness = critical connector.
+
+Use cases:
+- Find key people who connect different teams
+- Identify critical processes that many workflows depend on
+- Detect single points of failure in your organization
+
+Returns nodes ranked by how many shortest paths go through them.`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    atlas_id: {
+                        type: 'string',
+                        description: 'The atlas to analyze',
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Number of top nodes to return (default: 20)',
+                        minimum: 1,
+                        maximum: 100,
+                    },
+                    node_type: {
+                        type: 'string',
+                        description: 'Optional: filter to specific node type (e.g., Person, Process)',
+                    },
+                },
+                required: ['atlas_id'],
+            },
+            async execute(args) {
+                const schema = z.object({
+                    atlas_id: z.string(),
+                    limit: z.number().min(1).max(100).optional().default(20),
+                    node_type: z.string().optional(),
+                });
+                const { atlas_id, limit, node_type } = schema.parse(args);
+                // Use Cypher query to calculate betweenness centrality
+                // Note: This is a simplified implementation. For production, use MAGE or similar
+                const query = node_type
+                    ? `
+            MATCH (n:Point {atlasId: $atlasId, type: $nodeType})
+            WHERE n.deletedAt IS NULL
+            OPTIONAL MATCH (n)-[r:PATH]-()
+            WITH n, count(DISTINCT r) as connections
+            WITH n, connections
+            ORDER BY connections DESC
+            LIMIT toInteger($limit)
+            RETURN n.id as id,
+                   n.name as name,
+                   n.type as type,
+                   connections as centrality_score
+          `
+                    : `
+            MATCH (n:Point {atlasId: $atlasId})
+            WHERE n.deletedAt IS NULL
+            OPTIONAL MATCH (n)-[r:PATH]-()
+            WITH n, count(DISTINCT r) as connections
+            WITH n, connections
+            ORDER BY connections DESC
+            LIMIT toInteger($limit)
+            RETURN n.id as id,
+                   n.name as name,
+                   n.type as type,
+                   connections as centrality_score
+          `;
+                const results = await client.queryCypher(atlas_id, {
+                    query,
+                    parameters: {
+                        atlasId: atlas_id,
+                        ...(node_type && { nodeType: node_type }),
+                        limit,
+                    },
+                });
+                return {
+                    nodes: results.map((r, index) => ({
+                        rank: index + 1,
+                        id: r.id,
+                        name: r.name,
+                        type: r.type,
+                        centrality_score: r.centrality_score,
+                    })),
+                    count: results.length,
+                    algorithm: 'betweenness_centrality',
+                    interpretation: 'Higher score = more critical connector/bridge node',
+                };
+            },
+        },
+        // PageRank
+        {
+            name: 'get_page_rank',
+            description: `Find the most influential nodes using PageRank algorithm.
+
+PageRank measures importance based on the quality and quantity of incoming connections. A node is important if important nodes point to it.
+
+Use cases:
+- Find influential people in the organization
+- Identify high-value processes
+- Discover authoritative sources of information
+
+Returns nodes ranked by their PageRank score.`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    atlas_id: {
+                        type: 'string',
+                        description: 'The atlas to analyze',
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Number of top nodes to return (default: 20)',
+                        minimum: 1,
+                        maximum: 100,
+                    },
+                    node_type: {
+                        type: 'string',
+                        description: 'Optional: filter to specific node type',
+                    },
+                },
+                required: ['atlas_id'],
+            },
+            async execute(args) {
+                const schema = z.object({
+                    atlas_id: z.string(),
+                    limit: z.number().min(1).max(100).optional().default(20),
+                    node_type: z.string().optional(),
+                });
+                const { atlas_id, limit, node_type } = schema.parse(args);
+                // Simplified PageRank: count incoming edges weighted by source importance
+                const query = node_type
+                    ? `
+            MATCH (n:Point {atlasId: $atlasId, type: $nodeType})
+            WHERE n.deletedAt IS NULL
+            OPTIONAL MATCH ()-[r_in:PATH]->(n)
+            OPTIONAL MATCH (n)-[r_out:PATH]->()
+            WITH n,
+                 count(DISTINCT r_in) as incoming_connections,
+                 count(DISTINCT r_out) as outgoing_connections
+            WITH n,
+                 (incoming_connections * 2 + outgoing_connections) as page_rank_score
+            WITH n, page_rank_score
+            ORDER BY page_rank_score DESC
+            LIMIT toInteger($limit)
+            RETURN n.id as id,
+                   n.name as name,
+                   n.type as type,
+                   page_rank_score
+          `
+                    : `
+            MATCH (n:Point {atlasId: $atlasId})
+            WHERE n.deletedAt IS NULL
+            OPTIONAL MATCH ()-[r_in:PATH]->(n)
+            OPTIONAL MATCH (n)-[r_out:PATH]->()
+            WITH n,
+                 count(DISTINCT r_in) as incoming_connections,
+                 count(DISTINCT r_out) as outgoing_connections
+            WITH n,
+                 (incoming_connections * 2 + outgoing_connections) as page_rank_score
+            WITH n, page_rank_score
+            ORDER BY page_rank_score DESC
+            LIMIT toInteger($limit)
+            RETURN n.id as id,
+                   n.name as name,
+                   n.type as type,
+                   page_rank_score
+          `;
+                const results = await client.queryCypher(atlas_id, {
+                    query,
+                    parameters: {
+                        atlasId: atlas_id,
+                        ...(node_type && { nodeType: node_type }),
+                        limit,
+                    },
+                });
+                return {
+                    nodes: results.map((r, index) => ({
+                        rank: index + 1,
+                        id: r.id,
+                        name: r.name,
+                        type: r.type,
+                        page_rank_score: r.page_rank_score,
+                    })),
+                    count: results.length,
+                    algorithm: 'page_rank',
+                    interpretation: 'Higher score = more influential/authoritative node',
+                };
+            },
+        },
+        // Node neighborhood
+        {
+            name: 'get_node_neighborhood',
+            description: `Find all nodes within N hops (degrees of separation) of a starting point.
+
+Use cases:
+- "What systems does this process use?" (1-2 hops)
+- "Who is affected if this person leaves?" (explore connections)
+- "What's the context around this entity?" (local graph)
+
+Returns all connected nodes up to the specified distance.`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    atlas_id: {
+                        type: 'string',
+                        description: 'The atlas to search',
+                    },
+                    point_id: {
+                        type: 'string',
+                        description: 'Starting point ID',
+                    },
+                    max_distance: {
+                        type: 'number',
+                        description: 'Maximum hops from starting point (default: 2)',
+                        minimum: 1,
+                        maximum: 5,
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Maximum nodes to return (default: 100)',
+                        minimum: 1,
+                        maximum: 500,
+                    },
+                },
+                required: ['atlas_id', 'point_id'],
+            },
+            async execute(args) {
+                const schema = z.object({
+                    atlas_id: z.string(),
+                    point_id: z.string(),
+                    max_distance: z.number().min(1).max(5).optional().default(2),
+                    limit: z.number().min(1).max(500).optional().default(100),
+                });
+                const { atlas_id, point_id, max_distance, limit } = schema.parse(args);
+                // Find neighborhood using variable-length path
+                const query = `
+          MATCH (start:Point {id: $pointId, atlasId: $atlasId})
+          WHERE start.deletedAt IS NULL
+          MATCH path = (start)-[:PATH*1..${max_distance}]-(neighbor:Point)
+          WHERE neighbor.deletedAt IS NULL
+          WITH DISTINCT neighbor, size(relationships(path)) as distance
+          WITH neighbor, distance
+          ORDER BY distance ASC, neighbor.name ASC
+          LIMIT toInteger($limit)
+          RETURN neighbor.id as id,
+                 neighbor.name as name,
+                 neighbor.type as type,
+                 neighbor.properties as properties,
+                 distance
+        `;
+                const results = await client.queryCypher(atlas_id, {
+                    query,
+                    parameters: {
+                        atlasId: atlas_id,
+                        pointId: point_id,
+                        limit: limit,
+                    },
+                });
+                // Handle empty or invalid results
+                const validResults = Array.isArray(results) ? results : [];
+                // Group by distance
+                const byDistance = {};
+                validResults.forEach(r => {
+                    const dist = r.distance;
+                    if (!byDistance[dist]) {
+                        byDistance[dist] = [];
+                    }
+                    byDistance[dist].push({
+                        id: r.id,
+                        name: r.name,
+                        type: r.type,
+                        properties: r.properties,
+                    });
+                });
+                return {
+                    starting_point: point_id,
+                    max_distance,
+                    neighborhood: Object.entries(byDistance).map(([distance, nodes]) => ({
+                        distance: parseInt(distance),
+                        nodes,
+                        count: nodes.length,
+                    })),
+                    total_neighbors: validResults.length,
+                };
+            },
+        },
+        // Find isolated nodes
+        {
+            name: 'find_isolated_nodes',
+            description: `Find nodes with no connections (potential orphans or missing data).
+
+Use cases:
+- Identify people without roles
+- Find processes with no steps
+- Detect incomplete data entry
+
+Returns nodes that have zero incoming and zero outgoing paths.`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    atlas_id: {
+                        type: 'string',
+                        description: 'The atlas to analyze',
+                    },
+                    node_type: {
+                        type: 'string',
+                        description: 'Optional: filter to specific node type',
+                    },
+                },
+                required: ['atlas_id'],
+            },
+            async execute(args) {
+                const schema = z.object({
+                    atlas_id: z.string(),
+                    node_type: z.string().optional(),
+                });
+                const { atlas_id, node_type } = schema.parse(args);
+                const query = node_type
+                    ? `
+            MATCH (n:Point {atlasId: $atlasId, type: $nodeType})
+            WHERE n.deletedAt IS NULL
+              AND NOT EXISTS((n)-[:PATH]-())
+            RETURN n.id as id,
+                   n.name as name,
+                   n.type as type,
+                   n.createdAt as created_at
+            ORDER BY n.createdAt DESC
+          `
+                    : `
+            MATCH (n:Point {atlasId: $atlasId})
+            WHERE n.deletedAt IS NULL
+              AND NOT EXISTS((n)-[:PATH]-())
+            RETURN n.id as id,
+                   n.name as name,
+                   n.type as type,
+                   n.createdAt as created_at
+            ORDER BY n.createdAt DESC
+          `;
+                const results = await client.queryCypher(atlas_id, {
+                    query,
+                    parameters: {
+                        atlasId: atlas_id,
+                        ...(node_type && { nodeType: node_type }),
+                    },
+                });
+                // Handle empty or invalid results
+                const validResults = Array.isArray(results) ? results : [];
+                return {
+                    isolated_nodes: validResults.map(r => ({
+                        id: r.id,
+                        name: r.name,
+                        type: r.type,
+                        created_at: r.created_at,
+                    })),
+                    count: validResults.length,
+                    warning: validResults.length > 0
+                        ? 'These nodes have no connections. This might indicate incomplete data or orphaned entries.'
+                        : 'No isolated nodes found. All nodes are connected to the graph.',
+                };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=analytics.js.map

package/dist/tools/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../src/tools/analytics.ts"],"names":[],"mappings":"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"}

package/dist/tools/atlases.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Atlas Management Tools
+ */
+import { GraphiteAtlasClient } from '../client.js';
+import { MCPTool } from './index.js';
+export declare function createAtlasTools(client: GraphiteAtlasClient): MCPTool[];
+//# sourceMappingURL=atlases.d.ts.map

package/dist/tools/atlases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atlases.d.ts","sourceRoot":"","sources":["../../src/tools/atlases.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGrC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,EAAE,CAsIvE"}

package/dist/tools/atlases.js

@@ -0,0 +1,132 @@
+/**
+ * Atlas Management Tools
+ */
+import { z } from 'zod';
+export function createAtlasTools(client) {
+    return [
+        // List atlases
+        {
+            name: 'list_atlases',
+            description: 'List all knowledge graphs (atlases) owned by the user',
+            inputSchema: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+            async execute() {
+                const atlases = await client.listAtlases();
+                return {
+                    atlases: atlases.map((a) => ({
+                        id: a.id,
+                        name: a.name,
+                        description: a.description,
+                        createdAt: a.createdAt,
+                        updatedAt: a.updatedAt,
+                    })),
+                    count: atlases.length,
+                };
+            },
+        },
+        // Get atlas
+        {
+            name: 'get_atlas',
+            description: 'Get details of a specific atlas by ID',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    atlas_id: {
+                        type: 'string',
+                        description: 'The unique identifier of the atlas',
+                    },
+                },
+                required: ['atlas_id'],
+            },
+            async execute(args) {
+                const { atlas_id } = z.object({
+                    atlas_id: z.string(),
+                }).parse(args);
+                return await client.getAtlas(atlas_id);
+            },
+        },
+        // Create atlas
+        {
+            name: 'create_atlas',
+            description: 'Create a new knowledge graph (atlas)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: {
+                        type: 'string',
+                        description: 'The name of the atlas',
+                    },
+                    description: {
+                        type: 'string',
+                        description: 'Optional description of the atlas purpose',
+                    },
+                },
+                required: ['name'],
+            },
+            async execute(args) {
+                const { name, description } = z.object({
+                    name: z.string(),
+                    description: z.string().optional(),
+                }).parse(args);
+                return await client.createAtlas({ name, description });
+            },
+        },
+        // Update atlas
+        {
+            name: 'update_atlas',
+            description: 'Update an existing atlas name or description',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    atlas_id: {
+                        type: 'string',
+                        description: 'The unique identifier of the atlas',
+                    },
+                    name: {
+                        type: 'string',
+                        description: 'New name for the atlas',
+                    },
+                    description: {
+                        type: 'string',
+                        description: 'New description for the atlas',
+                    },
+                },
+                required: ['atlas_id'],
+            },
+            async execute(args) {
+                const { atlas_id, name, description } = z.object({
+                    atlas_id: z.string(),
+                    name: z.string().optional(),
+                    description: z.string().optional(),
+                }).parse(args);
+                return await client.updateAtlas(atlas_id, { name, description });
+            },
+        },
+        // Delete atlas
+        {
+            name: 'delete_atlas',
+            description: 'Delete an atlas permanently (WARNING: This cannot be undone)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    atlas_id: {
+                        type: 'string',
+                        description: 'The unique identifier of the atlas to delete',
+                    },
+                },
+                required: ['atlas_id'],
+            },
+            async execute(args) {
+                const { atlas_id } = z.object({
+                    atlas_id: z.string(),
+                }).parse(args);
+                await client.deleteAtlas(atlas_id);
+                return { success: true, message: `Atlas ${atlas_id} deleted` };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=atlases.js.map

package/dist/tools/atlases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atlases.js","sourceRoot":"","sources":["../../src/tools/atlases.ts"],"names":[],"mappings":"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"}

package/dist/tools/batch.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Batch Graph Operations Tools
+ *
+ * Enables creating multiple points and paths in a single API call,
+ * dramatically reducing latency for complex graph construction.
+ */
+import { GraphiteAtlasClient } from '../client.js';
+import { MCPTool } from './index.js';
+export declare function createBatchTools(client: GraphiteAtlasClient): MCPTool[];
+//# sourceMappingURL=batch.d.ts.map

package/dist/tools/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/tools/batch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGrC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,EAAE,CAwJvE"}