Knowledge Graph Memory Server

Instructions

Implementation Reference

• index.ts:671-696 (handler)

  Core handler function implementing the search logic: loads graph, filters entities by query match in name/type/observations, filters connected relations, caches result.

  async searchNodes(query: string): Promise<KnowledgeGraph> {
    const cacheKey = this.getCacheKey('searchNodes', { query });
    const cached = this.cache.get<KnowledgeGraph>(cacheKey);
    if (cached) return cached;
  
    const graph = await this.loadGraph();
  
    const filteredEntities = graph.entities.filter(e =>
      e.name.toLowerCase().includes(query.toLowerCase()) ||
      e.entityType.toLowerCase().includes(query.toLowerCase()) ||
      e.observations.some(o => o.toLowerCase().includes(query.toLowerCase()))
    );
  
    const filteredEntityNames = new Set(filteredEntities.map(e => e.name));
    const filteredRelations = graph.relations.filter(r =>
      filteredEntityNames.has(r.from) && filteredEntityNames.has(r.to)
    );
  
    const result = {
      entities: filteredEntities,
      relations: filteredRelations,
    };
  
    this.cache.set(cacheKey, result);
    return result;
  }

• index.ts:1070-1080 (registration)

  Tool registration in the list of tools returned by ListToolsRequestSchema, including name, description, and input schema.

  {
    name: "search_nodes",
    description: "Search for nodes in the knowledge graph based on a query",
    inputSchema: {
      type: "object",
      properties: {
        query: { type: "string", description: "The search query to match against entity names, types, and observation content" },
      },
      required: ["query"],
    },
  },

• index.ts:1240-1241 (handler)

  Dispatcher case in CallToolRequestSchema handler that invokes the searchNodes method with tool arguments and formats response.

  case "search_nodes":
    return { content: [{ type: "text", text: JSON.stringify(await knowledgeGraphManager.searchNodes(args.query as string), null, 2) }] };

• index.ts:1073-1079 (schema)

  Input schema definition specifying the required 'query' string parameter.

  inputSchema: {
    type: "object",
    properties: {
      query: { type: "string", description: "The search query to match against entity names, types, and observation content" },
    },
    required: ["query"],
  },