Airtable Formula

Editor de fórmulas, servidor MCP y habilidades de IA para VS Code

No afiliado a Airtable Inc. Este es un proyecto mantenido por la comunidad.
Experimental — Este proyecto está en desarrollo activo y no está destinado para uso en producción. Las API, las herramientas y el comportamiento pueden cambiar sin previo aviso.

Qué hay en este repositorio

Este monorepo distribuye dos productos desde un mismo árbol de fuentes:

	Producto	Instalación
	Airtable Formula — Extensión de VS Code	Marketplace
	airtable-user-mcp — Servidor MCP independiente	`npx airtable-user-mcp`

Características

Extensión de VS Code

Editor de fórmulas — Resaltado de sintaxis, IntelliSense, embellecer / minificar para archivos .formula
Servidor MCP — Registro de MCP con un solo clic para múltiples IDEs
Habilidades de IA — Instalación automática de habilidades, reglas y flujos de trabajo específicos de Airtable para asistentes de codificación por IA
Inicio de sesión en Airtable — Credenciales en el llavero del SO, autenticación basada en navegador con actualización automática
Panel de control — Vista web de React con pestañas de Resumen, Configuración y Ajustes

Servidor MCP (30 herramientas)

Gestione bases de Airtable con capacidades no disponibles a través de la API REST oficial:

Categoría	Herramientas	Aspectos destacados
Lectura de esquema	5	Inspección completa del esquema: bases, tablas, campos, vistas
Gestión de campos	8	Crear campos de fórmula / rollup / lookup / count, validar fórmulas
Configuración de vistas	11	Filtros, ordenación, agrupación, visibilidad de columnas, altura de filas
Metadatos de campos	1	Establecer o actualizar descripciones de campos
Gestión de extensiones	5	Crear, instalar, habilitar/deshabilitar, renombrar, eliminar extensiones

Consulte la referencia completa de herramientas en packages/mcp-server/README.md.

IDEs compatibles

La extensión configura automáticamente MCP para todos los editores principales habilitados para IA:


Claude Desktop	Claude Code	Cursor	Windsurf	Cline	Amp

¿No usa VS Code? Utilice el servidor MCP independiente directamente:

npx airtable-user-mcp

Encuéntrenos

Registro	Enlace
VS Code Marketplace	`Nskha.airtable-formula`
npm	`airtable-user-mcp`
Open VSX	`Nskha.airtable-formula`
MCP Registry	`io.github.automations-project/airtable-user-mcp`
Glama	glama.ai/mcp/servers
PulseMCP	pulsemcp.com
MCP.so	mcp.so

Requisitos

VS Code ^1.100.0 (o cualquier fork que exponga la API McpServerDefinitionProvider)
Node.js — incluido a través del tiempo de ejecución de VS Code; no se necesita instalación por separado
Google Chrome (o Edge / Chromium) — el flujo de inicio de sesión de Airtable utiliza Patchright en modo headless. Vuelve a msedge en Windows y chromium en Linux. La extensión muestra una advertencia accionable si no se detecta un navegador compatible.

Desarrollo

Este es un pnpm monorepo.

Paquete	Descripción
`packages/extension`	Host de la extensión de VS Code (TypeScript + tsup)
`packages/webview`	Vista web del panel de control de React (Vite + Tailwind v4)
`packages/shared`	Tipos compartidos y protocolo de mensajes
`packages/mcp-server`	`airtable-user-mcp` — Servidor MCP de Node ESM
`scripts/`	Herramientas de compilación (empaquetador esbuild, vendoring de dependencias)

pnpm install          # install all packages
pnpm build            # build shared → webview → mcp bundle → extension
pnpm package          # build + create airtable-formula-X.Y.Z.vsix
pnpm test             # run all unit tests
pnpm dev              # start webview dev server (browser preview)

Cómo se empaqueta el servidor MCP: scripts/bundle-mcp.mjs empaqueta packages/mcp-server/src/ en packages/extension/dist/mcp/. Luego, scripts/prepare-package-deps.mjs incluye patchright, patchright-core y otpauth en dist/node_modules/ antes de que se ejecute vsce package. El VSIX es totalmente autónomo.

Apoye este proyecto

Este proyecto se construye y mantiene con la ayuda de herramientas de codificación por IA. Si le resulta útil y desea apoyar el desarrollo continuo (nuevas herramientas, actualizaciones, correcciones de errores), puede contribuir regalando créditos de Claude Code, la herramienta principal utilizada para construir este proyecto.

¿Interesado? Abra un issue o contáctenos para discutir solicitudes de funciones y patrocinio.

Licencia

MIT

airtable-user-mcp