Airtable Formula

Редактор формул, MCP-сервер и AI-навыки для VS Code

Не связано с Airtable Inc. Это проект, поддерживаемый сообществом.
Экспериментально — проект находится в активной разработке и не предназначен для использования в продакшене. API, инструменты и поведение могут измениться без уведомления.

Что в этом репозитории

Этот монорепозиторий поставляет два продукта из одного дерева исходного кода:

	Продукт	Установка
	Airtable Formula — расширение для VS Code	Marketplace
	airtable-user-mcp — автономный MCP-сервер	`npx airtable-user-mcp`

Функции

Расширение для VS Code

Редактор формул — подсветка синтаксиса, IntelliSense, форматирование/минификация для файлов .formula
MCP-сервер — регистрация MCP в один клик для различных IDE
AI-навыки — автоматическая установка специфичных для Airtable навыков, правил и рабочих процессов для AI-помощников в кодинге
Вход в Airtable — учетные данные в связке ключей ОС, аутентификация через браузер с автообновлением
Панель управления — React webview с вкладками «Обзор», «Настройка» и «Параметры»

MCP-сервер (30 инструментов)

Управляйте базами Airtable с помощью возможностей, недоступных через официальный REST API:

Категория	Инструменты	Основное
Чтение схемы	5	Полная проверка схемы — базы, таблицы, поля, представления
Управление полями	8	Создание полей формул / rollup / lookup / count, проверка формул
Конфигурация представлений	11	Фильтры, сортировка, группировка, видимость столбцов, высота строк
Метаданные полей	1	Установка или обновление описаний полей
Управление расширениями	5	Создание, установка, включение/отключение, переименование, удаление расширений

См. полный справочник инструментов в packages/mcp-server/README.md.

Поддерживаемые IDE

Расширение автоматически настраивает MCP для всех основных редакторов с поддержкой AI:


Claude Desktop	Claude Code	Cursor	Windsurf	Cline	Amp

Не используете VS Code? Используйте автономный MCP-сервер напрямую:

npx airtable-user-mcp

Где нас найти

Реестр	Ссылка
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

Требования

VS Code ^1.100.0 (или любой форк, предоставляющий API McpServerDefinitionProvider)
Node.js — поставляется в комплекте с рантаймом VS Code; отдельная установка не требуется
Google Chrome (или Edge / Chromium) — процесс входа в Airtable использует Patchright в headless-режиме. В Windows используется msedge, в Linux — chromium. Расширение показывает предупреждение, если поддерживаемый браузер не обнаружен.

Разработка

Это pnpm монорепозиторий.

Пакет	Описание
`packages/extension`	Хост расширения VS Code (TypeScript + tsup)
`packages/webview`	React-панель управления (Vite + Tailwind v4)
`packages/shared`	Общие типы и протокол сообщений
`packages/mcp-server`	`airtable-user-mcp` — ESM Node MCP-сервер
`scripts/`	Инструменты сборки (бандлер esbuild, вендоринг зависимостей)

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)

Как упакован MCP-сервер: scripts/bundle-mcp.mjs собирает packages/mcp-server/src/ в packages/extension/dist/mcp/. Затем scripts/prepare-package-deps.mjs добавляет patchright, patchright-core и otpauth в dist/node_modules/ перед запуском vsce package. VSIX является полностью автономным.

Поддержка проекта

Этот проект создан и поддерживается с помощью инструментов AI-кодинга. Если вы находите его полезным и хотите поддержать дальнейшую разработку (новые инструменты, обновления, исправления ошибок), вы можете внести вклад, подарив кредиты Claude Code — основной инструмент, используемый для создания этого проекта.

Заинтересовались? Откройте issue или свяжитесь с нами, чтобы обсудить запросы на функции и спонсорство.

Лицензия

MIT

airtable-user-mcp