{
"event": "PreToolUse",
"tool_name": "mcp__mcp-tasks__tasks_create",
"tool_input": {
"title": "MCP-DB Erweiterung: db_describe Tool (Tabellen-Struktur)",
"type": "ai_task",
"description": "# MCP-DB Erweiterung: db_describe Tool\n\n## Kontext\nDer MCP-DB Server (`\/opt\/mcp-servers\/mcp-db\/`) hat kein Tool um Tabellen-Strukturen anzuzeigen. `DESCRIBE table` und `SHOW CREATE TABLE` sind nicht über `db_select` möglich.\n\n**Problem:** Claude Code versucht dann `mysql -e \"DESCRIBE...\"` über CLI auszuführen.\n\n## Aufgabe\nErstelle `\/opt\/mcp-servers\/mcp-db\/tools\/describe_tool.py`.\n\n## Technische Anforderungen\n\n### 1. Tool-Signatur\n```python\n@mcp.tool()\ndef db_describe(\n table: str,\n database: str = \"ki_dev\",\n show_create: bool = False,\n) -> dict:\n \"\"\"\n Zeigt Tabellen-Struktur an.\n \n Args:\n table: Tabellenname\n database: Zieldatenbank (ki_dev oder ki_content)\n show_create: True = SHOW CREATE TABLE, False = DESCRIBE\n \n Returns:\n Dict mit columns (DESCRIBE) oder create_statement (SHOW CREATE)\n \"\"\"\n```\n\n### 2. Implementierung\n- Bei `show_create=False`: `DESCRIBE {table}` ausführen\n- Bei `show_create=True`: `SHOW CREATE TABLE {table}` ausführen\n- Tabellennamen validieren (keine SQL-Injection!)\n\n### 3. Validierung\n- **Tabellen-Whitelist:** Optional, oder alle Tabellen in erlaubten DBs\n- **Datenbank-Whitelist:** `ki_dev`, `ki_content`\n- **SQL-Injection-Schutz:** Tabellennamen auf `[a-zA-Z0-9_]+` prüfen\n\n### 4. Rückgabe-Format\n```python\n# DESCRIBE\n{\n \"status\": \"success\",\n \"table\": \"chat_sessions\",\n \"columns\": [\n {\"Field\": \"id\", \"Type\": \"int\", \"Null\": \"NO\", \"Key\": \"PRI\", ...},\n ...\n ]\n}\n\n# SHOW CREATE TABLE\n{\n \"status\": \"success\", \n \"table\": \"chat_sessions\",\n \"create_statement\": \"CREATE TABLE `chat_sessions` (...)\"\n}\n```\n\n### 5. server.py anpassen\n```python\nfrom tools.describe_tool import register_describe_tool\nregister_describe_tool(mcp)\n```\n\n## Python Contract (PFLICHT)\nVollständige Einhaltung von `\/var\/www\/docs\/contracts\/python-pipeline-contract_v1.0.yaml`:\n- Type Hints, Google-Style Docstrings, korrekte Imports\n- Parameterized Queries wo möglich\n- Audit-Logging via ProtokollLogger\n\n## Prüfung vor Abschluss\n```bash\ncd \/opt\/mcp-servers\/mcp-db\n\/opt\/scripts\/pipeline\/venv\/bin\/ruff check tools\/describe_tool.py\n\/opt\/scripts\/pipeline\/venv\/bin\/ruff format --check tools\/describe_tool.py\n\/opt\/scripts\/pipeline\/venv\/bin\/mypy tools\/describe_tool.py\n```\n\n## Referenz-Dateien\n- Pattern: `\/opt\/mcp-servers\/mcp-db\/tools\/select_tool.py`\n- Schema-Tool (ähnlich): `\/opt\/mcp-servers\/mcp-db\/tools\/schema_tool.py`"
}
}
{
"tool_response": [
{
"type": "text",
"text": "{\n \"success\": true,\n \"task\": {\n \"id\": 137,\n \"uuid\": \"d61172c9-4be8-48e4-98f4-937531e165cc\",\n \"title\": \"MCP-DB Erweiterung: db_describe Tool (Tabellen-Struktur)\",\n \"description\": \"# MCP-DB Erweiterung: db_describe Tool\\n\\n## Kontext\\nDer MCP-DB Server (`\/opt\/mcp-servers\/mcp-db\/`) hat kein Tool um Tabellen-Strukturen anzuzeigen. `DESCRIBE table` und `SHOW CREATE TABLE` sind nicht über `db_select` möglich.\\n\\n**Problem:** Claude Code versucht dann `mysql -e \\\"DESCRIBE...\\\"` über CLI auszuführen.\\n\\n## Aufgabe\\nErstelle `\/opt\/mcp-servers\/mcp-db\/tools\/describe_tool.py`.\\n\\n## Technische Anforderungen\\n\\n### 1. Tool-Signatur\\n```python\\n@mcp.tool()\\ndef db_describe(\\n table: str,\\n database: str = \\\"ki_dev\\\",\\n show_create: bool = False,\\n) -> dict:\\n \\\"\\\"\\\"\\n Zeigt Tabellen-Struktur an.\\n \\n Args:\\n table: Tabellenname\\n database: Zieldatenbank (ki_dev oder ki_content)\\n show_create: True = SHOW CREATE TABLE, False = DESCRIBE\\n \\n Returns:\\n Dict mit columns (DESCRIBE) oder create_statement (SHOW CREATE)\\n \\\"\\\"\\\"\\n```\\n\\n### 2. Implementierung\\n- Bei `show_create=False`: `DESCRIBE {table}` ausführen\\n- Bei `show_create=True`: `SHOW CREATE TABLE {table}` ausführen\\n- Tabellennamen validieren (keine SQL-Injection!)\\n\\n### 3. Validierung\\n- **Tabellen-Whitelist:** Optional, oder alle Tabellen in erlaubten DBs\\n- **Datenbank-Whitelist:** `ki_dev`, `ki_content`\\n- **SQL-Injection-Schutz:** Tabellennamen auf `[a-zA-Z0-9_]+` prüfen\\n\\n### 4. Rückgabe-Format\\n```python\\n# DESCRIBE\\n{\\n \\\"status\\\": \\\"success\\\",\\n \\\"table\\\": \\\"chat_sessions\\\",\\n \\\"columns\\\": [\\n {\\\"Field\\\": \\\"id\\\", \\\"Type\\\": \\\"int\\\", \\\"Null\\\": \\\"NO\\\", \\\"Key\\\": \\\"PRI\\\", ...},\\n ...\\n ]\\n}\\n\\n# SHOW CREATE TABLE\\n{\\n \\\"status\\\": \\\"success\\\", \\n \\\"table\\\": \\\"chat_sessions\\\",\\n \\\"create_statement\\\": \\\"CREATE TABLE `chat_sessions` (...)\\\"\\n}\\n```\\n\\n### 5. server.py anpassen\\n```python\\nfrom tools.describe_tool import register_describe_tool\\nregister_describe_tool(mcp)\\n```\\n\\n## Python Contract (PFLICHT)\\nVollständige Einhaltung von `\/var\/www\/docs\/contracts\/python-pipeline-contract_v1.0.yaml`:\\n- Type Hints, Google-Style Docstrings, korrekte Imports\\n- Parameterized Queries wo möglich\\n- Audit-Logging via ProtokollLogger\\n\\n## Prüfung vor Abschluss\\n```bash\\ncd \/opt\/mcp-servers\/mcp-db\\n\/opt\/scripts\/pipeline\/venv\/bin\/ruff check tools\/describe_tool.py\\n\/opt\/scripts\/pipeline\/venv\/bin\/ruff format --check tools\/describe_tool.py\\n\/opt\/scripts\/pipeline\/venv\/bin\/mypy tools\/describe_tool.py\\n```\\n\\n## Referenz-Dateien\\n- Pattern: `\/opt\/mcp-servers\/mcp-db\/tools\/select_tool.py`\\n- Schema-Tool (ähnlich): `\/opt\/mcp-servers\/mcp-db\/tools\/schema_tool.py`\",\n \"type\": \"ai_task\",\n \"status\": \"pending\",\n \"created_by\": \"mcp-tasks\",\n \"created_by_type\": \"ai\",\n \"parent_task_id\": null,\n \"due_date\": null,\n \"created_at\": \"2025-12-20T18:17:26.278738\",\n \"updated_at\": \"2025-12-20T18:17:26.278741\",\n \"completed_at\": null,\n \"metadata\": {}\n },\n \"message\": \"Task #137 created\"\n}"
}
]
}