Knowledge Graph Memory Server

Instructions

Implementation Reference

• index.ts:109-122 (handler)

  The core handler function in KnowledgeGraphManager that executes the add_observations tool logic: loads the graph, adds new unique observations to specified entities, persists changes, and returns results.

  async addObservations(observations: { entityName: string; contents: string[] }[]): Promise<{ entityName: string; addedObservations: string[] }[]> {
    const graph = await this.loadGraph();
    const results = observations.map(o => {
      const entity = graph.entities.find(e => e.name === o.entityName);
      if (!entity) {
        throw new Error(`Entity with name ${o.entityName} not found`);
      }
      const newObservations = o.contents.filter(content => !entity.observations.includes(content));
      entity.observations.push(...newObservations);
      return { entityName: o.entityName, addedObservations: newObservations };
    });
    await this.saveGraph(graph);
    return results;
  }

• index.ts:335-355 (schema)

  The input schema definition for the add_observations tool, specifying the structure of observations array with entityName and contents.

  inputSchema: {
    type: "object",
    properties: {
      observations: {
        type: "array",
        items: {
          type: "object",
          properties: {
            entityName: { type: "string", description: "The name of the entity to add the observations to" },
            contents: {
              type: "array",
              items: { type: "string" },
              description: "An array of observation contents to add"
            },
          },
          required: ["entityName", "contents"],
        },
      },
    },
    required: ["observations"],
  },

• index.ts:332-356 (registration)

  Registration of the add_observations tool in the ListToolsRequestSchema handler, including name, description, and input schema.

  {
    name: "add_observations",
    description: "Add new observations to existing entities in the knowledge graph",
    inputSchema: {
      type: "object",
      properties: {
        observations: {
          type: "array",
          items: {
            type: "object",
            properties: {
              entityName: { type: "string", description: "The name of the entity to add the observations to" },
              contents: {
                type: "array",
                items: { type: "string" },
                description: "An array of observation contents to add"
              },
            },
            required: ["entityName", "contents"],
          },
        },
      },
      required: ["observations"],
    },
  },

• index.ts:518-519 (registration)

  Dispatch/registration in the CallToolRequestSchema switch statement that invokes the handler for add_observations tool calls.

  case "add_observations":
    return { content: [{ type: "text", text: JSON.stringify(await knowledgeGraphManager.addObservations(args.observations as { entityName: string; contents: string[] }[]), null, 2) }] };