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 :

Замените 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! Чтобы начать:

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.