DOOR Knowledge MCP Server

Instructions

Implementation Reference

• door-knowledge-mcp-server.js:140-197 (handler)

  Main handler function for the 'search_door_knowledge' MCP tool. Parses arguments, loads search index, filters documents by query and optional category using keyword matching, scores relevance, limits results, formats a markdown response with document previews, or no-results message.

  async searchDoorKnowledge(args) {
    const { query, category, limit = 10 } = args;
    const index = await this.loadSearchIndex();
  
    const searchTerm = query.toLowerCase();
    let results = index.documents.filter(doc => {
      // Filtrar por categoría si se especifica
      if (category && doc.category.toLowerCase() !== category.toLowerCase()) {
        return false;
      }
      // Buscar en keywords
      return doc.keywords.includes(searchTerm);
    });
  
    // Ordenar por relevancia (número de coincidencias)
    results = results
      .map(doc => {
        const matches = (doc.keywords.match(new RegExp(searchTerm.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'gi')) || []).length;
        return { ...doc, relevance: matches };
      })
      .sort((a, b) => b.relevance - a.relevance)
      .slice(0, limit);
  
    if (results.length === 0) {
      return {
        content: [
          {
            type: 'text',
            text: `No se encontraron resultados para: "${query}"\n\nIntenta con otros términos o usa list_door_categories para ver las categorías disponibles.`,
          },
        ],
      };
    }
  
    // Formatear resultados de manera concisa
    let response = `🔍 Encontrados ${results.length} resultados para: "${query}"\n\n`;
  
    results.forEach((doc, i) => {
      response += `${i + 1}. **${doc.title}**\n`;
      response += `   📁 ${doc.category}${doc.subcategory ? ` > ${doc.subcategory}` : ''}\n`;
      response += `   📄 ID: \`${doc.id}\` | ${doc.pages} páginas\n`;
      if (doc.summary) {
        response += `   📝 ${doc.summary.substring(0, 150)}${doc.summary.length > 150 ? '...' : ''}\n`;
      }
      response += `\n`;
    });
  
    response += `\n💡 Usa get_door_document con el ID para ver el contenido completo.`;
  
    return {
      content: [
        {
          type: 'text',
          text: response,
        },
      ],
    };
  }

• door-knowledge-mcp-server.js:69-87 (schema)

  Input schema definition for the search_door_knowledge tool, specifying query (required string), optional category and limit parameters.

  inputSchema: {
    type: 'object',
    properties: {
      query: {
        type: 'string',
        description: 'Término de búsqueda (ej: "installation", "latch m", "intercom", "wiring")',
      },
      category: {
        type: 'string',
        description: 'Filtrar por categoría específica (opcional). Usa list_door_categories para ver las disponibles.',
      },
      limit: {
        type: 'number',
        description: 'Número máximo de resultados (default: 10)',
        default: 10,
      },
    },
    required: ['query'],
  },

• door-knowledge-mcp-server.js:64-119 (registration)

  Registration of the search_door_knowledge tool in the MCP server's tool list (ListToolsRequestSchema handler) including name, description, and schema. Also shows the dispatch in CallToolRequestSchema handler that routes to the searchDoorKnowledge method.

  this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: [
      {
        name: 'search_door_knowledge',
        description: 'Busca documentos en la DOOR Knowledge Base por palabras clave, categorías o contenido. Retorna una lista de documentos relevantes con resúmenes. Es MUY RÁPIDO porque usa un índice pre-generado.',
        inputSchema: {
          type: 'object',
          properties: {
            query: {
              type: 'string',
              description: 'Término de búsqueda (ej: "installation", "latch m", "intercom", "wiring")',
            },
            category: {
              type: 'string',
              description: 'Filtrar por categoría específica (opcional). Usa list_door_categories para ver las disponibles.',
            },
            limit: {
              type: 'number',
              description: 'Número máximo de resultados (default: 10)',
              default: 10,
            },
          },
          required: ['query'],
        },
      },
      {
        name: 'get_door_document',
        description: 'Obtiene el contenido completo de un documento específico de la DOOR Knowledge Base. Usa el ID obtenido de search_door_knowledge.',
        inputSchema: {
          type: 'object',
          properties: {
            document_id: {
              type: 'string',
              description: 'ID del documento (obtenido de search_door_knowledge)',
            },
          },
          required: ['document_id'],
        },
      },
      {
        name: 'list_door_categories',
        description: 'Lista todas las categorías y subcategorías disponibles en la DOOR Knowledge Base con conteo de documentos.',
        inputSchema: {
          type: 'object',
          properties: {},
        },
      },
    ],
  }));
  
  // Manejar llamadas a herramientas
  this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
    try {
      switch (request.params.name) {
        case 'search_door_knowledge':
          return await this.searchDoorKnowledge(request.params.arguments);

• door-knowledge-mcp-server.js:50-60 (helper)

  Helper function to load the pre-built search index JSON from disk on demand, caching it in memory for fast subsequent access.

  async loadSearchIndex() {
    if (!this.searchIndex) {
      try {
        const data = await fs.readFile(this.searchIndexPath, 'utf-8');
        this.searchIndex = JSON.parse(data);
      } catch (err) {
        throw new Error(`No se pudo cargar el índice de búsqueda. Ejecuta: npm run build-index\nError: ${err.message}`);
      }
    }
    return this.searchIndex;
  }