servidor airtable-mcp

Un servidor de Protocolo de Contexto de Modelo que proporciona acceso de lectura y escritura a las bases de datos de Airtable. Este servidor permite a los LLM inspeccionar los esquemas de las bases de datos y, posteriormente, leer y escribir registros.

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

Uso

Para usar este servidor con la aplicación Claude Desktop, agregue la siguiente configuración a la sección "mcpServers" de su claude_desktop_config.json :

Reemplace pat123.abc123 con su token de acceso personal de Airtable . Su token debe tener al menos schema.bases:read y data.records:read , y opcionalmente, los permisos de escritura correspondientes.

Componentes

Herramientas

• lista_registros

  • Enumera los registros de una tabla Airtable específica

  • Parámetros de entrada:

    • baseId (cadena, obligatoria): el ID de la base de Airtable

    • tableId (cadena, obligatoria): el ID de la tabla a consultar

    • maxRecords (número, opcional): Número máximo de registros a devolver. El valor predeterminado es 100.

    • filterByFormula (cadena, opcional): fórmula de Airtable para filtrar registros

• registros de búsqueda

  • Buscar registros que contengan texto específico

  • Parámetros de entrada:

    • baseId (cadena, obligatoria): el ID de la base de Airtable

    • tableId (cadena, obligatoria): el ID de la tabla a consultar

    • searchTerm (cadena, obligatorio): Texto a buscar en los registros

    • fieldIds (matriz, opcional): ID de campos específicos para buscar. Si no se proporciona, busca en todos los campos basados en texto.

    • maxRecords (número, opcional): Número máximo de registros a devolver. El valor predeterminado es 100.

• bases de lista

  • Enumera todas las bases Airtable accesibles

  • No se requieren parámetros de entrada

  • Devuelve el ID base, el nombre y el nivel de permiso.

• listas_de_tablas

  • Enumera todas las tablas en una base específica

  • Parámetros de entrada:

    • baseId (cadena, obligatoria): el ID de la base de Airtable

    • detailLevel (cadena, opcional): la cantidad de detalles que se deben obtener sobre las tablas ( tableIdentifiersOnly , identifiersOnly o full ).

  • Devuelve el ID de la tabla, el nombre, la descripción, los campos y las vistas (al detailLevel indicado)

• describe_tabla

  • Obtiene información detallada sobre una tabla específica

  • Parámetros de entrada:

    • baseId (cadena, obligatoria): el ID de la base de Airtable

    • tableId (cadena, obligatoria): El ID de la tabla a describir

    • detailLevel (cadena, opcional): la cantidad de detalles que se obtendrán sobre la tabla ( tableIdentifiersOnly , identifiersOnly o full ).

  • Devuelve el mismo formato que list_tables pero para una sola tabla

  • Útil para obtener detalles sobre una tabla específica sin obtener información sobre todas las tablas en la base

• obtener_registro

  • Obtiene un registro específico por ID

  • Parámetros de entrada:

    • baseId (cadena, obligatoria): el ID de la base de Airtable

    • tableId (cadena, obligatoria): el ID de la tabla

    • recordId (cadena, obligatoria): el ID del registro a recuperar

• crear_registro

  • Crea un nuevo registro en una tabla

  • Parámetros de entrada:

    • baseId (cadena, obligatoria): el ID de la base de Airtable

    • tableId (cadena, obligatoria): el ID de la tabla

    • fields (objeto, obligatorio): Los campos y valores para el nuevo registro

• actualizar_registros

  • Actualiza uno o más registros en una tabla

  • Parámetros de entrada:

    • baseId (cadena, obligatoria): el ID de la base de Airtable

    • tableId (cadena, obligatoria): el ID de la tabla

    • records (matriz, obligatorio): Matriz de objetos que contienen el ID del registro y los campos para actualizar

• eliminar_registros

  • Elimina uno o más registros de una tabla

  • Parámetros de entrada:

    • baseId (cadena, obligatoria): el ID de la base de Airtable

    • tableId (cadena, obligatoria): el ID de la tabla

    • recordIds (matriz, obligatorio): Matriz de ID de registros para eliminar

• crear_tabla

  • Crea una nueva tabla en una base

  • Parámetros de entrada:

    • baseId (cadena, obligatoria): el ID de la base de Airtable

    • name (cadena, obligatorio): Nombre de la nueva tabla

    • description (cadena, opcional): Descripción de la tabla

    • fields (matriz, obligatorio): Matriz de definiciones de campos (nombre, tipo, descripción, opciones)

• tabla_de_actualización

  • Actualiza el nombre o la descripción de una tabla

  • Parámetros de entrada:

    • baseId (cadena, obligatoria): el ID de la base de Airtable

    • tableId (cadena, obligatoria): el ID de la tabla

    • name (cadena, opcional): Nuevo nombre para la tabla

    • description (cadena, opcional): Nueva descripción para la tabla

• crear_campo

  • Crea un nuevo campo en una tabla

  • Parámetros de entrada:

    • baseId (cadena, obligatoria): el ID de la base de Airtable

    • tableId (cadena, obligatoria): el ID de la tabla

    • name (cadena, obligatorio): Nombre del nuevo campo

    • type (cadena, obligatorio): Tipo del campo

    • description (cadena, opcional): Descripción del campo

    • options (objeto, opcional): Opciones específicas del campo

• campo_actualización

  • Actualiza el nombre o la descripción de un campo

  • Parámetros de entrada:

    • baseId (cadena, obligatoria): el ID de la base de Airtable

    • tableId (cadena, obligatoria): el ID de la tabla

    • fieldId (cadena, obligatoria): el ID del campo

    • name (cadena, opcional): nuevo nombre para el campo

    • description (cadena, opcional): Nueva descripción para el campo

Recursos

El servidor proporciona información de esquema para las bases y tablas de Airtable:

• Esquemas de tabla ( airtable://<baseId>/<tableId>/schema )

  • Información del esquema JSON para cada tabla

  • Incluye:

    • Id. de base e id. de tabla

    • Nombre y descripción de la tabla

    • ID de campo principal

    • Definiciones de campos (ID, nombre, tipo, descripción, opciones)

    • Ver definiciones (ID, nombre, tipo)

  • Descubierto automáticamente desde la API de metadatos de Airtable

Contribuyendo

¡Las solicitudes de extracción son bienvenidas en GitHub! Para empezar:

1. Instalar Git y Node.js

2. Clonar el repositorio

3. Instalar dependencias con npm install

4. Ejecute npm run test para ejecutar pruebas

5. Construir con npm run build

• Puedes usar npm run build:watch para compilar automáticamente después de editar src/index.ts . Esto significa que puedes guardar, recargar Claude Desktop (con Ctrl/Cmd+R) y los cambios se aplicarán.

Lanzamientos

Las versiones siguen la especificación de versiones semánticas .

Para liberar:

1. Utilice npm version <major | minor | patch> para aumentar la versión

2. Ejecute git push --follow-tags para enviar con etiquetas

3. Espere a que GitHub Actions se publique en el registro NPM.