MCP-Server

Erstellt: 2025-12-20 | Aktualisiert: 2025-12-20

Model Context Protocol (MCP) Server für sichere Datenbankzugriffe, Task-Management und erweiterte Funktionalität in Claude Code.

Protokoll	Model Context Protocol (MCP)
Transport	stdio
Server	4 (mcp-db, mcp-tasks, mcp-contracts, mcp-docs)
Logging	ki_protokoll.mcp_log
Installation	/opt/mcp-servers/

Verfügbare Server

MCP-DB - Sicherer Datenbankzugriff (Read-only, Query-Logging)
MCP-Tasks - Task-Management, KI-Ausführung, Quality-Checks
MCP-Contracts - Contract-Management, Versionierung, Validierung
MCP-Docs - Dokumentations-Management, Hierarchie, Volltextsuche

Vorteile

Sicherheit - Keine Passwörter in der Konversation
Zugriffskontrolle - Granulare Berechtigungen pro Server
Logging - Automatisches Logging aller Operationen
Token-Optimierung - Kompakte Ausgaben (compact=True)

Installation

# MCP-Server registrieren
claude mcp add <server-name> \
  /opt/mcp-servers/<server>/venv/bin/python \
  /opt/mcp-servers/<server>/server.py

# Registrierte Server anzeigen
claude mcp list

Verwendung

# MCP-DB
db_select("SELECT * FROM mcp_log LIMIT 5")
db_schema()

# MCP-Tasks
tasks_list(compact=True)
tasks_create(title="Aufgabe", type="ai_task")

# MCP-Contracts
contracts_list(compact=True)
contracts_validate(id=1)

# MCP-Docs
docs_list(compact=True)
docs_get(path="/server/ssh")
docs_hierarchy()

Best Practices

MCP-DB für alle Datenbankzugriffe - keine direkten mysql-Befehle
MCP-Tasks für Task-Management - keine direkten SQL-Queries
MCP-Contracts für Contracts - keine direkten SQL-Queries
MCP-Docs für Dokumentation - keine direkten SQL-Queries
compact=True für Token-sparende Listenausgaben

MCP-DB Server

Erstellt: 2025-12-20 | Aktualisiert: 2025-12-31

Model Context Protocol Server für sichere Datenbankzugriffe durch Claude Code.

Version	2.0.0
Transport	stdio
Runtime	Python 3.13+
Pfad	/var/www/mcp-servers/mcp_db/
Tools	10

Zweck

Keine Credentials in Claude Code Konfiguration
Validierte, sichere Datenbankoperationen
Logging aller Operationen in ki_dev.mcp_log
Vollständige CRUD-Operationen + DDL
Schutz durch Prepared Statements und Validierung

Kapitel

Kapitel	Beschreibung
Cheat-Sheet	Schnellreferenz: Alt (mysql) vs Neu (MCP-DB)
Architektur	Verzeichnisstruktur, Komponenten, Prinzipien
Contracts	QueryRequest, QueryResponse, ExecuteContract
Konfiguration	Environment Variables, Allowlists, Limits
Validators	QueryValidator, ExecuteValidator
Infrastructure	DatabaseConnection
Tools	10 Tools: SELECT, DDL, CRUD, Schema-Inspektion
Sicherheit	Maßnahmen, Mandatory WHERE, LIMIT-Schutz
Installation	Setup, Registrierung, Test
Testprotokoll	Testfälle, Testmatrix, Prüfbericht

Schnellstart

# Registrierung in Claude Code
claude mcp add mcp-db \
  --transport stdio \
  -- /var/www/mcp-servers/mcp_db/venv/bin/python \
     /var/www/mcp-servers/mcp_db/server.py

# Status prüfen
claude mcp list

Verfügbare Tools (10)

Lese-Operationen

Tool	Beschreibung	Parameter
`db_select`	SELECT-Abfrage ausführen	query, database, max_rows, params
`db_schema`	Tabellen mit Metadaten anzeigen	database
`db_stats`	Logging-Statistiken aus mcp_log	limit
`db_databases`	Erlaubte Datenbanken auflisten	-
`db_tables`	Tabellen einer DB auflisten	database, include_row_count
`db_describe`	Tabellenstruktur anzeigen	table, database, show_create

Schreib-Operationen

Tool	Beschreibung	Parameter
`db_insert`	Datensatz einfügen	table, data, database
`db_update`	Datensätze aktualisieren	table, data, where, database
`db_delete`	Datensätze löschen	table, where, database, limit

