Powerdrill

chính thức

Một máy chủ MCP cung cấp các công cụ để tương tác với các tập dữ liệu Powerdrill, cho phép phân tích dữ liệu AI thông minh và cung cấp thông tin chi tiết.

GitHub

Bạn có thể làm gì với Powerdrill MCP?

Liệt kê các tập dữ liệu Powerdrill của bạn — Yêu cầu trợ lý hiển thị các tập dữ liệu có sẵn bằng mcp_powerdrill_list_datasets.
Xem tổng quan tập dữ liệu — Truy xuất cấu trúc, tóm tắt và các câu hỏi khám phá được đề xuất bằng mcp_powerdrill_get_dataset_overview.
Phân tích dữ liệu bằng ngôn ngữ tự nhiên — Gửi một câu hỏi liên quan đến tập dữ liệu và nhận mã, bảng, biểu đồ và văn bản qua mcp_powerdrill_create_job.
Tải tệp cục bộ lên tập dữ liệu — Thêm tệp CSV, Excel hoặc PDF từ máy của bạn bằng mcp_powerdrill_create_data_source_from_local_file.
Tạo tập dữ liệu mới — Cung cấp một tập dữ liệu có tên trong tài khoản của bạn bằng mcp_powerdrill_create_dataset.
Quản lý phiên phân tích — Tạo phiên bằng mcp_powerdrill_create_session và liệt kê các phiên hiện có bằng mcp_powerdrill_list_sessions.

Tài liệu

Máy chủ Powerdrill MCP

Một máy chủ Model Context Protocol (MCP) cung cấp các công cụ để tương tác với bộ dữ liệu Powerdrill, được xác thực bằng ID Người dùng Powerdrill và Khóa API Dự án.

Vui lòng truy cập https://chat.powerdrill.ai/ để phân tích dữ liệu AI cá nhân hoặc sử dụng cùng Nhóm của bạn.

Nếu bạn có ID Người dùng Powerdrill và Khóa API Dự án của Nhóm, bạn có thể thao tác dữ liệu thông qua các ứng dụng web nguồn mở của Powerdrill:

Phiên bản Node.js: https://flow.powerdrill.ai/, hoặc dùng thử ứng dụng web nguồn mở https://github.com/powerdrillai/powerdrill-flow.
Phiên bản Python: https://powerdrill-flow.streamlit.app/, hoặc dùng thử ứng dụng web nguồn mở https://github.com/powerdrillai/powerdrill-flow-streamlit.

Tính năng

Xác thực với Powerdrill bằng ID Người dùng và Khóa API Dự án
Liệt kê các bộ dữ liệu có sẵn trong tài khoản Powerdrill của bạn
Nhận thông tin chi tiết về các bộ dữ liệu cụ thể
Tạo và chạy các công việc trên bộ dữ liệu với câu hỏi ngôn ngữ tự nhiên
Tích hợp với Claude Desktop và các ứng dụng khách tương thích MCP khác

Cài đặt

Cài đặt qua Smithery

Để tự động cài đặt powerdrill-mcp cho Claude Desktop qua Smithery:

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

Từ npm

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

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

Từ mã nguồn

Sao chép kho lưu trữ này và cài đặt các phụ thuộc:

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

Sử dụng CLI

Nếu đã cài đặt toàn cục:

# Start the MCP server
powerdrill-mcp

Nếu sử dụng npx:

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

Bạn sẽ cần cấu hình các biến môi trường với thông tin xác thực Powerdrill trước khi chạy:

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

Hoặc tạo một tệp .env với các giá trị này.

Điều kiện tiên quyết

Để sử dụng máy chủ MCP này, bạn sẽ cần một tài khoản Powerdrill với thông tin xác thực API hợp lệ (ID Người dùng và Khóa API). Dưới đây là cách lấy chúng:

Đăng ký tài khoản Nhóm Powerdrill nếu bạn chưa có
Điều hướng đến cài đặt tài khoản của bạn
Tìm phần API nơi bạn sẽ thấy:
- ID Người dùng: Mã định danh duy nhất cho tài khoản của bạn
- Khóa API: Mã thông báo xác thực của bạn để truy cập API

Trước tiên, hãy xem video hướng dẫn này về cách tạo Nhóm Powerdrill của bạn:

Sau đó, làm theo video hướng dẫn này để thiết lập thông tin xác thực API của bạn:

Thiết lập nhanh

Cách dễ nhất để thiết lập máy chủ là sử dụng tập lệnh thiết lập được cung cấp:

# Make the script executable
chmod +x setup.sh

# Run the setup script
./setup.sh

Thao tác này sẽ:

Cài đặt các phụ thuộc
Xây dựng mã TypeScript
Tạo tệp .env nếu nó chưa tồn tại
Tạo các tệp cấu hình cho Claude Desktop và Cursor với cấu hình dựa trên npx (được khuyến nghị)

Sau đó chỉnh sửa tệp .env của bạn với thông tin xác thực thực tế:

POWERDRILL_USER_ID=your_actual_user_id
POWERDRILL_PROJECT_API_KEY=your_actual_project_api_key

Cũng cập nhật thông tin xác thực trong các tệp cấu hình đã tạo trước khi sử dụng chúng.

Cài đặt thủ công

Nếu bạn muốn thiết lập thủ công:

# 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

Sử dụng

Chạy máy chủ

npm start

Tích hợp với Claude Desktop

Mở Claude Desktop
Đi tới Cài đặt > Cài đặt Máy chủ
Thêm một máy chủ mới với một trong các cấu hình sau:

Tùy chọn 1: Sử dụng npx (Khuyến nghị)

{
  "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"
    }
  }
}

Tùy chọn 2: Sử dụng node với cài đặt cục bộ

{
  "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"
    }
  }
}

Lưu cấu hình
Khởi động lại Claude Desktop

Tích hợp với Cursor

Mở Cursor
Đi tới Cài đặt > Công cụ MCP
Thêm một công cụ MCP mới với một trong các cấu hình sau:

Tùy chọn 1: Sử dụng npx (Khuyến nghị)

{
  "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"
    }
  }
}

Tùy chọn 2: Sử dụng node với cài đặt cục bộ

{
  "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"
    }
  }
}

Lưu cấu hình
Khởi động lại Cursor nếu cần

Sử dụng các công cụ

Sau khi kết nối, bạn có thể sử dụng các công cụ Powerdrill trong các cuộc trò chuyện của mình với Claude Desktop, Cursor, Cline, Windsurf, v.v.:

Liệt kê bộ dữ liệu: What datasets are available in my Powerdrill account? hoặc Show me all my datasets
Tạo bộ dữ liệu: Create a new dataset called "Sales Analytics" hoặc Make a new dataset named "Customer Data" with description "Customer information for 2024 analysis"
Tạo nguồn dữ liệu từ tệp cục bộ: Upload the file /Users/your_name/Downloads/sales_data.csv to dataset {dataset_id} hoặc Add my local file /path/to/customer_data.xlsx to my {dataset_id} dataset
Xem tổng quan bộ dữ liệu: Tell me more about this dataset: {dataset_id} hoặc Describe the structure of dataset {dataset_id}
Tạo một công việc: Analyze dataset {dataset_id} with this question: "How has the trend changed over time?" hoặc Run a query on {dataset_id} asking "What are the top 10 customers by revenue?"
Tạo một phiên: Create a new session named "Sales Analysis 2024" for my data analysis hoặc Start a session called "Customer Segmentation" for analyzing market data
Liệt kê nguồn dữ liệu: What data sources are available in dataset {dataset_id}? hoặc Show me all files in the {dataset_id} dataset
Liệt kê phiên: Show me all my current analysis sessions hoặc List my recent data analysis sessions

Công cụ có sẵn

mcp_powerdrill_list_datasets

Liệt kê các bộ dữ liệu có sẵn từ tài khoản Powerdrill của bạn.

Tham số:

limit (tùy chọn): Số lượng bộ dữ liệu tối đa để trả về

Ví dụ phản hồi:

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

mcp_powerdrill_get_dataset_overview

Nhận thông tin tổng quan chi tiết về một bộ dữ liệu cụ thể.

Tham số:

datasetId (bắt buộc): ID của bộ dữ liệu để nhận thông tin tổng quan

Ví dụ phản hồi:

{
  "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

Tạo một công việc để phân tích dữ liệu với các câu hỏi ngôn ngữ tự nhiên.

Tham số:

question (bắt buộc): Câu hỏi hoặc lời nhắc ngôn ngữ tự nhiên để phân tích dữ liệu
dataset_id (bắt buộc): ID của bộ dữ liệu để phân tích
datasource_ids (tùy chọn): Mảng các ID nguồn dữ liệu cụ thể trong bộ dữ liệu để phân tích
session_id (tùy chọn): ID phiên để nhóm các công việc liên quan
stream (tùy chọn, mặc định: false): Có truyền phát kết quả hay không
output_language (tùy chọn, mặc định: "AUTO"): Ngôn ngữ cho đầu ra
job_mode (tùy chọn, mặc định: "AUTO"): Chế độ công việc

Ví dụ phản hồi:

{
  "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

Tạo một phiên mới để nhóm các công việc liên quan lại với nhau.

Tham số:

name (bắt buộc): Tên phiên, có thể dài tối đa 128 ký tự
output_language (tùy chọn, mặc định: "AUTO"): Ngôn ngữ mà đầu ra được tạo. Các tùy chọn bao gồm: "AUTO", "EN", "ES", "AR", "PT", "ID", "JA", "RU", "HI", "FR", "DE", "VI", "TR", "PL", "IT", "KO", "ZH-CN", "ZH-TW"
job_mode (tùy chọn, mặc định: "AUTO"): Chế độ công việc cho phiên. Các tùy chọn bao gồm: "AUTO", "DATA_ANALYTICS"
max_contextual_job_history (tùy chọn, mặc định: 10): Số lượng công việc gần đây tối đa được giữ lại làm ngữ cảnh cho công việc tiếp theo (0-10)
agent_id (tùy chọn, mặc định: "DATA_ANALYSIS_AGENT"): ID của tác nhân

Ví dụ phản hồi:

{
  "session_id": "session-abcdefghijklmnopqrstuvwxyz"
}

mcp_powerdrill_list_data_sources

Liệt kê các nguồn dữ liệu trong một bộ dữ liệu cụ thể.

Tham số:

datasetId (bắt buộc): ID của bộ dữ liệu để liệt kê các nguồn dữ liệu từ đó
pageNumber (tùy chọn, mặc định: 1): Số trang để bắt đầu liệt kê
pageSize (tùy chọn, mặc định: 10): Số lượng mục trên một trang
status (tùy chọn): Lọc nguồn dữ liệu theo trạng thái: synching, invalid, synched (phân tách bằng dấu phẩy cho nhiều trạng thái)

Ví dụ phản hồi:

{
  "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

Liệt kê các phiên từ tài khoản Powerdrill của bạn.

Tham số:

pageNumber (tùy chọn): Số trang để bắt đầu liệt kê (mặc định: 1)
pageSize (tùy chọn): Số lượng mục trên một trang (mặc định: 10)
search (tùy chọn): Tìm kiếm phiên theo tên

Ví dụ phản hồi:

{
  "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

Tạo một bộ dữ liệu mới trong tài khoản Powerdrill của bạn.

Tham số:

name (bắt buộc): Tên bộ dữ liệu, có thể dài tối đa 128 ký tự
description (tùy chọn): Mô tả bộ dữ liệu, có thể dài tối đa 128 ký tự

Ví dụ phản hồi:

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

mcp_powerdrill_create_data_source_from_local_file

Tạo một nguồn dữ liệu mới bằng cách tải lên một tệp cục bộ vào một bộ dữ liệu được chỉ định.

Tham số:

dataset_id (bắt buộc): ID của bộ dữ liệu để tạo nguồn dữ liệu trong đó
file_path (bắt buộc): Đường dẫn cục bộ đến tệp để tải lên
file_name (tùy chọn): Tên tùy chỉnh cho tệp, mặc định là tên tệp gốc
chunk_size (tùy chọn, mặc định: 5MB): Kích thước của mỗi phần trong byte cho tải lên đa phần

Ví dụ phản hồi:

{
  "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"
  }
}

Khắc phục sự cố

Nếu bạn gặp sự cố:

Đảm bảo các biến môi trường của bạn được đặt chính xác trong .env
Kiểm tra xem máy chủ có khởi động thành công với npm start không
Xác minh cấu hình Claude Desktop của bạn trỏ đến đúng đường dẫn tệp
Kiểm tra đầu ra bảng điều khiển để tìm bất kỳ thông báo lỗi nào

Giấy phép

MIT