airtable-mcp-server

Сервер протокола контекста модели (MCP), обеспечивающий доступ на чтение и запись к базам данных Airtable. Этот сервер позволяет LLM изучать схемы баз данных, а затем читать и записывать записи.

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

Установка

Шаг 1: Создайте персональный токен доступа Airtable, нажав здесь. Подробности:

• Имя: Любое, например 'Airtable MCP Server Token'.

• Области доступа (Scopes): schema.bases:read, data.records:read, а также опционально schema.bases:write, data.records:write, data.recordComments:read и data.recordComments:write.

• Доступ: Базы, к которым вы хотите получить доступ. Если вы не уверены, выберите 'Add all resources'.

Держите токен под рукой, он понадобится на следующем шаге. Он должен выглядеть примерно так: pat123.abc123 (но длиннее).

Шаг 2: Следуйте инструкциям ниже для вашего предпочтительного клиента:

• Claude Desktop

• Cursor

• Cline

Claude Desktop

(Рекомендуется) Через браузер расширений

1. Откройте Claude Desktop и перейдите в Settings → Extensions

2. Нажмите 'Browse Extensions' и найдите 'Airtable MCP Server'

3. Нажмите 'Install' и вставьте свой API-ключ

(Продвинутый уровень) Альтернатива: Через ручную установку .mcpb

1. Найдите последнюю сборку mcpb в истории GitHub Actions (самую верхнюю)

2. В разделе 'Artifacts' скачайте файл airtable-mcp-server-mcpb

3. Переименуйте файл .zip в .mcpb

4. Дважды щелкните файл .mcpb, чтобы открыть его в Claude Desktop

5. Нажмите "Install" и настройте с помощью вашего API-ключа

(Продвинутый уровень) Альтернатива: Через JSON-конфигурацию

1. Установите Node.js

2. Откройте Claude Desktop и перейдите в Settings → Developer

3. Нажмите "Edit Config", чтобы открыть файл claude_desktop_config.json

4. Добавьте следующую конфигурацию в раздел "mcpServers", заменив pat123.abc123 на ваш API-ключ:

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": [
        "-y",
        "airtable-mcp-server"
      ],
      "env": {
        "AIRTABLE_API_KEY": "pat123.abc123",
      }
    }
  }
}

5. Сохраните файл и перезапустите Claude Desktop

Cursor

(Рекомендуется) Установка в один клик

1. Нажмите

2. Отредактируйте файл mcp.json, чтобы вставить ваш API-ключ

(Продвинутый уровень) Альтернатива: Через JSON-конфигурацию

Создайте глобальный (~/.cursor/mcp.json) или специфичный для проекта (.cursor/mcp.json) файл конфигурации, заменив pat123.abc123 на ваш API-ключ:

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": ["-y", "airtable-mcp-server"],
      "env": {
        "AIRTABLE_API_KEY": "pat123.abc123"
      }
    }
  }
}

Cline

(Рекомендуется) Через маркетплейс

1. Нажмите значок "MCP Servers" в расширении Cline

2. Найдите "Airtable" и нажмите "Install"

3. Следуйте подсказкам для установки сервера

(Продвинутый уровень) Альтернатива: Через JSON-конфигурацию

1. Нажмите значок "MCP Servers" в расширении Cline

2. Перейдите на вкладку "Installed", затем нажмите кнопку "Configure MCP Servers" внизу

3. Добавьте следующую конфигурацию в раздел "mcpServers", заменив pat123.abc123 на ваш API-ключ:

{
  "mcpServers": {
    "airtable": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "airtable-mcp-server"],
      "env": {
        "AIRTABLE_API_KEY": "pat123.abc123"
      }
    }
  }
}

Related MCP server: MCP TapData Server

Компоненты

Инструменты

• list_records

  • Выводит список записей из указанной таблицы Airtable

  • Входные параметры:

    • baseId (строка, обязательно): ID базы Airtable

    • tableId (строка, обязательно): ID таблицы для запроса

    • maxRecords (число, опционально): Максимальное количество возвращаемых записей. По умолчанию 100.

    • filterByFormula (строка, опционально): Формула Airtable для фильтрации записей

• search_records

  • Поиск записей, содержащих определенный текст

  • Входные параметры:

    • baseId (строка, обязательно): ID базы Airtable

    • tableId (строка, обязательно): ID таблицы для запроса

    • searchTerm (строка, обязательно): Текст для поиска в записях

    • fieldIds (массив, опционально): Конкретные ID полей для поиска. Если не указано, поиск ведется по всем текстовым полям.

    • maxRecords (число, опционально): Максимальное количество возвращаемых записей. По умолчанию 100.

• list_bases

  • Выводит список всех доступных баз Airtable

  • Входные параметры не требуются

  • Возвращает ID базы, имя и уровень разрешений

• list_tables

  • Выводит список всех таблиц в конкретной базе

  • Входные параметры:

    • baseId (строка, обязательно): ID базы Airtable

    • detailLevel (строка, опционально): Уровень детализации информации о таблицах (tableIdentifiersOnly, identifiersOnly или full)

  • Возвращает ID таблицы, имя, описание, поля и представления (согласно заданному detailLevel)