DDL-Operationen

Tool	Beschreibung	Parameter
`db_execute`	DDL ausführen (ALTER, CREATE, DROP, TRUNCATE)	statement, database, params

Datenbank-Struktur

Datenbank	Zweck	Beispiel-Tabellen
ki_dev	Development/Infrastructure	tasks, contracts, dokumentation, mcp_log
ki_content	Content/User-facing	chat_sessions, chat_messages, content, personas

Sicherheitsübersicht

Maßnahme	Status	Betrifft
Prepared Statements	Implementiert	Alle Tools
Identifier-Validierung	Regex ^[a-zA-Z0-9_]+$	INSERT, UPDATE, DELETE
Mandatory WHERE	Erzwungen	UPDATE, DELETE
Default LIMIT 100	Aktiv	DELETE
DDL Statement-Validierung	ExecuteValidator	db_execute
Database Allowlist	ki_dev, ki_content	Alle Tools
Keyword Blocklist (15)	Aktiv	db_select
Query Timeout	30 Sekunden	db_select
Row Limit	Max 100	db_select
Logging	Jede Operation in mcp_log	Alle Tools
Blocking-Hook	PreToolUse für Bash	mysql/mariadb CLI

Changelog

Version	Datum	Änderungen
2.0.0	2025-12-20	+7 neue Tools: db_execute, db_describe, db_databases, db_tables, db_insert, db_update, db_delete
1.0.0	2025-12-20	Initial Release: db_select, db_schema, db_stats

MCP-Tasks Server

Erstellt: 2025-12-20 | Aktualisiert: 2025-12-20

Model Context Protocol Server für Task-Management und KI-Mensch-Kollaboration.

Version	1.0.0
Transport	stdio
Runtime	Python 3.10+
Pfad	/opt/mcp-servers/mcp-tasks/
Datenbank	ki_dev (tasks, task_assignments, task_results)

Zweck

Task-Management für KI-Agenten und Menschen
Aufgaben erstellen, zuweisen, ausführen, abschließen
Lokale KI-Ausführung mit Ollama
Automatische Quality-Checks (PHPStan, Semgrep)
Token-Tracking und Kosten-Übersicht

Kapitel

Kapitel	Beschreibung
Architektur	Verzeichnisstruktur, Komponenten, Layer
Tools	Alle 12 MCP-Tools im Detail
Installation	Setup, Konfiguration, Registrierung

Schnellstart

# Registrierung in Claude Code
claude mcp add mcp-tasks \
  /opt/mcp-servers/mcp-tasks/venv/bin/python \
  /opt/mcp-servers/mcp-tasks/server.py

# Status prüfen
claude mcp list

Verfügbare Tools (12)

Task-Management (10 Tools)

Tool	Beschreibung	Parameter
`tasks_list`	Tasks auflisten (Token-optimiert)	status, type, search, limit, compact
`tasks_get`	Task-Details abrufen	id
`tasks_create`	Neuen Task erstellen	title, description, type, parent_task_id, due_date
`tasks_update`	Task aktualisieren	id, title, description, type, due_date
`tasks_status`	Status ändern	id, status
`tasks_assign`	Task zuweisen	id, assignee, assignee_type, model_name, notes
`tasks_result`	Ergebnis speichern	id, response, executor, executor_type, tokens_*, cost_usd
`tasks_execute`	Mit Ollama ausführen	id, model, auto_complete
`tasks_delete`	Task löschen	id
`tasks_statistics`	Statistiken abrufen	-

Quality (2 Tools)

Tool	Beschreibung	Parameter
`quality_check`	PHP-Quality-Checks (PHPStan, Semgrep)	path, checks, fix
`quality_report`	Vollständiger Quality-Report	scope, format

Datenmodell

Tabelle	Beschreibung
`tasks`	Haupttabelle mit Aufgaben
`task_assignments`	Zuweisungen an Personen/KIs
`task_results`	Ergebnisse mit Token-Tracking
`task_comments`	Kommentare und Updates

Status-Werte

Status	Bedeutung
`pending`	Offen, noch nicht begonnen
`in_progress`	In Bearbeitung
`completed`	Erfolgreich abgeschlossen
`failed`	Fehlgeschlagen
`cancelled`	Abgebrochen

MCP-Contracts Server

Erstellt: 2025-12-20 | Aktualisiert: 2025-12-20

