Powerdrill

Powerdrill MCP-сервер

Сервер Model Context Protocol (MCP), предоставляющий инструменты для взаимодействия с наборами данных Powerdrill, с аутентификацией по идентификатору пользователя и API-ключу проекта Powerdrill.

Пожалуйста, перейдите на https://chat.powerdrill.ai/ для индивидуального анализа данных с помощью ИИ или используйте его вместе с вашей командой.

Если у вас есть идентификатор пользователя и API-ключ проекта вашей команды Powerdrill, вы можете управлять данными через веб-клиенты Powerdrill с открытым исходным кодом:

• Версия для Node.js: https://flow.powerdrill.ai/, или поработайте с веб-клиентом с открытым исходным кодом https://github.com/powerdrillai/powerdrill-flow.
• Версия для Python: https://powerdrill-flow.streamlit.app/, или поработайте с веб-клиентом с открытым исходным кодом https://github.com/powerdrillai/powerdrill-flow-streamlit.

Возможности

• Аутентификация в Powerdrill с использованием идентификатора пользователя и API-ключа проекта
• Просмотр доступных наборов данных в вашей учетной записи Powerdrill
• Получение подробной информации о конкретных наборах данных
• Создание и запуск заданий на наборах данных с вопросами на естественном языке
• Интеграция с Claude Desktop и другими MCP-совместимыми клиентами

Установка

Установка через Smithery

Чтобы установить powerdrill-mcp для Claude Desktop автоматически через Smithery:

npx -y @smithery/cli install @powerdrillai/powerdrill-mcp --client claude

Из npm

# Install globally
npm install -g @powerdrillai/powerdrill-mcp

# Or run directly with npx
npx @powerdrillai/powerdrill-mcp

Из исходного кода

Клонируйте этот репозиторий и установите зависимости:

git clone https://github.com/yourusername/powerdrill-mcp.git
cd powerdrill-mcp
npm install

Использование в командной строке

При глобальной установке:

# Start the MCP server
powerdrill-mcp

При использовании npx:

# Run the latest version
npx -y @powerdrillai/powerdrill-mcp@latest

Перед запуском вам потребуется настроить переменные окружения с вашими учетными данными Powerdrill:

# Set environment variables
export POWERDRILL_USER_ID="your_user_id"
export POWERDRILL_PROJECT_API_KEY="your_project_api_key"

Или создайте файл .env с этими значениями.

Предварительные требования

Для использования этого MCP-сервера вам понадобится учетная запись Powerdrill с действительными API-учетными данными (Идентификатор пользователя и API-ключ). Вот как их получить:

1. Зарегистрируйте командную учетную запись Powerdrill, если у вас ее еще нет
2. Перейдите в настройки учетной записи
3. Найдите раздел API, где вы увидите:
   • Идентификатор пользователя: уникальный идентификатор вашей учетной записи
   • API-ключ: ваш токен аутентификации для доступа к API

Сначала посмотрите это видео-руководство о том, как создать команду Powerdrill:

Затем следуйте этому видео-руководству по настройке ваших API-учетных данных:

Быстрая настройка

Самый простой способ настроить сервер — использовать предоставленный сценарий настройки:

# Make the script executable
chmod +x setup.sh

# Run the setup script
./setup.sh

Он выполнит:

1. Установку зависимостей
2. Сборку кода TypeScript
3. Создание файла .env, если он не существует
4. Генерацию файлов конфигурации для Claude Desktop и Cursor с конфигурацией на основе npx (рекомендуется)

Затем отредактируйте файл .env, указав ваши реальные учетные данные:

POWERDRILL_USER_ID=your_actual_user_id
POWERDRILL_PROJECT_API_KEY=your_actual_project_api_key

Также обновите учетные данные в сгенерированных файлах конфигурации перед их использованием.

Ручная установка

Если вы предпочитаете настройку вручную:

# Install dependencies
npm install

# Build the TypeScript code
npm run build

# Copy the environment example file
cp .env.example .env

# Edit the .env file with your credentials

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

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

npm start

Интеграция с Claude Desktop

1. Откройте Claude Desktop
2. Перейдите в Settings > Server Settings
3. Добавьте новый сервер с одной из следующих конфигураций:

Вариант 1: Использование npx (рекомендуется)

{
  "powerdrill": {
    "command": "npx",
    "args": [
      "-y",
      "@powerdrillai/powerdrill-mcp@latest"
    ],
    "env": {
      "POWERDRILL_USER_ID": "your_actual_user_id",
      "POWERDRILL_PROJECT_API_KEY": "your_actual_project_api_key"
    }
  }
}

Вариант 2: Использование node с локальной установкой

{
  "powerdrill": {
    "command": "node",
    "args": ["/path/to/powerdrill-mcp/dist/index.js"],
    "env": {
      "POWERDRILL_USER_ID": "your_actual_user_id",
      "POWERDRILL_PROJECT_API_KEY": "your_actual_project_api_key"
    }
  }
}

4. Сохраните конфигурацию
5. Перезапустите Claude Desktop

Интеграция с Cursor

