MCP-сервер Keboola Explorer

Сервер Keboola MCP

Подключите своих агентов ИИ, клиентов MCP ( Cursor , Claude , Windsurf , VS Code ...) и других помощников ИИ к Keboola. Выставляйте данные, преобразования, запросы SQL и триггеры заданий — не требуется связующий код. Предоставляйте нужные данные агентам тогда и там, где они им нужны.

Обзор

Keboola MCP Server — это мост с открытым исходным кодом между вашим проектом Keboola и современными инструментами ИИ. Он превращает функции Keboola, такие как доступ к хранилищу, преобразования SQL и триггеры заданий, в вызываемые инструменты для Claude, Cursor, CrewAI, LangChain, Amazon Q и других.

Функции

Хранилище : прямой запрос таблиц и управление описаниями таблиц или контейнеров.
Компоненты : создание, перечисление и проверка экстракторов, записывающих устройств, приложений данных и конфигураций преобразования.
SQL : создание преобразований SQL с использованием естественного языка
Задания : запуск компонентов и преобразований, а также получение сведений о выполнении задания.
Метаданные : поиск, чтение и обновление проектной документации и метаданных объектов с использованием естественного языка.

Препараты

Убедитесь, что у вас есть:

[ ] Установлен Python 3.10+
[ ] Доступ к проекту Keboola с правами администратора
[ ] Ваш предпочитаемый клиент MCP (Claude, Cursor и т. д.)

Примечание : Убедитесь, что у вас установлен uv . Клиент MCP будет использовать его для автоматической загрузки и запуска сервера Keboola MCP. Установка uv :

macOS/Linux :

#if homebrew is not installed on your machine use:
# /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install using Homebrew
brew install uv

Окна :

# Using the installer script
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Or using pip
pip install uv

# Or using winget
winget install --id=astral-sh.uv -e

Дополнительные параметры установки см. в официальной документации UV .

Перед настройкой сервера MCP вам понадобятся три ключевые информации:

KBC_STORAGE_TOKEN

Это ваш токен аутентификации для Keboola:

Инструкции по созданию и управлению токенами API хранилища см. в официальной документации Keboola .

Примечание : если вы хотите, чтобы сервер MCP имел ограниченный доступ, используйте пользовательский токен хранилища; если вы хотите, чтобы MCP имел доступ ко всем данным вашего проекта, используйте главный токен.

KBC_WORKSPACE_SCHEMA

Это идентифицирует ваше рабочее пространство в Keboola и требуется для SQL-запросов:

Следуйте этому руководству Keboola , чтобы получить KBC_WORKSPACE_SCHEMA.

Примечание : при создании рабочего пространства установите флажок «Предоставить доступ только для чтения ко всем данным проекта».

Регион Кебула

URL вашего API Keboola зависит от региона развертывания. Вы можете определить свой регион, посмотрев URL в браузере, когда вошли в свой проект Keboola:

Область	URL-адрес API
AWS Северная Америка	`https://connection.keboola.com`
AWS Европа	`https://connection.eu-central-1.keboola.com`
Google Cloud ЕС	`https://connection.europe-west3.gcp.keboola.com`
Google Cloud США	`https://connection.us-east4.gcp.keboola.com`
Лазурный ЕС	`https://connection.north-europe.azure.keboola.com`

Специфическая настройка BigQuery

Если ваш проект Keboola использует бэкэнд BigQuery, вам необходимо установить переменную среды GOOGLE_APPLICATION_CREDENTIALS в дополнение к KBC_STORAGE_TOKEN и KBC_WORKSPACE_SCHEMA :

Перейдите в рабочее пространство Keboola BigQuery и отобразите его учетные данные (нажмите кнопку «Подключить»).
Загрузите файл учетных данных на локальный диск. Это простой файл JSON
Задайте полный путь к загруженному файлу учетных данных JSON в переменной среды GOOGLE_APPLICATION_CREDENTIALS
Это предоставит вашему экземпляру сервера MCP разрешения на доступ к вашей рабочей области BigQuery в Google Cloud. Примечание : KBC_WORKSPACE_SCHEMA называется именем набора данных в рабочей области BigQuery, вам просто нужно нажать «Подключиться» и скопировать имя набора данных.

Запуск сервера Keboola MCP

Существует четыре способа использования сервера Keboola MCP в зависимости от ваших потребностей:

Вариант A: Интегрированный режим (рекомендуется)

В этом режиме Claude или Cursor автоматически запускает сервер MCP для вас. Вам не нужно выполнять какие-либо команды в вашем терминале .