Model Context Protocol Server für Contract-Management mit Versionierung, Validierung und Historie.

Version	1.0.0
Transport	stdio
Runtime	Python 3.10+
Pfad	/opt/mcp-servers/mcp-contracts/
Datenbank	ki_dev (contracts, contract_history, contract_validations)

Zweck

Zentrale Verwaltung aller Contracts in der Datenbank
Versionierung mit vollständiger Änderungshistorie
Validierung von Code gegen Contract-Regeln
Audit-Logging aller Operationen

Kapitel

Kapitel	Beschreibung
Tools	Alle 9 MCP-Tools im Detail
Architektur	Verzeichnisstruktur, Komponenten, Layer
Installation	Setup, Konfiguration, Registrierung

Schnellstart

# Registrierung in Claude Code
claude mcp add mcp-contracts \
  --transport stdio \
  -- /opt/mcp-servers/mcp-contracts/venv/bin/python \
     /opt/mcp-servers/mcp-contracts/server.py

# Status prüfen
claude mcp list

Verfügbare Tools (9)

Tool	Beschreibung
`contracts_list`	Contracts auflisten mit Filtern
`contracts_get`	Contract nach ID oder Name abrufen
`contracts_create`	Neuen Contract erstellen
`contracts_update`	Contract aktualisieren (neue Version)
`contracts_deprecate`	Contract als deprecated markieren
`contracts_validate`	Validierung gegen Scope ausführen
`contracts_history`	Änderungshistorie abrufen
`contracts_violations`	Letzte Validierungen/Violations
`contracts_statistics`	Statistiken über alle Contracts

Beispiele

# Alle aktiven Contracts auflisten
contracts_list(status="active", compact=True)

# Contract nach Name abrufen
contracts_get(name="CSS Contract")

# Validierung ausführen
contracts_validate(name="layered-architecture-pruefung_v1.0")

MCP-Docs Server

Erstellt: 2025-12-20 | Aktualisiert: 2025-12-27

Model Context Protocol Server für Dokumentations-Management. Verwaltet die hierarchische Dokumentation in der Datenbank.

Version	1.0.0
Transport	stdio
Runtime	Python 3.10+
Pfad	/opt/mcp-servers/mcp-docs/
Datenbank	ki_dev.dokumentation
Logging	ki_dev.mcp_log

Zweck

CRUD-Operationen auf hierarchischer Dokumentation
Volltextsuche in allen Dokumenten
Baumstruktur mit Parent-Child-Beziehungen
Token-optimierte Ausgaben (compact Mode)

Kapitel

Kapitel	Beschreibung
Tools	Alle 9 MCP-Tools im Detail
Architektur	Verzeichnisstruktur, Komponenten, Layer
Installation	Setup, Konfiguration, Registrierung

Schnellstart

# Registrierung in Claude Code
claude mcp add mcp-docs \
  /opt/mcp-servers/mcp-docs/venv/bin/python \
  /opt/mcp-servers/mcp-docs/server.py

# Status prüfen
claude mcp list

Verfügbare Tools (9)

Tool	Beschreibung
`docs_list`	Dokumente auflisten mit Filtern
`docs_get`	Dokument nach ID oder Pfad abrufen
`docs_create`	Neues Dokument erstellen
`docs_update`	Dokument bearbeiten
`docs_delete`	Dokument löschen
`docs_move`	Position im Baum ändern
`docs_hierarchy`	Kompletter Dokumentationsbaum
`docs_search`	Volltextsuche
`docs_statistics`	Statistiken abrufen

Beispiele

# Alle Dokumente auflisten (Token-sparend)
docs_list(compact=True)

# Dokument nach Pfad abrufen
docs_get(path="/server/ssh")

# Dokument mit Kindern und Breadcrumb
docs_get(id=1, include_children=True, include_breadcrumb=True)

# Volltextsuche
docs_search(query="SSH")

# Hierarchie anzeigen
docs_hierarchy()

# Statistiken
docs_statistics()

Token-Optimierung

docs_list(compact=True) - Nur id, path, title, status (ohne Content)
docs_list(compact=False) - Vollständige Ausgabe mit Content
docs_get() - Immer mit Content

MCP-Code

Erstellt: 2025-12-27 | Aktualisiert: 2025-12-31

MCP-Server für statische Code-Analyse. Analysiert PHP-Klassen, Dependencies und ermöglicht Impact-Analysen vor Refactorings.

