RAG MCP Server

Instructions

Implementation Reference

• build/tools/graph/add-observations.js:38-64 (handler)

  Main handler for the 'add_observations' tool. Validates input parameters, invokes the knowledge graph manager to add observations, formats the result in MCP content format, and handles errors.

  export const addObservationsHandler = async (args) => {
      if (!args.observations || !Array.isArray(args.observations)) {
          throw new Error("The 'observations' parameter is required and must be an array");
      }
      // Valider chaque observation
      for (const observation of args.observations) {
          if (!observation.entityName || typeof observation.entityName !== 'string') {
              throw new Error("Each observation must have an 'entityName' string property");
          }
          if (!observation.contents || !Array.isArray(observation.contents)) {
              throw new Error("Each observation must have a 'contents' array property");
          }
      }
      try {
          const result = await knowledgeGraphManager.addObservations(args.observations);
          return {
              content: [{
                      type: "text",
                      text: JSON.stringify(result, null, 2)
                  }]
          };
      }
      catch (error) {
          console.error("Error in add_observations tool:", error);
          throw error;
      }
  };

• build/tools/graph/add-observations.js:7-34 (schema)

  Tool definition including name, description, and input schema for validating 'add_observations' tool calls.

  export const addObservationsTool = {
      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"],
      },
  };

• build/knowledge-graph/manager.js:56-69 (helper)

  Core helper method in KnowledgeGraphManager that loads the graph from JSONL, adds non-duplicate observations to specified entities, saves the graph, and returns results.

  async addObservations(observations) {
      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;
  }

• build/core/registry.js:144-151 (registration)

  Dynamic registration of tools (including 'add_observations') via AutoRegistry scanning tool directories and calling toolRegistry.register(tool, handler) for matching Tool/Handler exports.

      toolRegistry.register(tool, handler);
      this.registeredTools.add(tool.name);
      registeredCount++;
      if (this.config.verbose) {
          console.log(`✅ Outil enregistré automatiquement: ${tool.name} (${path})`);
      }
  }
  catch (error) {