Knowledge Graph Memory Server

Instructions

Implementation Reference

• index.ts:80-91 (handler)

  Core handler function in KnowledgeGraphManager that implements the logic for creating new entities: loads graph, filters out duplicates by name, adds createdAt and version, appends to graph, saves to file, returns new entities.

  async createEntities(entities: Entity[]): Promise<Entity[]> {
    const graph = await this.loadGraph();
    const newEntities = entities.filter(e => !graph.entities.some(existingEntity => existingEntity.name === e.name))
      .map(e => ({
        ...e,
        createdAt: new Date().toISOString(),
        version: e.version || 1
      }));
    graph.entities.push(...newEntities);
    await this.saveGraph(graph);
    return newEntities;
  }

• index.ts:285-309 (registration)

  Tool registration in ListToolsRequestSchema handler, defining name, description, and input schema for create_entities.

    name: "create_entities",
    description: "Create multiple new entities in the knowledge graph",
    inputSchema: {
      type: "object",
      properties: {
        entities: {
          type: "array",
          items: {
            type: "object",
            properties: {
              name: { type: "string", description: "The name of the entity" },
              entityType: { type: "string", description: "The type of the entity" },
              observations: {
                type: "array",
                items: { type: "string" },
                description: "An array of observation contents associated with the entity"
              },
            },
            required: ["name", "entityType", "observations"],
          },
        },
      },
      required: ["entities"],
    },
  },

• index.ts:514-515 (handler)

  MCP tool dispatch handler in CallToolRequestSchema that invokes the createEntities method with parsed arguments and formats response.

  case "create_entities":
    return { content: [{ type: "text", text: JSON.stringify(await knowledgeGraphManager.createEntities(args.entities as Entity[]), null, 2) }] };

• index.ts:32-37 (schema)

  TypeScript interface defining the Entity type used as input for create_entities.

    name: string;
    entityType: string;
    observations: string[];
    createdAt: string;
    version: number;
  }

• index.ts:287-308 (schema)

  JSON Schema for input validation of create_entities tool, specifying structure of entities array.

  inputSchema: {
    type: "object",
    properties: {
      entities: {
        type: "array",
        items: {
          type: "object",
          properties: {
            name: { type: "string", description: "The name of the entity" },
            entityType: { type: "string", description: "The type of the entity" },
            observations: {
              type: "array",
              items: { type: "string" },
              description: "An array of observation contents associated with the entity"
            },
          },
          required: ["name", "entityType", "observations"],
        },
      },
    },
    required: ["entities"],
  },