Files
michaelschiemer/docs/claude/mcp-integration.md
Michael Schiemer 55a330b223 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
2025-08-11 20:13:26 +02:00

2.8 KiB

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

# 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

{
  "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