Airtable-MCP-Server

Ein Model Context Protocol-Server, der Lese- und Schreibzugriff auf Airtable-Datenbanken bietet. Dieser Server ermöglicht LLMs, Datenbankschemata zu prüfen und anschließend Datensätze zu lesen und zu schreiben.

https://github.com/user-attachments/assets/c8285e76-d0ed-4018-94c7-20535db6c944

Verwendung

Um diesen Server mit der Claude Desktop-App zu verwenden, fügen Sie dem Abschnitt „mcpServers“ Ihrer claude_desktop_config.json die folgende Konfiguration hinzu:

Ersetzen Sie pat123.abc123 durch Ihren persönlichen Airtable-Zugriffstoken . Ihr Token sollte mindestens über schema.bases:read und data.records:read und optional über die entsprechenden Schreibberechtigungen verfügen.

Komponenten

Werkzeuge

• Datensätze auflisten

  • Listet Datensätze aus einer angegebenen Airtable-Tabelle auf

  • Eingabeparameter:

    • baseId (Zeichenfolge, erforderlich): Die ID der Airtable-Basis

    • tableId (Zeichenfolge, erforderlich): Die ID der abzufragenden Tabelle

    • maxRecords (Zahl, optional): Maximale Anzahl der zurückzugebenden Datensätze. Der Standardwert ist 100.

    • filterByFormula (Zeichenfolge, optional): Airtable-Formel zum Filtern von Datensätzen

• Suchdatensätze

  • Suchen Sie nach Datensätzen mit bestimmtem Text

  • Eingabeparameter:

    • baseId (Zeichenfolge, erforderlich): Die ID der Airtable-Basis

    • tableId (Zeichenfolge, erforderlich): Die ID der abzufragenden Tabelle

    • searchTerm (Zeichenfolge, erforderlich): Text, nach dem in Datensätzen gesucht werden soll

    • fieldIds (Array, optional): Spezifische Feld-IDs, in denen gesucht werden soll. Wenn nicht angegeben, werden alle textbasierten Felder durchsucht.

    • maxRecords (Zahl, optional): Maximale Anzahl der zurückzugebenden Datensätze. Der Standardwert ist 100.

• list_bases

  • Listet alle zugänglichen Airtable-Basen auf

  • Keine Eingabeparameter erforderlich

  • Gibt Basis-ID, Name und Berechtigungsstufe zurück

• list_tables

  • Listet alle Tabellen in einer bestimmten Basis auf

  • Eingabeparameter:

    • baseId (Zeichenfolge, erforderlich): Die ID der Airtable-Basis

    • detailLevel (Zeichenfolge, optional): Der Detaillierungsgrad, der über die Tabellen abgerufen werden soll ( tableIdentifiersOnly , identifiersOnly oder full )

  • Gibt Tabellen-ID, Name, Beschreibung, Felder und Ansichten zurück (bis zum angegebenen detailLevel )

• Tabelle beschreiben

  • Ruft detaillierte Informationen zu einer bestimmten Tabelle ab

  • Eingabeparameter:

    • baseId (Zeichenfolge, erforderlich): Die ID der Airtable-Basis

    • tableId (Zeichenfolge, erforderlich): Die ID der zu beschreibenden Tabelle

    • detailLevel (Zeichenfolge, optional): Der Detaillierungsgrad, der über die Tabelle abgerufen werden soll ( tableIdentifiersOnly , identifiersOnly oder full )

  • Gibt das gleiche Format wie list_tables zurück, jedoch für eine einzelne Tabelle

  • Nützlich, um Details zu einer bestimmten Tabelle zu erhalten, ohne Informationen zu allen Tabellen in der Basis abzurufen

• Datensatz abrufen

  • Ruft einen bestimmten Datensatz anhand der ID ab

  • Eingabeparameter:

    • baseId (Zeichenfolge, erforderlich): Die ID der Airtable-Basis

    • tableId (Zeichenfolge, erforderlich): Die ID der Tabelle

    • recordId (Zeichenfolge, erforderlich): Die ID des abzurufenden Datensatzes

• Datensatz erstellen

  • Erstellt einen neuen Datensatz in einer Tabelle

  • Eingabeparameter:

    • baseId (Zeichenfolge, erforderlich): Die ID der Airtable-Basis

    • tableId (Zeichenfolge, erforderlich): Die ID der Tabelle

    • fields (Objekt, erforderlich): Die Felder und Werte für den neuen Datensatz

