Portable MCP Toolkit

# Changelog All notable changes to AIStack-MCP will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [Unreleased] ### Planned - VS Code extension support - Additional LLM backends - Enhanced caching layer --- ## [1.2.0] - 2025-01-XX ### 🎉 MCP Registry Integration & Template System Major release adding community tools support and template-based configuration. ### Added #### Registry Integration - **MCP Registry Client**: Browse 500+ community MCP servers from official registry - **Search capabilities**: Filter by keywords, category, runtime (npm, PyPI, Docker) - **Automatic caching**: 24-hour expiry with manual cache clearing - **Programmatic API**: Python client for registry access (`mcp_registry.client`) #### Server Installer - **Multi-runtime support**: Install npm, PyPI, and Docker-based servers - **Dependency detection**: Automatic detection of required tools (npm, pip, docker) - **Environment management**: Automatic environment variable configuration - **Dynamic enable/disable**: Toggle servers without manual config editing #### Template System - **Pre-built templates**: Three ready-to-use configurations - `minimal.json`: Lightweight (search only) - `standard.json`: Balanced workflow (recommended) - `full.json`: Complete feature set - **Custom templates**: Support for user-defined template files - **Automatic generation**: Template engine generates `mcp.json` from templates - **Workspace-aware**: Templates respect `${workspaceFolder}` patterns #### PowerShell Scripts - `list_registry_tools.ps1`: Browse and search registry - `install_community_tool.ps1`: Install community servers - `apply_template.ps1`: Apply template configurations - `clear_registry_cache.ps1`: Manage registry cache #### Documentation - `docs/REGISTRY.md`: Complete registry integration guide - `docs/TEMPLATES.md`: Template system documentation - Updated README with Community Tools section ### Changed - Updated project structure to include `mcp_registry/` package - Enhanced `requirements.txt` with registry dependencies ### Security - Registry cache stored locally (no sensitive data) - Server installations validated before activation - Template validation prevents invalid configurations ### Performance - Registry responses cached for 24 hours - Template application is instant (<100ms) - No impact on existing MCP server performance ### Migration Notes - **No breaking changes**: Existing configurations remain unaffected - **Optional feature**: Registry integration is opt-in via scripts - **Backward compatible**: All v1.0.0 and v1.1.0 features continue to work --- ## [1.0.0] - 2025-11-29 ### 🎉 Initial Release First production-ready release of AIStack-MCP with dual-mode orchestration. ### Added #### Core Features - **Dual-mode orchestration**: Single-repo isolation and multi-repo coordination - **One-command mode switching**: `switch_to_single_repo.ps1` and `switch_to_multi_repo.ps1` - **Portable configurations**: `${workspaceFolder}` variable support for cross-machine compatibility - **Mode indicator**: `.cursor/ACTIVE_MODE.txt` tracks current configuration state #### Setup & Configuration - **Interactive setup wizard**: `quickstart.ps1` for guided first-time setup - **Config builder**: `mcp_config_builder.py` with interactive and CLI modes - **Repository linker**: `link_repo.ps1` for symlink/clone management - **Automatic validation**: Config validation runs after every mode switch #### Validation & Monitoring - **CI-ready validation**: `validate_mcp_config.py` with `--strict` and `--test-generation` modes - **Workspace diagnostics**: `validate_workspace.py` for comprehensive health checks - **Dev environment status**: `dev_all.ps1` shows service status at a glance #### MCP Tools - `semantic_search`: Vector-based code search using Qdrant - `analyze_patterns`: LLM-powered pattern extraction using Ollama - `get_context`: Optimized context retrieval for code generation - `generate_code`: Style-matched code generation - `index_workspace`: Vector indexing for semantic search - `validate_workspace_config`: Configuration and service health check #### Documentation - FAANG-grade README with comprehensive guides - `WORKSPACE_PATTERN.md`: Isolation best practices - `BEST_PRACTICES.md`: Team usage guidelines - `troubleshooting/`: Platform-specific fix guides - Real-world examples for multi-package, microservices, and infrastructure patterns #### Infrastructure - Docker Compose configuration for Qdrant - `.gitignore` entries for config backups and workspaces - Windows-optimized MCP server configuration (`cmd /c` wrapper) ### Security - Explicit workspace isolation in single-repo mode - Controlled access in multi-repo mode (CORE workspace pattern) - Local-first AI processing (code never leaves machine for search/analysis) ### Performance - 90% token reduction through local preprocessing - <100ms semantic search latency - Optimized context compression --- ## [0.9.0] - 2025-11-28 ### Added - Initial multi-repo orchestration implementation - Basic mode switching scripts - MCP intelligence server with core tools ### Changed - Migrated from hardcoded paths to `${workspaceFolder}` pattern --- ## [0.1.0] - 2025-11-25 ### Added - Project scaffolding - Basic MCP server implementation - Ollama and Qdrant integration --- [Unreleased]: https://github.com/mjdevaccount/AIStack-MCP/compare/v1.2.0...HEAD [1.2.0]: https://github.com/mjdevaccount/AIStack-MCP/releases/tag/v1.2.0 [1.0.0]: https://github.com/mjdevaccount/AIStack-MCP/releases/tag/v1.0.0 [0.9.0]: https://github.com/mjdevaccount/AIStack-MCP/releases/tag/v0.9.0 [0.1.0]: https://github.com/mjdevaccount/AIStack-MCP/releases/tag/v0.1.0