Knowledge Graph Memory Server

Instructions

Implementation Reference

• index.ts:603-608 (handler)

  Core handler function in KnowledgeGraphManager that creates new entities: loads graph, filters duplicates by name, appends new entities, saves graph, returns created 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));
    graph.entities.push(...newEntities);
    await this.saveGraph(graph);
    return newEntities;

• index.ts:929-950 (schema)

  Input schema definition for the create_entities tool, specifying structure for array of entities with required fields: name, entityType, observations.

  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:24-29 (schema)

  TypeScript interface defining the Entity structure used by create_entities.

  interface Entity {
    name: string;
    entityType: string;
    observations: string[];
    metadata?: Metadata;  // Making metadata optional for backward compatibility
  }

• index.ts:926-951 (registration)

  Tool registration in the ListTools response, defining name, description, and input schema.

  {
    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:1223-1224 (handler)

  Dispatcher case in CallToolRequestSchema handler that invokes the createEntities method and formats JSON response.

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