mcp-adr-analysis-server
Version:
MCP server for analyzing Architectural Decision Records and project architecture
59 lines • 2.04 kB
TypeScript
/**
* LLM-Managed Web Search Tool
*
* Uses Firecrawl for cross-platform web search with LLM-driven query optimization
*/
import type { ToolContext } from '../types/tool-context.js';
/**
* LLM-managed web search using Firecrawl for cross-platform support
*
* @description Executes intelligent web search using Firecrawl with LLM-driven
* query optimization and content relevance scoring. Supports RHEL, Ubuntu, and macOS.
*
* @param {Object} args - Web search configuration parameters
* @param {string} args.query - The search query to execute
* @param {number} [args.maxResults] - Maximum results to return (default: 5)
* @param {boolean} [args.includeContent] - Include full content (default: true)
* @param {string} [args.llmInstructions] - LLM instructions for search optimization
* @param {string} [args.projectPath] - Path to project root (defaults to cwd)
* @param {string} [args.adrDirectory] - ADR directory relative to project (defaults to 'docs/adrs')
*
* @returns {Promise<any>} Web search results with LLM analysis
*
* @throws {McpAdrError} When query is empty or search fails
*
* @example
* ```typescript
* // Basic web search
* const result = await llmWebSearch({
* query: 'Red Hat OpenShift best practices'
* });
*
* console.log(result.results); // Array of search results
* console.log(result.llmAnalysis); // LLM analysis of results
* ```
*
* @example
* ```typescript
* // Advanced search with LLM instructions
* const result = await llmWebSearch({
* query: 'Kubernetes security hardening',
* maxResults: 10,
* llmInstructions: 'Focus on enterprise security practices and compliance requirements'
* });
* ```
*
* @since 2.1.0
* @category Web Search
* @category LLM
* @mcp-tool
*/
export declare function llmWebSearch(args: {
query: string;
maxResults?: number;
includeContent?: boolean;
llmInstructions?: string;
projectPath?: string;
adrDirectory?: string;
}, context?: ToolContext): Promise<any>;
//# sourceMappingURL=llm-web-search-tool.d.ts.map