Michael Schiemer
55a330b223
- Add DISCOVERY_LOG_LEVEL=debug - Add DISCOVERY_SHOW_PROGRESS=true - Temporary changes for debugging InitializerProcessor fixes on production
74 lines
2.8 KiB
Markdown
74 lines
2.8 KiB
Markdown
# 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 |