Настройте свой MCP-клиент (Claude/Cursor) с помощью соответствующих параметров.
Клиент автоматически запустит сервер MCP при необходимости.

Конфигурация рабочего стола Клода

Перейдите в Claude (в левом верхнем углу экрана) -> Настройки → Разработчик → Изменить конфигурацию (если вы не видите claude_desktop_config.json, создайте его)
Добавьте следующую конфигурацию:
Перезагрузите рабочий стол Claude, чтобы изменения вступили в силу.

{
  "mcpServers": {
    "keboola": {
      "command": "uvx",
      "args": [
        "keboola_mcp_server",
        "--api-url", "https://connection.YOUR_REGION.keboola.com"
      ],
      "env": {
        "KBC_STORAGE_TOKEN": "your_keboola_storage_token",
        "KBC_WORKSPACE_SCHEMA": "your_workspace_schema"
      }
    }
  }
}

Примечание : для пользователей BigQuery добавьте следующую строку в "env": {}: "GOOGLE_APPLICATION_CREDENTIALS": "/full/path/to/credentials.json"

Расположение файлов конфигурации:

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%\Claude\claude_desktop_config.json

Конфигурация курсора

Перейдите в Настройки → MCP
Нажмите «+ Добавить новый глобальный сервер MCP»
Настройте с помощью следующих параметров:

{
  "mcpServers": {
    "keboola": {
      "command": "uvx",
      "args": [
        "keboola_mcp_server",
        "--api-url", "https://connection.YOUR_REGION.keboola.com"
      ],
      "env": {
        "KBC_STORAGE_TOKEN": "your_keboola_storage_token",
        "KBC_WORKSPACE_SCHEMA": "your_workspace_schema"
      }
    }
  }
}

Примечание : для пользователей BigQuery добавьте следующую строку в "env": {}: "GOOGLE_APPLICATION_CREDENTIALS": "/full/path/to/credentials.json"

Конфигурация курсора для Windows WSL

При запуске сервера MCP из подсистемы Windows для Linux с Cursor AI используйте следующую конфигурацию:

{
  "mcpServers": {
    "keboola": {
      "command": "wsl.exe",
      "args": [
        "bash",
        "-c",
        "'source /wsl_path/to/keboola-mcp-server/.env",
        "&&",
        "/wsl_path/to/keboola-mcp-server/.venv/bin/python -m keboola_mcp_server.cli --transport stdio'"
      ]
    }
  }
}

Где файл /wsl_path/to/keboola-mcp-server/.env содержит переменные среды:

export KBC_STORAGE_TOKEN="your_keboola_storage_token"
export KBC_WORKSPACE_SCHEMA="your_workspace_schema"

Вариант B: Режим локальной разработки

Для разработчиков, работающих над кодом сервера MCP:

Клонируйте репозиторий и настройте локальную среду.
Настройте Claude/Cursor для использования локального пути Python:

{
  "mcpServers": {
    "keboola": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": [
        "-m", "keboola_mcp_server.cli",
        "--transport", "stdio",
        "--api-url", "https://connection.YOUR_REGION.keboola.com"
      ],
      "env": {
        "KBC_STORAGE_TOKEN": "your_keboola_storage_token",
        "KBC_WORKSPACE_SCHEMA": "your_workspace_schema",

      }
    }
  }
}

Примечание : для пользователей BigQuery добавьте следующую строку в "env": {}: "GOOGLE_APPLICATION_CREDENTIALS": "/full/path/to/credentials.json"

Вариант C: Ручной режим CLI (только для тестирования)

Вы можете запустить сервер вручную в терминале для тестирования или отладки:

# Set environment variables
export KBC_STORAGE_TOKEN=your_keboola_storage_token
export KBC_WORKSPACE_SCHEMA=your_workspace_schema
# For BigQuery users
# export GOOGLE_APPLICATION_CREDENTIALS=/full/path/to/credentials.json

# Run with uvx (no installation needed)
uvx keboola_mcp_server --api-url https://connection.YOUR_REGION.keboola.com

# OR, if developing locally
python -m keboola_mcp_server.cli --api-url https://connection.YOUR_REGION.keboola.com

Примечание : Этот режим в первую очередь предназначен для отладки или тестирования. Для обычного использования с Claude или Cursor вам не нужно вручную запускать сервер.

Вариант D: Использование Docker

docker pull keboola/mcp-server:latest

# For Snowflake users
docker run -it \
  -e KBC_STORAGE_TOKEN="YOUR_KEBOOLA_STORAGE_TOKEN" \
  -e KBC_WORKSPACE_SCHEMA="YOUR_WORKSPACE_SCHEMA" \
  keboola/mcp-server:latest \
  --api-url https://connection.YOUR_REGION.keboola.com

