Enable Discovery debug logging for production troubleshooting
- Add DISCOVERY_LOG_LEVEL=debug - Add DISCOVERY_SHOW_PROGRESS=true - Temporary changes for debugging InitializerProcessor fixes on production
This commit is contained in:
74
docs/claude/mcp-integration.md
Normal file
74
docs/claude/mcp-integration.md
Normal file
@@ -0,0 +1,74 @@
|
||||
# MCP Integration
|
||||
|
||||
**Model Context Protocol (MCP) Server Integration** für das Custom PHP Framework.
|
||||
|
||||
## Server Status
|
||||
|
||||
**✅ FULLY FUNCTIONAL**
|
||||
- Server getestet und funktionsfähig mit JSON-RPC Protokoll
|
||||
- Tools und Ressourcen bereit für AI-Integration
|
||||
- Automatische Erkennung von Framework-Komponenten
|
||||
- Sichere, sandbox-basierte Dateisystem-Zugriffe
|
||||
|
||||
## Quick Access Commands
|
||||
|
||||
```bash
|
||||
# MCP Server starten
|
||||
docker exec -i php php console.php mcp:server
|
||||
|
||||
# MCP Server testen
|
||||
echo '{"jsonrpc": "2.0", "method": "initialize", "params": {}}' | docker exec -i php php console.php mcp:server
|
||||
```
|
||||
|
||||
## Verfügbare MCP Tools
|
||||
|
||||
| Tool | Beschreibung | Verwendung |
|
||||
|------|--------------|------------|
|
||||
| `analyze_routes` | Alle registrierten Routen abrufen | Framework-Routing-Analyse |
|
||||
| `analyze_container_bindings` | DI Container Bindings analysieren | Dependency Injection Debugging |
|
||||
| `discover_attributes` | Attribute nach Typ entdecken | Framework-Pattern-Erkennung |
|
||||
| `framework_health_check` | Health Check der Framework-Komponenten | System-Status-Überprüfung |
|
||||
| `list_framework_modules` | Alle Framework-Module auflisten | Architektur-Übersicht |
|
||||
| `list_directory` | Verzeichnisinhalte auflisten (projekt-beschränkt) | Dateisystem-Navigation |
|
||||
| `read_file` | Dateiinhalte mit Zeilenlimits lesen | Code-Analyse |
|
||||
| `find_files` | Dateien nach Pattern finden | Pattern-basierte Suche |
|
||||
|
||||
## MCP Resources
|
||||
|
||||
- `framework://config`: Framework-Konfiguration und Umgebung
|
||||
|
||||
## Claude Desktop Konfiguration
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"custom-php-framework": {
|
||||
"command": "docker",
|
||||
"args": ["exec", "-i", "php", "php", "console.php", "mcp:server"],
|
||||
"cwd": "/home/michael/dev/michaelschiemer"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Framework-Analyse-Capabilities
|
||||
|
||||
- **Route Discovery**: Automatische Erkennung aller registrierten Routen
|
||||
- **Container Binding Inspection**: Analyse der Dependency Injection Bindings
|
||||
- **Modul- und Komponenten-Discovery**: Erkennung aller Framework-Module
|
||||
- **Health Monitoring**: Überwachung des Framework-Status
|
||||
- **File System Operations**: Projekt-beschränkte Dateisystem-Operationen
|
||||
|
||||
## Best Practices für AI-Interaktion
|
||||
|
||||
1. **MCP Tools verwenden**: Nutze MCP Tools für Framework-Analyse anstatt manueller Datei-Lesung
|
||||
2. **Attribute Discovery nutzen**: Verwende Attribute-Discovery zum Verstehen der Framework-Patterns
|
||||
3. **Health Checks**: Führe Framework Health Checks vor Änderungen durch
|
||||
4. **Projekt-Scope beachten**: Respektiere projekt-beschränkte Dateizugriff-Limitierungen
|
||||
|
||||
## Sicherheitsfeatures
|
||||
|
||||
- **Sandboxed File Access**: Alle Dateizugriffe sind auf das Projekt beschränkt
|
||||
- **Safe Operations**: Nur lesende Operationen für Framework-Analyse
|
||||
- **Validation**: Eingabe-Validierung für alle MCP-Tool-Parameter
|
||||
- **Error Handling**: Robuste Fehlerbehandlung mit aussagekräftigen Meldungen
|
||||
Reference in New Issue
Block a user