MCP de Airtable

Conecte sus herramientas de IA directamente a Airtable. Consulte, cree, actualice y elimine registros con lenguaje natural. Las funciones incluyen gestión de bases, operaciones con tablas, manipulación de esquemas, filtrado de registros y migración de datos, todo a través de una interfaz MCP estandarizada compatible con Cursor, Claude Code, Cline, Zed y otros editores basados en Claude.

Esta aplicación es una poderosa herramienta de integración de Airtable que permite que las aplicaciones impulsadas por IA a través del Protocolo de contexto de modelo (MCP) de Anthropic accedan y manipulen datos de Airtable directamente desde su IDE.

Características

Gestión de bases : enumera y selecciona bases de Airtable
Operaciones de tabla : Examinar tablas, campos y registros
Acceso a datos : leer, crear, actualizar y eliminar registros
Gestión de esquemas : exportar, comparar y actualizar esquemas
Configuración de la línea de comandos : utilice tokens API directamente a través de parámetros de la línea de comandos
Compatible con NPX : Fácil instalación con un solo comando
Integración de Smithery : instalación con un solo clic a través de Smithery

Arquitectura

Hay dos componentes principales que se utilizan para acceder y manipular los datos de Airtable:

Servidor MCP de Airtable : un servidor Python que proporciona herramientas estandarizadas para que los clientes de IA interactúen con Airtable.
Cliente MCP : cualquier cliente que admita el Protocolo de contexto de modelo (Cursor, Claude Desktop, Cline, Zed, etc.).

┌─────────────┐     ┌──────────────┐     ┌───────────────┐
│  MCP Client │ ──► │  Airtable    │ ──► │   Airtable    │
│  (e.g.      │ ◄── │  MCP Server  │ ◄── │     API       │
│   Cursor)   │     │              │     │               │
└─────────────┘     └──────────────┘     └───────────────┘

El Protocolo de Contexto de Modelo (MCP) es una capacidad compatible con los modelos de IA antrópica que permite crear herramientas personalizadas para cualquier cliente compatible. Clientes MCP como Claude Desktop, Cursor, Cline o Zed pueden ejecutar un servidor MCP que les enseña nuevas herramientas.

Instalación

Prerrequisitos

Node.js 14+
Python 3.10+ (detectado automáticamente)
Token de API de Airtable
Un cliente MCP compatible (Cursor, Claude Desktop, etc.)

Instalación de herrería (recomendada)

La forma más sencilla de instalar:

Visita Smithery
Busca "@rashidazarang/airtable-mcp"
Haga clic en "Instalar" y siga las instrucciones.

Configuración rápida con NPX (alternativa)

Otra forma rápida de empezar:

# Install globally
npm install -g airtable-mcp

# Or run directly with npx
npx airtable-mcp --token "your_airtable_token" --base "your_base_id"

Configurar su cliente MCP

Para Cursor, actualice su archivo ~/.cursor/mcp.json :

{
  "mcpServers": {
    "airtable-tools": {
      "command": "npx",
      "args": [
        "airtable-mcp",
        "--token", "your_airtable_token",
        "--base", "your_base_id"
      ]
    }
  }
}

Reinicie su cliente MCP para cargar las nuevas herramientas.

Instalación manual (avanzada)

Si prefiere clonar el repositorio e instalarlo manualmente:

Clonar este repositorio:
git clone https://github.com/rashidazarang/airtable-mcp.git cd airtable-mcp
Instalar dependencias:
pip install -r requirements.txt
Ejecutar el servidor:
python airtable_mcp/src/server.py --token "your_airtable_token" --base "your_base_id"

Uso

Una vez instalado y configurado, puede utilizar lenguaje natural para interactuar con sus datos de Airtable:

"Muéstrame todas las bases a las que tengo acceso"
"Enumerar las tablas en mi base actual"
"Muéstrame la estructura de la tabla Clientes"
Obtener los primeros 10 registros de la tabla Pedidos
"Crear un nuevo registro en la tabla Productos"
"Actualizar el registro XYZ en la tabla Inventario"
"Exportar el esquema de mi base actual"

Herramientas disponibles

Nombre de la herramienta	Descripción
`list_bases`	Lista de todas las bases Airtable accesibles
`list_tables`	Enumere todas las tablas en la base especificada o predeterminada
`list_records`	Listar registros de una tabla con filtrado opcional
`get_record`	Obtener un registro específico de una tabla
`create_records`	Crear registros en una tabla a partir de una cadena JSON
`update_records`	Actualizar registros en una tabla desde una cadena JSON
`delete_records`	Eliminar registros de una tabla por ID
`export_records`	Exportar registros de una tabla como cadena JSON
`import_records`	Importar registros a una tabla desde una cadena JSON
`create_tables`	Crear tablas a partir de un esquema JSON
`update_schema`	Actualizar las tablas existentes para que coincidan con un esquema JSON
`set_base_id`	Establecer el ID de base de Airtable actual
`inspect_table`	Obtenga información detallada sobre la estructura y los campos de una tabla
`export_schema`	Exportar el esquema de la base actual en formato JSON o CSV
`compare_schemas`	Compare el esquema proporcionado con el esquema base actual
`generate_field_mapping`	Generar un mapeo de campos entre dos tablas
`migrate_data`	Migrar datos de una tabla a otra utilizando la asignación de campos especificada

Configuración de PM2

Para uso en producción, puede utilizar PM2 para administrar el servidor MCP de Airtable:

// ecosystem.config.js
module.exports = {
  apps: [
    {
      name: 'airtable-mcp',
      script: 'npx',
      args: [
        'airtable-mcp',
        '--token', 'your_airtable_token',
        '--base', 'your_base_id'
      ],
      interpreter: '/usr/local/bin/node',
      env: {
        PATH: process.env.PATH,
      },
    },
  ],
};

Empezar con:

pm2 start ecosystem.config.js

Compatibilidad

Funciona con cualquier cliente compatible con MCP
Diseñado principalmente para la integración de Cursor IDE
Admite otros editores de IA y clientes MCP

Documentación detallada

Para obtener instrucciones detalladas de instalación, resolución de problemas y configuraciones avanzadas, consulte INSTALLATION.md .

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Airtable MCP

Integrations