airtable-mcp-сервер

Сервер Model Context Protocol, который обеспечивает доступ на чтение и запись к базам данных Airtable. Этот сервер позволяет LLM проверять схемы баз данных, а затем читать и записывать записи.

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

Использование

Чтобы использовать этот сервер с приложением Claude Desktop, добавьте следующую конфигурацию в раздел «mcpServers» вашего claude_desktop_config.json :

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

Замените pat123.abc123 на ваш персональный токен доступа Airtable . Ваш токен должен иметь как минимум schema.bases:read и data.records:read , а также опционально соответствующие разрешения на запись.

Компоненты

Инструменты

список_записей
- Выводит список записей из указанной таблицы Airtable
- Входные параметры:
  - baseId (строка, обязательно): идентификатор базы Airtable
  - tableId (строка, обязательно): идентификатор таблицы для запроса
  - maxRecords (число, необязательно): Максимальное количество возвращаемых записей. По умолчанию 100.
  - filterByFormula (строка, необязательно): формула Airtable для фильтрации записей
поиск_записей
- Поиск записей, содержащих определенный текст
- Входные параметры:
  - baseId (строка, обязательно): идентификатор базы Airtable
  - tableId (строка, обязательно): идентификатор таблицы для запроса
  - searchTerm (строка, обязательно): Текст для поиска в записях
  - fieldIds (массив, необязательно): конкретные идентификаторы полей для поиска. Если не указано, выполняется поиск по всем текстовым полям.
  - maxRecords (число, необязательно): Максимальное количество возвращаемых записей. По умолчанию 100.
список_баз
- Список всех доступных оснований Airtable
- Входные параметры не требуются
- Возвращает базовый идентификатор, имя и уровень разрешений.
список_таблиц
- Перечисляет все таблицы в определенной базе
- Входные параметры:
  - baseId (строка, обязательно): идентификатор базы Airtable
  - detailLevel (строка, необязательно): объем сведений, которые необходимо получить о таблицах ( tableIdentifiersOnly , identifiersOnly или full ).
- Возвращает идентификатор таблицы, имя, описание, поля и представления (для указанного detailLevel )
описать_таблицу
- Получает подробную информацию о конкретной таблице
- Входные параметры:
  - baseId (строка, обязательно): идентификатор базы Airtable
  - tableId (строка, обязательно): идентификатор описываемой таблицы.
  - detailLevel (строка, необязательно): объем сведений, которые необходимо получить о таблице ( tableIdentifiersOnly , identifiersOnly или full ).
- Возвращает тот же формат, что и list_tables, но для одной таблицы.
- Полезно для получения сведений о конкретной таблице без извлечения информации обо всех таблицах в базе.
получить_запись
- Получает определенную запись по идентификатору
- Входные параметры:
  - baseId (строка, обязательно): идентификатор базы Airtable
  - tableId (строка, обязательно): идентификатор таблицы
  - recordId (строка, обязательно): идентификатор записи для извлечения.
создать_запись
- Создает новую запись в таблице
- Входные параметры:
  - baseId (строка, обязательно): идентификатор базы Airtable
  - tableId (строка, обязательно): идентификатор таблицы
  - fields (объект, обязательно): поля и значения для новой записи
обновление_записей
- Обновляет одну или несколько записей в таблице
- Входные параметры:
  - baseId (строка, обязательно): идентификатор базы Airtable
  - tableId (строка, обязательно): идентификатор таблицы
  - records (массив, обязательно): Массив объектов, содержащий идентификатор записи и поля для обновления.
удалить_записи
- Удаляет одну или несколько записей из таблицы
- Входные параметры:
  - baseId (строка, обязательно): идентификатор базы Airtable
  - tableId (строка, обязательно): идентификатор таблицы
  - recordIds (массив, обязательно): Массив идентификаторов записей для удаления
создать_таблицу
- Создает новую таблицу в базе
- Входные параметры:
  - baseId (строка, обязательно): идентификатор базы Airtable
  - name (строка, обязательно): Имя новой таблицы
  - description (строка, необязательно): Описание таблицы
  - fields (массив, обязательно): Массив определений полей (имя, тип, описание, параметры)
обновить_таблицу
- Обновляет имя или описание таблицы
- Входные параметры:
  - baseId (строка, обязательно): идентификатор базы Airtable
  - tableId (строка, обязательно): идентификатор таблицы
  - name (строка, необязательно): Новое имя для таблицы
  - description (строка, необязательно): Новое описание для таблицы
создать_поле
- Создает новое поле в таблице
- Входные параметры:
  - baseId (строка, обязательно): идентификатор базы Airtable
  - tableId (строка, обязательно): идентификатор таблицы
  - name (строка, обязательно): Имя нового поля
  - type (строка, обязательно): Тип поля
  - description (строка, необязательно): Описание поля
  - options (объект, необязательно): параметры, специфичные для поля
обновление_поля
- Обновляет имя или описание поля
- Входные параметры:
  - baseId (строка, обязательно): идентификатор базы Airtable
  - tableId (строка, обязательно): идентификатор таблицы
  - fieldId (строка, обязательно): идентификатор поля
  - name (строка, необязательно): Новое имя для поля
  - description (строка, необязательно): Новое описание поля

Ресурсы

Сервер предоставляет информацию о схеме для баз и столов Airtable:

Схемы таблиц ( airtable://<baseId>/<tableId>/schema )
- Информация о схеме JSON для каждой таблицы
- Включает в себя:
  - Базовый идентификатор и идентификатор таблицы
  - Название и описание таблицы
  - Идентификатор основного поля
  - Определения полей (ID, имя, тип, описание, параметры)
  - Просмотреть определения (ID, имя, тип)
- Автоматически обнаруживается с помощью API метаданных Airtable

Внося вклад

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

Установить Git и Node.js
Клонировать репозиторий
Установка зависимостей с помощью npm install
Запустите npm run test для запуска тестов
Сборка с помощью npm run build

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

Релизы

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

Для выпуска:

Используйте npm version <major | minor | patch> для повышения версии
Выполните git push --follow-tags для отправки с тегами
Дождитесь публикации GitHub Actions в реестре NPM.

airtable-mcp-server

Integrations