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

Related MCP server: Supabase MCP Server

🚀 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

python xano_mcp_sdk.py --token YOUR_TOKEN --log-level DEBUG

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:

python xano_mcp_sdk.py --console-logging

🚨 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