• describe_table

  • Получает подробную информацию о конкретной таблице

  • Входные параметры:

    • baseId (строка, обязательно): ID базы Airtable

    • tableId (строка, обязательно): ID таблицы для описания

    • detailLevel (строка, опционально): Уровень детализации информации о таблице (tableIdentifiersOnly, identifiersOnly или full)

  • Возвращает тот же формат, что и list_tables, но для одной таблицы

  • Полезно для получения сведений о конкретной таблице без загрузки информации обо всех таблицах в базе

• get_record

  • Получает конкретную запись по ID

  • Входные параметры:

    • baseId (строка, обязательно): ID базы Airtable

    • tableId (строка, обязательно): ID таблицы

    • recordId (строка, обязательно): ID записи для получения

• create_record

  • Создает новую запись в таблице

  • Входные параметры:

    • baseId (строка, обязательно): ID базы Airtable

    • tableId (строка, обязательно): ID таблицы

    • fields (объект, обязательно): Поля и значения для новой записи

• update_records

  • Обновляет одну или несколько записей в таблице

  • Входные параметры:

    • baseId (строка, обязательно): ID базы Airtable

    • tableId (строка, обязательно): ID таблицы

    • records (массив, обязательно): Массив объектов, содержащих ID записи и поля для обновления

• delete_records

  • Удаляет одну или несколько записей из таблицы

  • Входные параметры:

    • baseId (строка, обязательно): ID базы Airtable

    • tableId (строка, обязательно): ID таблицы

    • recordIds (массив, обязательно): Массив ID записей для удаления

• create_table

  • Создает новую таблицу в базе

  • Входные параметры:

    • baseId (строка, обязательно): ID базы Airtable

    • name (строка, обязательно): Имя новой таблицы

    • description (строка, опционально): Описание таблицы

    • fields (массив, обязательно): Массив определений полей (имя, тип, описание, опции)

• update_table

  • Обновляет имя или описание таблицы

  • Входные параметры:

    • baseId (строка, обязательно): ID базы Airtable

    • tableId (строка, обязательно): ID таблицы

    • name (строка, опционально): Новое имя таблицы

    • description (строка, опционально): Новое описание таблицы

• create_field

  • Создает новое поле в таблице

  • Входные параметры:

    • baseId (строка, обязательно): ID базы Airtable

    • tableId (строка, обязательно): ID таблицы

    • name (строка, обязательно): Имя нового поля

    • type (строка, обязательно): Тип поля

    • description (строка, опционально): Описание поля

    • options (объект, опционально): Опции, специфичные для поля

• update_field

  • Обновляет имя или описание поля

  • Входные параметры:

    • baseId (строка, обязательно): ID базы Airtable

    • tableId (строка, обязательно): ID таблицы

    • fieldId (строка, обязательно): ID поля

    • name (строка, опционально): Новое имя поля

    • description (строка, опционально): Новое описание поля

• create_comment

  • Создает комментарий к записи

  • Входные параметры:

    • baseId (строка, обязательно): ID базы Airtable

    • tableId (строка, обязательно): ID таблицы

    • recordId (строка, обязательно): ID записи

    • text (строка, обязательно): Текст комментария

    • parentCommentId (строка, опционально): ID родительского комментария для ответов в ветке

  • Возвращает созданный комментарий с ID, автором, временем создания и текстом

• list_comments

  • Выводит список комментариев к записи

  • Входные параметры:

    • baseId (строка, обязательно): ID базы Airtable

    • tableId (строка, обязательно): ID таблицы

    • recordId (строка, обязательно): ID записи

    • pageSize (число, опционально): Количество возвращаемых комментариев (макс. 100, по умолчанию 100)

    • offset (строка, опционально): Смещение пагинации для получения дополнительных комментариев

  • Возвращает массив комментариев с автором, текстом, временными метками, реакциями и упоминаниями

  • Комментарии возвращаются от новых к старым

HTTP-транспорт

Сервер также может работать в режиме HTTP для использования с удаленными клиентами MCP:

MCP_TRANSPORT=http PORT=3000 npx airtable-mcp-server

Это запускает stateless HTTP-сервер по адресу http://localhost:3000/mcp. Обратите внимание: HTTP-транспорт не имеет встроенной аутентификации — используйте его только за обратным прокси-сервером или в защищенной среде.

Участие в разработке

Pull-запросы приветствуются на GitHub! Чтобы начать:

1. Установите Git и Node.js

2. Клонируйте репозиторий

3. Установите зависимости с помощью npm install

4. Запустите npm run test для выполнения тестов

5. Соберите проект с помощью npm run build

• Вы можете использовать npm run build:watch для автоматической сборки после редактирования src/index.ts. Это означает, что вы можете сохранить файл, перезагрузить Claude Desktop (с помощью Ctrl/Cmd+R), и изменения применятся.

Релизы

Версии соответствуют спецификации семантического версионирования.

Для выпуска новой версии:

1. Используйте npm version <major | minor | patch> для увеличения версии

2. Выполните git push --follow-tags для отправки с тегами

3. Дождитесь публикации GitHub Actions в реестре NPM.