1. Откройте Cursor
2. Перейдите в Settings > MCP Tools
3. Добавьте новый инструмент MCP с одной из следующих конфигураций:

Вариант 1: Использование npx (рекомендуется)

{
  "powerdrill": {
    "command": "npx",
    "args": [
      "-y",
      "@powerdrillai/powerdrill-mcp@latest"
    ],
    "env": {
      "POWERDRILL_USER_ID": "your_actual_user_id",
      "POWERDRILL_PROJECT_API_KEY": "your_actual_project_api_key"
    }
  }
}

Вариант 2: Использование node с локальной установкой

{
  "powerdrill": {
    "command": "node",
    "args": ["/path/to/powerdrill-mcp/dist/index.js"],
    "env": {
      "POWERDRILL_USER_ID": "your_actual_user_id",
      "POWERDRILL_PROJECT_API_KEY": "your_actual_project_api_key"
    }
  }
}

4. Сохраните конфигурацию
5. При необходимости перезапустите Cursor

Использование инструментов

После подключения вы можете использовать инструменты Powerdrill в беседах с Claude Desktop, Cursor, Cline, Windsurf и т. д.:

• Список наборов данных: What datasets are available in my Powerdrill account? или Show me all my datasets
• Создать набор данных: Create a new dataset called "Sales Analytics" или Make a new dataset named "Customer Data" with description "Customer information for 2024 analysis"
• Создать источник данных из локального файла: Upload the file /Users/your_name/Downloads/sales_data.csv to dataset {dataset_id} или Add my local file /path/to/customer_data.xlsx to my {dataset_id} dataset
• Получить обзор набора данных: Tell me more about this dataset: {dataset_id} или Describe the structure of dataset {dataset_id}
• Создать задание: Analyze dataset {dataset_id} with this question: "How has the trend changed over time?" или Run a query on {dataset_id} asking "What are the top 10 customers by revenue?"
• Создать сессию: Create a new session named "Sales Analysis 2024" for my data analysis или Start a session called "Customer Segmentation" for analyzing market data
• Список источников данных: What data sources are available in dataset {dataset_id}? или Show me all files in the {dataset_id} dataset
• Список сессий: Show me all my current analysis sessions или List my recent data analysis sessions

Доступные инструменты

mcp_powerdrill_list_datasets

Выводит список доступных наборов данных из вашей учетной записи Powerdrill.

Параметры:

• limit (необязательный): Максимальное количество возвращаемых наборов данных

Пример ответа:

{
  "datasets": [
    {
      "id": "dataset-dasfadsgadsgas",
      "name": "mydata",
      "description": "my dataset"
    }
  ]
}

mcp_powerdrill_get_dataset_overview

Получает подробную обзорную информацию о конкретном наборе данных.

Параметры:

• datasetId (обязательный): Идентификатор набора данных, для которого нужно получить обзорную информацию

Пример ответа:

{
  "id": "dset-cm5axptyyxxx298",
  "name": "sales_indicators_2024",
  "description": "A dataset comprising 373 travel bookings with 15 attributes...",
  "summary": "This dataset contains 373 travel bookings with 15 attributes...",
  "exploration_questions": [
    "How does the booking price trend over time based on the BookingTimestamp?",
    "How does the average booking price change with respect to the TravelDate?"
  ],
  "keywords": [
    "Travel Bookings",
    "Booking Trends",
    "Travel Agencies"
  ]
}

mcp_powerdrill_create_job

Создает задание для анализа данных с вопросами на естественном языке.

Параметры:

• question (обязательный): Вопрос или запрос на естественном языке для анализа данных
• dataset_id (обязательный): Идентификатор набора данных для анализа
• datasource_ids (необязательный): Массив конкретных идентификаторов источников данных в наборе данных для анализа
• session_id (необязательный): Идентификатор сессии для группировки связанных заданий
• stream (необязательный, по умолчанию: false): Следует ли передавать результаты в потоковом режиме
• output_language (необязательный, по умолчанию: "AUTO"): Язык вывода
• job_mode (необязательный, по умолчанию: "AUTO"): Режим задания

Пример ответа:

{
  "job_id": "job-cm3ikdeuj02zk01l1yeuirt77",
  "blocks": [
    {
      "type": "CODE",
      "content": "```python\nimport pandas as pd\n\ndef invoke(input_0: pd.DataFrame) -> pd.DataFrame:\n...",
      "stage": "Analyze"
    },
    {
      "type": "TABLE",
      "url": "https://static.powerdrill.ai/tmp_datasource_cache/code_result/...",
      "name": "trend_data.csv",
      "expires_at": "2024-11-21T09:56:34.290544Z"
    },
    {
      "type": "IMAGE",
      "url": "https://static.powerdrill.ai/tmp_datasource_cache/code_result/...",
      "name": "Trend of Deaths from Natural Disasters Over the Century",
      "expires_at": "2024-11-21T09:56:34.290544Z"
    },
    {
      "type": "MESSAGE",
      "content": "Analysis of Trends in the Number of Deaths from Natural Disasters...",
      "stage": "Respond"
    }
  ]
}

mcp_powerdrill_create_session

