airtable-mcp-server

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.