# For BigQuery users (add credentials volume mount)
# docker run -it \
#   -e KBC_STORAGE_TOKEN="YOUR_KEBOOLA_STORAGE_TOKEN" \
#   -e KBC_WORKSPACE_SCHEMA="YOUR_WORKSPACE_SCHEMA" \
#   -e GOOGLE_APPLICATION_CREDENTIALS="/creds/credentials.json" \
#   -v /local/path/to/credentials.json:/creds/credentials.json \
#   keboola/mcp-server:latest \
#   --api-url https://connection.YOUR_REGION.keboola.com

Нужно ли мне запускать сервер самостоятельно?

Сценарий	Нужно запустить вручную?	Используйте эту настройку
Использование Клода/Курсора	Нет	Настройте MCP в настройках приложения
Разработка MCP на местном уровне	Нет (Клод начинает)	Укажите конфигурацию на путь python
Тестирование CLI вручную	Да	Используйте терминал для запуска
Использование Докера	Да	Запустить Docker-контейнер

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

После настройки и запуска вашего клиента MCP (Claude/Cursor) вы можете начать запрашивать данные Keboola:

Проверьте свою настройку

Вы можете начать с простого запроса, чтобы убедиться, что все работает:

What buckets and tables are in my Keboola project?

Примеры того, что вы можете сделать

Исследование данных:

«Какие таблицы содержат информацию о клиентах?»
«Выполнить запрос, чтобы найти 10 крупнейших клиентов по размеру дохода»

Анализ данных:

«Проанализируйте мои данные о продажах по регионам за последний квартал»
«Найдите корреляции между возрастом клиентов и частотой покупок»

Конвейеры данных:

«Создайте преобразование SQL, которое объединяет таблицы клиентов и заказов»
«Начать задание по извлечению данных для моего компонента Salesforce»

Совместимость

Поддержка клиентов MCP

Клиент МСР	Статус поддержки	Метод подключения
Клод (настольный компьютер и веб)	✅ поддерживается, протестировано	стдио
Курсор	✅ поддерживается, протестировано	стдио
Виндсерфинг, Зед, Реплит	✅ Поддерживается	стдио
Кодеум, Sourcegraph	✅ Поддерживается	HTTP+SSE
Пользовательские клиенты MCP	✅ Поддерживается	HTTP+SSE или stdio

Поддерживаемые инструменты

Примечание: Keboola MCP — это версия pre-1.0, поэтому могут произойти некоторые критические изменения. Ваши агенты ИИ автоматически подстроятся под новые инструменты.

Категория	Инструмент	Описание
Хранилище	`retrieve_buckets`	Перечисляет все хранилища в вашем проекте Keboola.
	`get_bucket_detail`	Извлекает подробную информацию о конкретном контейнере
	`retrieve_bucket_tables`	Возвращает все таблицы в указанном сегменте
	`get_table_detail`	Предоставляет подробную информацию для конкретной таблицы
	`update_bucket_description`	Обновляет описание ведра
	`update_column_description`	Обновляет описание указанного столбца в таблице.
	`update_table_description`	Обновляет описание таблицы
SQL	`query_table`	Выполняет пользовательские SQL-запросы к вашим данным
	`get_sql_dialect`	Определяет, использует ли ваше рабочее пространство диалект Snowflake или BigQuery SQL.
Компонент	`create_component_root_configuration`	Создает конфигурацию компонента с пользовательскими параметрами
	`create_component_row_configuration`	Создает строку конфигурации компонента с пользовательскими параметрами
	`create_sql_transformation`	Создает SQL-преобразование с пользовательскими запросами
	`find_component_id`	Возвращает список идентификаторов компонентов, соответствующих заданному запросу.
	`get_component`	Получает информацию о конкретном компоненте по его идентификатору
	`get_component_configuration`	Получает информацию о конкретной конфигурации компонента/преобразования
	`get_component_configuration_examples`	Извлекает примеры конфигурации для определенного компонента.
	`retrieve_component_configurations`	Извлекает конфигурации компонентов, присутствующих в проекте.
	`retrieve_transformations`	Извлекает конфигурации преобразований в проекте
	`update_component_root_configuration`	Обновляет определенную конфигурацию компонента
	`update_component_row_configuration`	Обновляет определенную строку конфигурации компонента
	`update_sql_transformation_configuration`	Обновляет существующую конфигурацию преобразования SQL
Работа	`retrieve_jobs`	Перечисляет и фильтрует задания по статусу, компоненту или конфигурации
	`get_job_detail`	Возвращает исчерпывающую информацию о конкретной работе
	`start_job`	Запускает компонент или задание по преобразованию для запуска
