Ryan Malloy
3a13410f57
📚 Documentation Organization: - Move 9 historical files to docs/archive/ (session summaries, implementation status) - Keep only 5 current reference docs in docs/ (safety, build, LLM guide) - Update docs/README.md with clean structure and current status ✨ Clean docs/ Structure: ├── README.md (updated directory index) ├── SACRED_TRUST_SAFETY.md (core safety framework) ├── UV_BUILD_GUIDE.md (build instructions) ├── PACKAGE_READY.md (package info) ├── LLM_TOOL_GUIDE.md (AI assistant reference) └── archive/ (15 historical implementation docs) 🎯 Result: Professional documentation structure with clear separation between current reference docs and historical development records. Ready for Phase 3 with clean, maintainable project organization!
193 lines
6.6 KiB
Markdown
193 lines
6.6 KiB
Markdown
# Enhanced MCP Tools - Essential Files Analysis
|
|
|
|
**Generated:** June 18, 2025
|
|
**Purpose:** Analyze which files are absolutely essential vs optional for the MCP server
|
|
|
|
---
|
|
|
|
## 📊 Size Analysis Summary
|
|
|
|
| Category | File Count | Total Size | Percentage |
|
|
|----------|------------|------------|------------|
|
|
| **Core Infrastructure Only** | 3 | 5,676 bytes | 3.4% |
|
|
| **Minimal Essential System** | 7 | 75,572 bytes | 45.0% |
|
|
| **Full Current System** | 11 | 168,021 bytes | 100% |
|
|
| **Potentially Optional** | 4 | 92,449 bytes | 55.0% |
|
|
|
|
---
|
|
|
|
## 🔴 Absolutely Essential (Core Infrastructure)
|
|
|
|
These 3 files are the absolute minimum required to run any MCP server:
|
|
|
|
| File | Size | Purpose |
|
|
|------|------|---------|
|
|
| `enhanced_mcp/__init__.py` | 805 bytes | Package initialization |
|
|
| `enhanced_mcp/base.py` | 1,933 bytes | Base classes and utilities |
|
|
| `enhanced_mcp/mcp_server.py` | 2,938 bytes | Main server implementation |
|
|
|
|
**Total: 5,676 bytes**
|
|
|
|
---
|
|
|
|
## ⭐ Most Essential Tools (Beyond Core)
|
|
|
|
These 4 modules provide the core functionality that makes the server useful:
|
|
|
|
| File | Size | Purpose |
|
|
|------|------|---------|
|
|
| `enhanced_mcp/intelligent_completion.py` | 21,691 bytes | AI-powered tool recommendations - core feature |
|
|
| `enhanced_mcp/git_integration.py` | 30,295 bytes | Git operations - fundamental for development |
|
|
| `enhanced_mcp/file_operations.py` | 7,426 bytes | File operations - basic functionality |
|
|
| `enhanced_mcp/workflow_tools.py` | 10,484 bytes | Development workflow - essential utilities |
|
|
|
|
**Total: 69,896 bytes**
|
|
**Combined with Core: 75,572 bytes (45% of full system)**
|
|
|
|
---
|
|
|
|
## 🟡 Currently Required (Due to Imports)
|
|
|
|
All modules below are currently imported and instantiated in `mcp_server.py`:
|
|
|
|
| File | Size | Essential Level |
|
|
|------|------|-----------------|
|
|
| `enhanced_mcp/diff_patch.py` | 1,560 bytes | 🔄 Potentially Optional |
|
|
| `enhanced_mcp/intelligent_completion.py` | 21,691 bytes | ⭐ Most Essential |
|
|
| `enhanced_mcp/asciinema_integration.py` | 38,977 bytes | 🔄 Potentially Optional |
|
|
| `enhanced_mcp/sneller_analytics.py` | 28,193 bytes | 🔄 Potentially Optional |
|
|
| `enhanced_mcp/git_integration.py` | 30,295 bytes | ⭐ Most Essential |
|
|
| `enhanced_mcp/file_operations.py` | 7,426 bytes | ⭐ Most Essential |
|
|
| `enhanced_mcp/archive_compression.py` | 23,719 bytes | 🔄 Potentially Optional |
|
|
| `enhanced_mcp/workflow_tools.py` | 10,484 bytes | ⭐ Most Essential |
|
|
|
|
**Total: 162,345 bytes**
|
|
|
|
---
|
|
|
|
## 🔄 Potentially Optional Modules
|
|
|
|
These modules could be made optional with refactoring, providing **55% size reduction**:
|
|
|
|
| File | Size | Use Case | Alternative |
|
|
|------|------|----------|-------------|
|
|
| `enhanced_mcp/asciinema_integration.py` | 38,977 bytes | Terminal recording | Specialized - not always needed |
|
|
| `enhanced_mcp/sneller_analytics.py` | 28,193 bytes | High-performance SQL | Specialized - standard SQL often sufficient |
|
|
| `enhanced_mcp/archive_compression.py` | 23,719 bytes | Archive operations | Standard tools (zip, tar) available |
|
|
| `enhanced_mcp/diff_patch.py` | 1,560 bytes | Diff/patch operations | Basic functionality, could be optional |
|
|
|
|
**Total Potentially Optional: 92,449 bytes**
|
|
|
|
---
|
|
|
|
## 🚀 Minimal Server Implementation Example
|
|
|
|
```python
|
|
# minimal_mcp_server.py - Example of absolute minimum files needed
|
|
|
|
from enhanced_mcp.base import *
|
|
from enhanced_mcp.intelligent_completion import IntelligentCompletion
|
|
from enhanced_mcp.git_integration import GitIntegration
|
|
from enhanced_mcp.file_operations import EnhancedFileOperations
|
|
|
|
class MinimalMCPServer(MCPMixin):
|
|
"""Minimal MCP server with only essential tools"""
|
|
|
|
def __init__(self, name: str = "Minimal MCP Server"):
|
|
super().__init__()
|
|
self.name = name
|
|
|
|
# Only the most essential tools
|
|
self.completion = IntelligentCompletion() # AI recommendations
|
|
self.git = GitIntegration() # Git operations
|
|
self.file_ops = EnhancedFileOperations() # File operations
|
|
|
|
self.tools = {
|
|
'completion': self.completion,
|
|
'git': self.git,
|
|
'file_ops': self.file_ops
|
|
}
|
|
|
|
def create_minimal_server():
|
|
server = FastMCP("Minimal Enhanced MCP")
|
|
tool_server = MinimalMCPServer()
|
|
server.include_router(tool_server, prefix="tools")
|
|
return server
|
|
|
|
if __name__ == "__main__":
|
|
server = create_minimal_server()
|
|
server.run()
|
|
```
|
|
|
|
---
|
|
|
|
## 💡 Optimization Recommendations
|
|
|
|
### Current State
|
|
- **All 11 modules are required** due to imports in `mcp_server.py`
|
|
- **No modularity** - cannot run with subset of tools
|
|
- **Full 168KB** must be loaded even for basic usage
|
|
|
|
### To Make Modules Optional
|
|
|
|
1. **Refactor `mcp_server.py`** to use conditional imports:
|
|
```python
|
|
# Instead of direct imports, use try/except
|
|
try:
|
|
from enhanced_mcp.asciinema_integration import AsciinemaIntegration
|
|
HAS_ASCIINEMA = True
|
|
except ImportError:
|
|
HAS_ASCIINEMA = False
|
|
```
|
|
|
|
2. **Add Configuration System**:
|
|
```python
|
|
# Enable/disable modules via config
|
|
ENABLED_MODULES = [
|
|
'intelligent_completion', # Always enabled
|
|
'git_integration', # Always enabled
|
|
'file_operations', # Always enabled
|
|
'workflow_tools', # Always enabled
|
|
# 'asciinema_integration', # Optional
|
|
# 'sneller_analytics', # Optional
|
|
]
|
|
```
|
|
|
|
3. **Use Dependency Injection Pattern**:
|
|
```python
|
|
class ConfigurableMCPServer:
|
|
def __init__(self, enabled_modules: List[str]):
|
|
self.tools = {}
|
|
for module_name in enabled_modules:
|
|
if module_name in AVAILABLE_MODULES:
|
|
self.tools[module_name] = AVAILABLE_MODULES[module_name]()
|
|
```
|
|
|
|
### Benefits of Optimization
|
|
|
|
- **55% size reduction** (168KB → 75KB) for minimal setup
|
|
- **Faster startup** with fewer imports
|
|
- **Modular deployment** - only include needed functionality
|
|
- **Easier maintenance** - clear separation of core vs optional features
|
|
- **Better testing** - can test core functionality independently
|
|
|
|
---
|
|
|
|
## 🎯 Action Items
|
|
|
|
1. **Immediate (No Breaking Changes)**:
|
|
- Document which modules are essential vs optional
|
|
- Create minimal server example for reference
|
|
|
|
2. **Short Term (Minor Refactoring)**:
|
|
- Add configuration system for enabling/disabling modules
|
|
- Make imports conditional in `mcp_server.py`
|
|
|
|
3. **Long Term (Architecture Improvement)**:
|
|
- Implement full dependency injection system
|
|
- Create plugin architecture for optional modules
|
|
- Add runtime module loading/unloading capability
|
|
|
|
---
|
|
|
|
*This analysis shows significant opportunity to create a more modular, lightweight version while maintaining core functionality.* |