• Datensätze aktualisieren

  • Aktualisiert einen oder mehrere Datensätze in einer Tabelle

  • Eingabeparameter:

    • baseId (Zeichenfolge, erforderlich): Die ID der Airtable-Basis

    • tableId (Zeichenfolge, erforderlich): Die ID der Tabelle

    • records (Array, erforderlich): Array von Objekten, die die Datensatz-ID und die zu aktualisierenden Felder enthalten

• Datensätze löschen

  • Löscht einen oder mehrere Datensätze aus einer Tabelle

  • Eingabeparameter:

    • baseId (Zeichenfolge, erforderlich): Die ID der Airtable-Basis

    • tableId (Zeichenfolge, erforderlich): Die ID der Tabelle

    • recordIds (Array, erforderlich): Array der zu löschenden Datensatz-IDs

• Tabelle erstellen

  • Erstellt eine neue Tabelle in einer Basis

  • Eingabeparameter:

    • baseId (Zeichenfolge, erforderlich): Die ID der Airtable-Basis

    • name (Zeichenfolge, erforderlich): Name der neuen Tabelle

    • description (Zeichenfolge, optional): Beschreibung der Tabelle

    • fields (Array, erforderlich): Array von Felddefinitionen (Name, Typ, Beschreibung, Optionen)

• Update-Tabelle

  • Aktualisiert den Namen oder die Beschreibung einer Tabelle

  • Eingabeparameter:

    • baseId (Zeichenfolge, erforderlich): Die ID der Airtable-Basis

    • tableId (Zeichenfolge, erforderlich): Die ID der Tabelle

    • name (Zeichenfolge, optional): Neuer Name für die Tabelle

    • description (Zeichenfolge, optional): Neue Beschreibung für die Tabelle

• Feld erstellen

  • Erstellt ein neues Feld in einer Tabelle

  • Eingabeparameter:

    • baseId (Zeichenfolge, erforderlich): Die ID der Airtable-Basis

    • tableId (Zeichenfolge, erforderlich): Die ID der Tabelle

    • name (Zeichenfolge, erforderlich): Name des neuen Felds

    • type (Zeichenfolge, erforderlich): Typ des Felds

    • description (Zeichenfolge, optional): Beschreibung des Feldes

    • options (Objekt, optional): Feldspezifische Optionen

• Aktualisierungsfeld

  • Aktualisiert den Namen oder die Beschreibung eines Feldes

  • Eingabeparameter:

    • baseId (Zeichenfolge, erforderlich): Die ID der Airtable-Basis

    • tableId (Zeichenfolge, erforderlich): Die ID der Tabelle

    • fieldId (Zeichenfolge, erforderlich): Die ID des Feldes

    • name (Zeichenfolge, optional): Neuer Name für das Feld

    • description (Zeichenfolge, optional): Neue Beschreibung für das Feld

Ressourcen

Der Server stellt Schemainformationen für Airtable-Basen und -Tabellen bereit:

• Tabellenschemata ( airtable://<baseId>/<tableId>/schema )

  • JSON-Schemainformationen für jede Tabelle

  • Beinhaltet:

    • Basis-ID und Tabellen-ID

    • Tabellenname und Beschreibung

    • Primäre Feld-ID

    • Felddefinitionen (ID, Name, Typ, Beschreibung, Optionen)

    • Definitionen anzeigen (ID, Name, Typ)

  • Automatisch erkannt von der Metadaten-API von Airtable

Beitragen

Pull Requests sind auf GitHub willkommen! So geht's:

1. Installieren Sie Git und Node.js

2. Klonen Sie das Repository

3. Installieren Sie Abhängigkeiten mit npm install

4. Führen Sie npm run test aus, um Tests auszuführen

5. Erstellen mit npm run build

• Sie können npm run build:watch verwenden, um nach der Bearbeitung src/index.ts automatisch zu erstellen. Das bedeutet, Sie können auf „Speichern“ klicken, Claude Desktop neu laden (mit Strg/Cmd+R) und die Änderungen werden übernommen.

Veröffentlichungen

Versionen folgen der semantischen Versionsspezifikation .

So lösen Sie:

1. Verwenden Sie npm version <major | minor | patch> um die Version zu erhöhen

2. Führen Sie git push --follow-tags aus, um mit Tags zu pushen

3. Warten Sie, bis GitHub Actions im NPM-Register veröffentlicht.