Xano MCP Server

Xano MCP Python SDK

Ein Python-basierter MCP-Server (Model Context Protocol) für Xano, der es KI-Assistenten wie Claude ermöglicht, direkt mit Ihrer Xano-Instanz zu interagieren. Dies ist eine Standalone-Version, optimiert für die lokale Nutzung mit Claude Desktop und anderen MCP-kompatiblen LLMs.

🌟 Funktionen

• Einfache Authentifizierung : Stellen Sie eine Verbindung mit Ihrem Xano-API-Token her
• Umfassende API : Abfragen und Bearbeiten von Xano-Instanzen, Datenbanken, Tabellen und Datensätzen
• Lokale Bereitstellung : Wird als lokaler MCP-Server für Claude Desktop oder andere Clients ausgeführt
• Detaillierte Protokollierung : Beheben Sie Probleme mit umfassender Protokollierung
• Tragbar : Funktioniert unter macOS, Windows und Linux

🚀 Schnellstart

1. Klonen Sie dieses Repository :
   git clone https://github.com/yourusername/xano-mcp-python.git cd xano-mcp-python
2. Installieren Sie Abhängigkeiten :
   pip install -r requirements.txt
3. Konfigurieren Sie Claude Desktop (falls verwendet):Bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   Fügen Sie diese Konfiguration hinzu:

   { "mcpServers": { "xano": { "command": "python", "args": [ "/path/to/xano-mcp-python/xano_mcp_sdk.py" ], "env": { "XANO_API_TOKEN": "your-xano-api-token" } } } }
4. Führen Sie das Installationsskript aus :
   # On macOS/Linux ./install.sh # On Windows install.bat
5. Testen Sie die Installation :
   ./test.py

💡 Anwendungsbeispiele

Nach der Installation können Sie es mit Claude oder jedem MCP-kompatiblen Assistenten verwenden. Hier sind einige Beispiele:

• Listen Sie Ihre Xano-Instanzen auf :

  Welche Xano-Instanzen habe ich?

• Überprüfen Sie die Datenbanktabellen :

  Zeige mir alle Tabellen in meiner Xano-Instanz „my-instance“

• Erstellen Sie eine neue Tabelle :

  Erstellen Sie eine neue Tabelle mit dem Namen „Produkte“ in meiner Xano-Instanz „my-instance“.

• Tabellenstruktur untersuchen :

  Was ist das Schema für die Tabelle „Benutzer“?

• Datensätze abfragen :

  Zeigen Sie mir die ersten 5 Datensätze in der Tabelle „Benutzer“

🧰 Verfügbare Tools

Instanzverwaltung

• Instanzen auflisten
• Abrufen von Instanzdetails
• Überprüfen des Instanzstatus

Datenbankoperationen

• Datenbanken/Arbeitsbereiche auflisten
• Abrufen von Arbeitsbereichsdetails
• Datenbankschemaverwaltung

Tabellenoperationen

• Tabellen erstellen, aktualisieren, löschen
• Felder hinzufügen, ändern und entfernen
• Indexverwaltung

Datensatzverwaltung

• Datensätze erstellen, lesen, aktualisieren, löschen
• Massenvorgänge
• Komplexe Abfragen

Dateioperationen

• Auflisten und Verwalten von Dateien
• Hoch- und Herunterladen

API-Tools

• API-Gruppenverwaltung
• Erstellen und Konfigurieren von API-Endpunkten

🔧 Erweiterte Konfiguration

Umgebungsvariablen

• XANO_API_TOKEN : Ihr Xano-API-Token (erforderlich)
• XANO_LOG_LEVEL : Protokollebene festlegen (Standard: INFO)
• XANO_DEFAULT_INSTANCE : Zu verwendende Standardinstanz, wenn nicht angegeben

Befehlszeilenoptionen

Protokollierung

Protokolle werden geschrieben an:

• macOS: ~/Library/Logs/Claude/mcp*.log
• Windows: %APPDATA%\Claude\logs\mcp*.log

Für eine direkte Konsolenausgabe führen Sie Folgendes aus:

🚨 Fehlerbehebung

Wenn Probleme auftreten:

1. Überprüfen Sie die Protokolle auf Fehler:
   # macOS tail -n 100 -f ~/Library/Logs/Claude/mcp*.log # Windows type "%APPDATA%\Claude\logs\mcp*.log"
2. Überprüfen Sie, ob das API-Token korrekt ist und über die entsprechenden Berechtigungen verfügt
3. Überprüfen Sie die Netzwerkkonnektivität zu Xano-Servern
4. Stellen Sie sicher, dass die Python-Umgebung richtig eingerichtet ist

🤝 Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE.

🙏 Danksagungen

• Xano für ihre hervorragende Datenbankplattform
• Anthropisch für die Model Context Protocol-Spezifikation
• Mitwirkende und Tester, die zur Verfeinerung dieses SDK beigetragen haben