Создает новую сессию для группировки связанных заданий.

Параметры:

• name (обязательный): Имя сессии, длина которого может составлять до 128 символов
• output_language (необязательный, по умолчанию: "AUTO"): Язык, на котором генерируется вывод. Варианты: "AUTO", "EN", "ES", "AR", "PT", "ID", "JA", "RU", "HI", "FR", "DE", "VI", "TR", "PL", "IT", "KO", "ZH-CN", "ZH-TW"
• job_mode (необязательный, по умолчанию: "AUTO"): Режим задания для сессии. Варианты: "AUTO", "DATA_ANALYTICS"
• max_contextual_job_history (необязательный, по умолчанию: 10): Максимальное количество последних заданий, сохраняемых в качестве контекста для следующего задания (0-10)
• agent_id (необязательный, по умолчанию: "DATA_ANALYSIS_AGENT"): Идентификатор агента

Пример ответа:

{
  "session_id": "session-abcdefghijklmnopqrstuvwxyz"
}

mcp_powerdrill_list_data_sources

Выводит список источников данных в конкретном наборе данных.

Параметры:

• datasetId (обязательный): Идентификатор набора данных, из которого нужно вывести список источников данных
• pageNumber (необязательный, по умолчанию: 1): Номер страницы, с которой начать список
• pageSize (необязательный, по умолчанию: 10): Количество элементов на одной странице
• status (необязательный): Фильтрация источников данных по статусу: synching, invalid, synched (через запятую для нескольких)

Пример ответа:

{
  "count": 3,
  "total": 5,
  "page": 1,
  "page_size": 10,
  "data_sources": [
    {
      "id": "dsource-a1b2c3d4e5f6g7h8i9j0",
      "name": "sales_data.csv",
      "type": "CSV",
      "status": "synched",
      "size": 1048576,
      "dataset_id": "dset-cm5axptyyxxx298"
    },
    {
      "id": "dsource-b2c3d4e5f6g7h8i9j0k1",
      "name": "customer_info.xlsx",
      "type": "EXCEL",
      "status": "synched",
      "size": 2097152,
      "dataset_id": "dset-cm5axptyyxxx298"
    },
    {
      "id": "dsource-c3d4e5f6g7h8i9j0k1l2",
      "name": "market_research.pdf",
      "type": "PDF",
      "status": "synched",
      "size": 3145728,
      "dataset_id": "dset-cm5axptyyxxx298"
    }
  ]
}

mcp_powerdrill_list_sessions

Выводит список сессий из вашей учетной записи Powerdrill.

Параметры:

• pageNumber (необязательный): Номер страницы, с которой начать список (по умолчанию: 1)
• pageSize (необязательный): Количество элементов на одной странице (по умолчанию: 10)
• search (необязательный): Поиск сессий по имени

Пример ответа:

{
  "count": 2,
  "total": 2,
  "sessions": [
    {
      "id": "session-123abc",
      "name": "Product Analysis",
      "job_count": 3,
      "created_at": "2024-03-15T10:30:00Z",
      "updated_at": "2024-03-15T11:45:00Z"
    },
    {
      "id": "session-456def",
      "name": "Financial Forecasting",
      "job_count": 5,
      "created_at": "2024-03-10T14:20:00Z",
      "updated_at": "2024-03-12T09:15:00Z"
    }
  ]
}

mcp_powerdrill_create_dataset

Создает новый набор данных в вашей учетной записи Powerdrill.

Параметры:

• name (обязательный): Имя набора данных, длина которого может составлять до 128 символов
• description (необязательный): Описание набора данных, длина которого может составлять до 128 символов

Пример ответа:

{
  "id": "dataset-adsdfasafdsfasdgasd",
  "message": "Dataset created successfully"
}

mcp_powerdrill_create_data_source_from_local_file

Создает новый источник данных путем загрузки локального файла в указанный набор данных.

Параметры:

• dataset_id (обязательный): Идентификатор набора данных, в котором нужно создать источник данных
• file_path (обязательный): Локальный путь к загружаемому файлу
• file_name (необязательный): Пользовательское имя файла, по умолчанию используется исходное имя файла
• chunk_size (необязательный, по умолчанию: 5 МБ): Размер каждого фрагмента в байтах для многокомпонентной загрузки

Пример ответа:

{
  "dataset_id": "dset-cm5axptyyxxx298",
  "data_source": {
    "id": "dsource-a1b2c3d4e5f6g7h8i9j0",
    "name": "sales_data_2024.csv",
    "type": "FILE",
    "status": "synched",
    "size": 2097152
  },
  "file": {
    "name": "sales_data_2024.csv",
    "size": 2097152,
    "object_key": "uploads/user_123/sales_data_2024.csv"
  }
}

Устранение неполадок

Если у вас возникли проблемы:

1. Убедитесь, что переменные окружения правильно установлены в .env
2. Проверьте, что сервер успешно запускается с помощью npm start
3. Убедитесь, что конфигурация Claude Desktop указывает на правильные пути к файлам
4. Проверьте вывод консоли на наличие сообщений об ошибках

Лицензия

MIT