mcp-adr-analysis-server

# Additional MCP Tools Available for Testing ## Currently Tested Tools (7 tools) Based on our workflow tests, we've tested: 1. ✅ `analyze_project_ecosystem` - Comprehensive project analysis 2. ✅ `discover_existing_adrs` - ADR discovery 3. ✅ `suggest_adrs` - ADR suggestions 4. ✅ `get_architectural_context` - Architectural context retrieval 5. ✅ `analyze_content_security` - Security analysis 6. ✅ `get_workflow_guidance` - Workflow guidance 7. ❌ `tool_chain_orchestrator` - Tool orchestration (failed due to env var issue) ## Additional Tools Available for Testing ### ADR Management Tools (9 tools) 1. **`generate_adr_from_decision`** - Generate ADR from decision data - **Test Value**: High - Core ADR generation functionality - **Dependencies**: None - **Example**: Generate ADR from a specific architectural decision 2. **`generate_adr_bootstrap`** - Bootstrap ADR directory structure - **Test Value**: Medium - Setup functionality - **Dependencies**: None - **Example**: Initialize ADR directory with templates 3. **`bootstrap_validation_loop`** - Validation loop for bootstrap - **Test Value**: Low - Niche functionality - **Dependencies**: `generate_adr_bootstrap` 4. **`review_existing_adrs`** - Review and validate existing ADRs - **Test Value**: High - ADR validation - **Dependencies**: Existing ADRs in project - **Example**: Review ADRs in `sample-project/docs/adrs/` 5. **`validate_adr`** - Validate a single ADR - **Test Value**: High - ADR validation - **Dependencies**: ADR file path - **Example**: Validate specific ADR file 6. **`validate_all_adrs`** - Validate all ADRs in directory - **Test Value**: High - Bulk validation - **Dependencies**: ADR directory - **Example**: Validate all ADRs in `docs/adrs/` 7. **`generate_adrs_from_prd`** - Generate ADRs from PRD - **Test Value**: High - PRD-to-ADR conversion - **Dependencies**: PRD file - **Example**: Convert PRD.md to ADRs 8. **`compare_adr_progress`** - Compare TODO vs ADRs vs environment - **Test Value**: High - Progress tracking - **Dependencies**: TODO.md and ADRs - **Example**: Compare implementation progress ### Rule & Governance Tools (3 tools) 9. **`generate_rules`** - Extract architectural rules from ADRs - **Test Value**: High - Rule extraction - **Dependencies**: ADRs - **Example**: Generate rules from existing ADRs 10. **`validate_rules`** - Validate code against architectural rules - **Test Value**: High - Rule validation - **Dependencies**: Rules and codebase - **Example**: Validate code compliance 11. **`create_rule_set`** - Create comprehensive rule management - **Test Value**: Medium - Rule management - **Dependencies**: Rules ### Security & Content Masking Tools (4 tools) 12. **`generate_content_masking`** - Generate masking instructions - **Test Value**: High - Security functionality - **Dependencies**: Content to mask - **Example**: Mask sensitive content 13. **`configure_custom_patterns`** - Configure custom sensitive patterns - **Test Value**: Medium - Security configuration - **Dependencies**: None - **Example**: Add custom security patterns 14. **`apply_basic_content_masking`** - Apply basic masking (fallback) - **Test Value**: Medium - Fallback functionality - **Dependencies**: Content 15. **`validate_content_masking`** - Validate masking effectiveness - **Test Value**: Medium - Validation - **Dependencies**: Masked content ### Research & Documentation Tools (4 tools) 16. **`generate_research_questions`** - Generate research questions - **Test Value**: High - Research functionality - **Dependencies**: Project context - **Example**: Generate research questions for architecture 17. **`perform_research`** - Perform research analysis - **Test Value**: High - Core research tool - **Dependencies**: Research questions - **Example**: Research architectural patterns 18. **`incorporate_research`** - Integrate research findings - **Test Value**: High - Research integration - **Dependencies**: Research results - **Example**: Incorporate research into ADRs 19. **`create_research_template`** - Create research templates - **Test Value**: Medium - Template creation - **Dependencies**: None ### Deployment & Environment Tools (3 tools) 20. **`analyze_environment`** - Environment analysis - **Test Value**: High - Environment validation - **Dependencies**: Project path - **Example**: Analyze deployment environment 21. **`analyze_deployment_progress`** - Deployment tracking - **Test Value**: High - Deployment analysis - **Dependencies**: Project and ADRs - **Example**: Track deployment progress 22. **`generate_deployment_guidance`** - Generate deployment guidance - **Test Value**: High - Deployment planning - **Dependencies**: ADRs - **Example**: Generate deployment steps ### Development Workflow Tools (4 tools) 23. **`get_development_guidance`** - Get development guidance - **Test Value**: High - Development planning - **Dependencies**: ADRs and project context - **Example**: Get implementation guidance 24. **`smart_score`** - Score code quality and architecture - **Test Value**: High - Project scoring - **Dependencies**: Project analysis - **Example**: Score project health (0-100) 25. **`troubleshoot_guided_workflow`** - Systematic troubleshooting - **Test Value**: High - Troubleshooting - **Dependencies**: Failure context - **Example**: Troubleshoot deployment failures ### Utility & Management Tools (5 tools) 26. **`manage_cache`** - Cache management - **Test Value**: Medium - Cache operations - **Dependencies**: None - **Example**: Clear cache, get stats 27. **`configure_output_masking`** - Configure global output masking - **Test Value**: Low - Configuration - **Dependencies**: None 28. **`check_ai_execution_status`** - Check AI execution status - **Test Value**: High - Diagnostic tool - **Dependencies**: None - **Example**: Verify AI configuration 29. **`request_action_confirmation`** - Interactive confirmation - **Test Value**: Low - User interaction - **Dependencies**: None ### Cloud & Database Tools (3 tools) 30. **`llm_web_search`** - LLM-powered web search - **Test Value**: Medium - Web research - **Dependencies**: AI execution - **Example**: Search for architectural patterns 31. **`llm_cloud_management`** - Cloud resource management - **Test Value**: Medium - Cloud operations - **Dependencies**: AI execution - **Example**: Manage cloud infrastructure 32. **`llm_database_management`** - Database operations - **Test Value**: Medium - Database operations - **Dependencies**: AI execution - **Example**: Generate database queries ### Memory & Context Tools (5 tools) 33. **`expand_memory`** - Expand stored content - **Test Value**: Medium - Memory expansion - **Dependencies**: Expandable ID 34. **`query_conversation_history`** - Query conversation history - **Test Value**: Medium - History queries - **Dependencies**: Conversation memory 35. **`get_conversation_snapshot`** - Get conversation snapshot - **Test Value**: Medium - Context snapshots - **Dependencies**: Active conversation 36. **`get_memory_stats`** - Get memory statistics - **Test Value**: Low - Diagnostics - **Dependencies**: None 37. **`get_server_context`** - Get server context - **Test Value**: High - Server context - **Dependencies**: None - **Example**: Get comprehensive server context ### File System Tools (3 tools) 38. **`read_file`** - Read file contents ✅ (Already tested) 39. **`write_file`** - Write file contents - **Test Value**: High - File writing - **Dependencies**: File path and content - **Example**: Write ADR file 40. **`list_directory`** - List directory - **Test Value**: High - Directory listing - **Dependencies**: Directory path ## Recommended Testing Priority ### High Priority (Core Functionality) - 15 tools 1. `generate_adr_from_decision` - Core ADR generation 2. `validate_rules` - Rule validation 3. `smart_score` - Project scoring 4. `generate_rules` - Rule extraction 5. `review_existing_adrs` - ADR review 6. `validate_adr` - ADR validation 7. `check_ai_execution_status` - Diagnostic tool 8. `get_server_context` - Server context 9. `generate_research_questions` - Research 10. `perform_research` - Research execution 11. `analyze_environment` - Environment analysis 12. `analyze_deployment_progress` - Deployment tracking 13. `generate_deployment_guidance` - Deployment planning 14. `get_development_guidance` - Development guidance 15. `compare_adr_progress` - Progress comparison ### Medium Priority (Important Features) - 12 tools 16. `generate_content_masking` - Content masking 17. `validate_content_masking` - Masking validation 18. `configure_custom_patterns` - Pattern configuration 19. `incorporate_research` - Research integration 20. `manage_cache` - Cache management 21. `write_file` - File writing 22. `list_directory` - Directory listing 23. `create_rule_set` - Rule management 24. `generate_adr_bootstrap` - ADR bootstrap 25. `create_research_template` - Research templates 26. `llm_web_search` - Web search (requires AI) 27. `expand_memory` - Memory expansion ### Low Priority (Nice to Have) - 10 tools 28. `apply_basic_content_masking` - Basic masking 29. `configure_output_masking` - Output masking config 30. `request_action_confirmation` - User interaction 31. `get_conversation_snapshot` - Conversation snapshots 32. `query_conversation_history` - History queries 33. `get_memory_stats` - Memory stats 34. `llm_cloud_management` - Cloud management (requires AI) 35. `llm_database_management` - Database management (requires AI) 36. `bootstrap_validation_loop` - Bootstrap validation 37. `generate_adrs_from_prd` - PRD conversion (requires PRD file) ## Test Scenarios Suggested ### Scenario 4: ADR Generation & Validation Workflow ``` generate_adr_from_decision → validate_adr → review_existing_adrs ``` ### Scenario 5: Rule Generation & Validation Workflow ``` generate_rules → validate_rules → create_rule_set ``` ### Scenario 6: Project Scoring Workflow ``` analyze_project_ecosystem → smart_score → get_server_context ``` ### Scenario 7: Research Workflow ``` generate_research_questions → perform_research → incorporate_research ``` ### Scenario 8: Deployment Workflow ``` analyze_environment → generate_deployment_guidance → analyze_deployment_progress ``` ### Scenario 9: Development Guidance Workflow ``` get_development_guidance → generate_adr_from_decision → validate_rules ``` ## Summary **Total Tools Available**: ~40 actual tools **Currently Tested**: 7 tools (17.5%) **Remaining to Test**: ~33 tools (82.5%) **High Priority Remaining**: ~15 tools **Medium Priority Remaining**: ~12 tools **Low Priority Remaining**: ~10 tools ## Next Steps Would you like me to: 1. Create additional test playbooks for high-priority tools? 2. Create comprehensive test scenarios for specific workflows? 3. Test specific tools you're interested in?