Powerdrill

ทางการ

เซิร์ฟเวอร์ MCP ที่มีเครื่องมือสำหรับโต้ตอบกับชุดข้อมูล Powerdrill ช่วยให้การวิเคราะห์ข้อมูลและข้อมูลเชิงลึกด้วย AI อัจฉริยะ

GitHub

คุณทำอะไรได้บ้างด้วย Powerdrill MCP?

แสดงรายการชุดข้อมูล Powerdrill ของคุณ — ขอให้ผู้ช่วยแสดงชุดข้อมูลที่มีอยู่โดยใช้ mcp_powerdrill_list_datasets
รับภาพรวมของชุดข้อมูล — ดึงโครงสร้าง สรุป และคำถามแนะนำสำหรับการสำรวจด้วย mcp_powerdrill_get_dataset_overview
วิเคราะห์ข้อมูลด้วยภาษาธรรมชาติ — ส่งคำถามไปยังชุดข้อมูลและรับโค้ด ตาราง แผนภูมิ และข้อความผ่าน mcp_powerdrill_create_job
อัปโหลดไฟล์ในเครื่องไปยังชุดข้อมูล — เพิ่มไฟล์ CSV, Excel หรือ PDF จากเครื่องของคุณโดยใช้ mcp_powerdrill_create_data_source_from_local_file
สร้างชุดข้อมูลใหม่ — จัดเตรียมชุดข้อมูลที่มีชื่อในบัญชีของคุณด้วย mcp_powerdrill_create_dataset
จัดการเซสชันการวิเคราะห์ — สร้างเซสชันด้วย mcp_powerdrill_create_session และแสดงรายการเซสชันที่มีอยู่ด้วย mcp_powerdrill_list_sessions

เอกสาร

Powerdrill MCP Server

เซิร์ฟเวอร์ Model Context Protocol (MCP) ที่ให้เครื่องมือสำหรับโต้ตอบกับชุดข้อมูล Powerdrill โดยรับรองความถูกต้องด้วย Powerdrill User ID และ Project API Key

โปรดไปที่ https://chat.powerdrill.ai/ สำหรับการวิเคราะห์ข้อมูลด้วย AI แบบรายบุคคล หรือใช้ร่วมกับทีมของคุณ

หากคุณมี Powerdrill User ID และ Project API Key ของทีม คุณสามารถจัดการข้อมูลผ่านเว็บไคลเอนต์โอเพนซอร์สของ 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 โดยใช้ User ID และ Project API Key
แสดงรายการชุดข้อมูลที่มีอยู่ในบัญชี 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

การใช้งาน CLI

หากติดตั้งแบบโกลบอล:

# 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 ที่ถูกต้อง (User ID และ API Key) วิธีการขอรับมีดังนี้:

ลงทะเบียนบัญชี Powerdrill Team หากคุณยังไม่มี
ไปที่การตั้งค่าบัญชีของคุณ
มองหาส่วน API ซึ่งคุณจะพบ:
- User ID: ตัวระบุเฉพาะสำหรับบัญชีของคุณ
- API Key: โทเค็นการรับรองความถูกต้องสำหรับการเข้าถึง API

ขั้นแรก ดูวิดีโอสอนเกี่ยวกับวิธีสร้าง Powerdrill Team ของคุณ:

จากนั้น ทำตามวิดีโอสอนสำหรับการตั้งค่าข้อมูลประจำตัว API ของคุณ:

การตั้งค่าอย่างรวดเร็ว

วิธีที่ง่ายที่สุดในการตั้งค่าเซิร์ฟเวอร์คือการใช้สคริปต์การตั้งค่าที่ให้มา:

# Make the script executable
chmod +x setup.sh

# Run the setup script
./setup.sh

สิ่งนี้จะ:

ติดตั้งส่วนประกอบที่จำเป็น
สร้างโค้ด TypeScript
สร้างไฟล์ .env หากยังไม่มี
สร้างไฟล์การกำหนดค่าสำหรับ 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

เปิด Claude Desktop
ไปที่ Settings > Server Settings
เพิ่มเซิร์ฟเวอร์ใหม่ด้วยการกำหนดค่าอย่างใดอย่างหนึ่งต่อไปนี้:

ตัวเลือก 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"
    }
  }
}

บันทึกการกำหนดค่า
รีสตาร์ท Claude Desktop

การผสานรวมกับ Cursor

เปิด Cursor
ไปที่ Settings > MCP Tools
เพิ่มเครื่องมือ 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"
    }
  }
}

บันทึกการกำหนดค่า
รีสตาร์ท 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 ของชุดข้อมูลที่จะรับข้อมูลภาพรวม

ตัวอย่างการตอบกลับ:

{
  "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 (จำเป็น): ID ของชุดข้อมูลที่จะวิเคราะห์
datasource_ids (ไม่บังคับ): อาร์เรย์ของ ID แหล่งข้อมูลเฉพาะภายในชุดข้อมูลที่จะวิเคราะห์
session_id (ไม่บังคับ): 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"): ID ของเอเจนต์

ตัวอย่างการตอบกลับ:

{
  "session_id": "session-abcdefghijklmnopqrstuvwxyz"
}

mcp_powerdrill_list_data_sources

แสดงรายการแหล่งข้อมูลในชุดข้อมูลที่ระบุ

พารามิเตอร์:

datasetId (จำเป็น): ID ของชุดข้อมูลที่จะแสดงรายการแหล่งข้อมูล
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 (จำเป็น): ID ของชุดข้อมูลที่จะสร้างแหล่งข้อมูล
file_path (จำเป็น): พาธในเครื่องไปยังไฟล์ที่จะอัปโหลด
file_name (ไม่บังคับ): ชื่อที่กำหนดเองสำหรับไฟล์ ค่าเริ่มต้นคือชื่อไฟล์ต้นฉบับ
chunk_size (ไม่บังคับ, ค่าเริ่มต้น: 5MB): ขนาดของแต่ละส่วนในหน่วยไบต์สำหรับการอัปโหลดแบบหลายส่วน

ตัวอย่างการตอบกลับ:

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

การแก้ไขปัญหา

หากคุณพบปัญหา:

ตรวจสอบให้แน่ใจว่าตัวแปรสภาพแวดล้อมของคุณตั้งค่าอย่างถูกต้องใน .env
ตรวจสอบว่าเซิร์ฟเวอร์เริ่มทำงานสำเร็จด้วย npm start
ตรวจสอบว่าการกำหนดค่า Claude Desktop ของคุณชี้ไปยังพาธไฟล์ที่ถูกต้อง
ตรวจสอบเอาต์พุตคอนโซลเพื่อหาข้อความแสดงข้อผิดพลาด

ใบอนุญาต

MIT