search_door_knowledge
Search DOOR support documentation and knowledge base articles by keywords, categories, or content to find relevant documents with summaries.
Instructions
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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Término de búsqueda (ej: "installation", "latch m", "intercom", "wiring") | |
| category | No | Filtrar por categoría específica (opcional). Usa list_door_categories para ver las disponibles. | |
| limit | No | Número máximo de resultados (default: 10) |
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; }