Pfad	`/var/www/mcp-servers/mcp-code/`
Datenbank	ki_dev (code_files, code_classes, code_dependencies)
Projekt	/var/www/dev.campus.systemische-tools.de/

Tools

Tool	Beschreibung
`code_search(query)`	Sucht Klassen/Interfaces/Traits nach Name
`code_class(fqcn)`	Holt Klassen-Details per FQCN inkl. Methoden und Dependencies
`code_dependencies(fqcn)`	Zeigt was diese Klasse nutzt (outgoing)
`code_dependents(fqcn)`	Zeigt wer diese Klasse nutzt (incoming) - Impact-Analyse
`code_impact(fqcn)`	Vollständige Impact-Analyse vor Änderungen
`code_stats()`	Projekt-Statistiken

Anwendungsfälle

1. Klasse finden

code_search("Controller")
→ Findet alle Controller-Klassen

2. Klassen-Details abrufen

code_class("Controller\\ChatController")
→ Zeigt Methoden, Namespace, File-Path, Dependencies

3. Impact vor Refactoring prüfen

code_impact("Infrastructure\\Persistence\\ChatRepository")
→ Zeigt alle Klassen die betroffen wären

4. Dependency-Graph verstehen

code_dependencies("UseCases\\Chat\\SendMessageUseCase")
→ Zeigt: extends, implements, constructor-injection, use-statements

Dependency-Typen

Typ	Bedeutung
extends	Klasse erbt von...
implements	Klasse implementiert Interface...
constructor	Constructor-Injection
use	Use-Statement (Import)
trait	Trait wird verwendet

Best Practices

Vor Refactoring: Immer code_impact() ausführen
Interface ändern: code_dependents() für alle Implementierungen
Neue Klasse: code_search() um Namenskonflikte zu vermeiden

Datenbank-Tabellen

ki_dev.code_files

Feld	Typ	Null	Beschreibung
id	int	NO	Primärschlüssel
file_path	varchar	NO	Dateipfad
file_hash	varchar	YES	Hash für Change-Detection
last_scanned	datetime	YES	Letzter Scan
is_valid	tinyint(1)	YES	Gültige PHP-Datei
created_at	datetime	YES	Erstellungsdatum
updated_at	datetime	YES	Aktualisiert

ki_dev.code_classes

Feld	Typ	Null	Beschreibung
id	int	NO	Primärschlüssel
file_id	int	NO	FK zu code_files
fqcn	varchar	NO	Fully Qualified Class Name
class_name	varchar	NO	Klassenname
namespace	varchar	YES	Namespace
class_type	enum	NO	class, interface, trait
created_at	datetime	NO	Erstellungsdatum

ki_dev.code_dependencies

Feld	Typ	Null	Beschreibung
id	int	NO	Primärschlüssel
analysis_id	int	NO	FK zu code_classes
dependency_type	enum	NO	use, extends, implements, trait, constructor
target_fqcn	varchar	NO	Ziel-FQCN
target_short	varchar	YES	Kurzname
line_number	int	YES	Zeilennummer im Code
created_at	datetime	YES	Erstellungsdatum

]]>

MCP-Server

Verfügbare Server

Vorteile

Installation

Verwendung

Best Practices

Verwandte Themen

MCP-DB Server

Zweck

Kapitel

Schnellstart

Verfügbare Tools (10)

Lese-Operationen

Schreib-Operationen

DDL-Operationen

Datenbank-Struktur

Sicherheitsübersicht

Changelog

Verwandte Themen

MCP-Tasks Server

Zweck

Kapitel

Schnellstart

Verfügbare Tools (12)

Task-Management (10 Tools)

Quality (2 Tools)

Datenmodell

Status-Werte

Verwandte Themen

MCP-Contracts Server

Zweck

Kapitel

Schnellstart

Verfügbare Tools (9)

Beispiele

Verwandte Themen

MCP-Docs Server

Zweck

Kapitel

Schnellstart

Verfügbare Tools (9)

Beispiele

Token-Optimierung

Verwandte Themen

MCP-Code

Tools

Anwendungsfälle

1. Klasse finden

2. Klassen-Details abrufen

3. Impact vor Refactoring prüfen

4. Dependency-Graph verstehen

Dependency-Typen

Best Practices

Datenbank-Tabellen

ki_dev.code_files

ki_dev.code_classes

ki_dev.code_dependencies