mcp-adr-analysis-server
Version:
MCP server for analyzing Architectural Decision Records and project architecture
70 lines • 2.73 kB
TypeScript
/**
* MCP Tool for ADR suggestions and implicit decision detection
* Enhanced with Knowledge Generation, Reflexion capabilities, and Research-Driven Architecture
* Implements AI-powered ADR recommendation system with environment-aware research
*
* Following ADR-018 Atomic Tools Architecture:
* - Dependency injection for testability
* - No ResearchOrchestrator (deprecated) - uses static context
* - Self-contained with minimal dependencies
*/
import { ConversationContext } from '../types/conversation-context.js';
/**
* Suggest ADRs based on project analysis with advanced prompting techniques
* Enhanced with Knowledge Generation and Reflexion learning capabilities
*/
export declare function suggestAdrs(args: {
projectPath?: string;
analysisType?: 'implicit_decisions' | 'code_changes' | 'comprehensive';
beforeCode?: string;
afterCode?: string;
changeDescription?: string;
commitMessages?: string[];
existingAdrs?: string[];
enhancedMode?: boolean;
learningEnabled?: boolean;
knowledgeEnhancement?: boolean;
enableTreeSitterAnalysis?: boolean;
conversationContext?: ConversationContext;
}): Promise<any>;
/**
* Generate ADR from decision data
*/
export declare function generateAdrFromDecision(args: {
decisionData: {
title: string;
context: string;
decision: string;
consequences: string;
alternatives?: string[];
evidence?: string[];
};
templateFormat?: 'nygard' | 'madr' | 'custom';
existingAdrs?: string[];
adrDirectory?: string;
}): Promise<any>;
/**
* Discover existing ADRs in the project using internal file system tools
*
* IMPORTANT FOR AI ASSISTANTS: This tool performs TWO critical functions:
* 1. PRIMARY: Scans the specified ADR directory and catalogs all existing ADRs
* 2. SECONDARY: ALWAYS initializes the complete .mcp-adr-cache infrastructure
*
* The cache initialization happens REGARDLESS of whether ADRs are found, making
* this the recommended FIRST STEP for any project workflow. All other MCP tools
* depend on this cache infrastructure to function properly.
*
* Cache files created:
* - .mcp-adr-cache/todo-data.json (TODO management backend)
* - .mcp-adr-cache/project-health-scores.json (project health metrics)
* - .mcp-adr-cache/knowledge-graph-snapshots.json (architectural knowledge)
* - .mcp-adr-cache/todo-sync-state.json (synchronization state)
*
* Therefore, always run this tool first, even for projects without existing ADRs.
*/
export declare function discoverExistingAdrs(args: {
adrDirectory?: string;
includeContent?: boolean;
projectPath?: string;
}): Promise<any>;
//# sourceMappingURL=adr-suggestion-tool.d.ts.map