Документация	`docs_query`	Поиск документации Keboola на основе запросов на естественном языке

Поиск неисправностей

Общие проблемы

Проблема	Решение
Ошибки аутентификации	Проверьте действительность `KBC_STORAGE_TOKEN`
Проблемы с рабочим пространством	Подтвердите правильность `KBC_WORKSPACE_SCHEMA`
Время ожидания соединения истекло	Проверьте сетевое подключение

Разработка

Установка

Базовая настройка:

uv sync --extra dev

При базовой настройке вы можете использовать uv run tox для запуска тестов и проверки стиля кода.

Рекомендуемая настройка:

uv sync --extra dev --extra tests --extra integtests --extra codestyle

При рекомендуемой настройке будут установлены пакеты для тестирования и проверки стиля кода, что позволит таким IDE, как VsCode или Cursor, проверять код или запускать тесты во время разработки.

Интеграционные тесты

Для локального запуска интеграционных тестов используйте uv run tox -e integtests . ПРИМЕЧАНИЕ: Вам нужно будет установить следующие переменные среды:

INTEGTEST_STORAGE_API_URL
INTEGTEST_STORAGE_TOKEN
INTEGTEST_WORKSPACE_SCHEMA

Чтобы получить эти значения, вам понадобится специальный проект Keboola для интеграционных тестов.

Обновление `uv.lock`

Обновите файл uv.lock , если вы добавили или удалили зависимости. Также рассмотрите возможность обновления блокировки с более новыми версиями зависимостей при создании релиза ( uv lock --upgrade ).

Поддержка и обратная связь

⭐ Основной способ получить помощь, сообщить об ошибках или запросить функции — открыть задачу на GitHub . ⭐

Команда разработчиков активно отслеживает проблемы и будет реагировать как можно быстрее. Для получения общей информации о Keboola, пожалуйста, используйте ресурсы ниже.

Ресурсы

Пользовательская документация
Документация разработчика
Платформа Кебула
Issue Tracker ← Основной метод связи для MCP Server

Соединять

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Этот сервер упрощает взаимодействие с API хранилища Keboola, позволяя пользователям эффективно просматривать и управлять сегментами проекта, таблицами и компонентами через Claude Desktop.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Neo4j Server
da-okazaki
A
security
A
license
A
quality
This server enables interaction between Neo4j databases and Claude Desktop, allowing users to execute Cypher queries, create nodes, and establish relationships in the database.
Last updated -
3
72
24
TypeScript
MIT License
Claude Dev Server
arben-adm
-
security
A
license
-
quality
The Claude Dev Server enables direct interaction with the file system within a specified workspace, allowing users to perform file and directory operations and implement code artifacts in software development using natural language commands.
Last updated -
2
Python
MIT License
Julia Documentation MCP Server
jonathanfischer97
-
security
A
license
-
quality
The server facilitates access to Julia documentation and source code through Claude Desktop, allowing users to retrieve information on Julia packages, modules, types, functions, and methods.
Last updated -
4
0
2
JavaScript
MIT License
Claude Desktop API MCP
mlobo2012
A
security
F
license
A
quality
A server that enables Claude Desktop users to access the Claude API directly, allowing them to bypass Professional Plan limitations and use advanced features like custom system prompts and conversation management.
Last updated -
1
5
Python

View all related MCP servers

Сервер Keboola MCP

Обзор

Функции

Препараты

KBC_STORAGE_TOKEN

KBC_WORKSPACE_SCHEMA

Регион Кебула

Специфическая настройка BigQuery

Запуск сервера Keboola MCP

Вариант A: Интегрированный режим (рекомендуется)

Конфигурация рабочего стола Клода

Конфигурация курсора

Конфигурация курсора для Windows WSL

Вариант B: Режим локальной разработки

Вариант C: Ручной режим CLI (только для тестирования)

Вариант D: Использование Docker

Нужно ли мне запускать сервер самостоятельно?

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

Проверьте свою настройку

Примеры того, что вы можете сделать

Совместимость

Поддержка клиентов MCP

Поддерживаемые инструменты

Поиск неисправностей

Общие проблемы

Разработка

Установка

Интеграционные тесты

Обновление uv.lock

Поддержка и обратная связь

Ресурсы

Соединять

Tools

Related Resources

Related MCP Servers

MCP Neo4j Server

Claude Dev Server

Julia Documentation MCP Server

Claude Desktop API MCP

Appeared in Searches

New MCP Servers

MCP directory API

Обновление `uv.lock`