Powerdrill MCP Server

Powerdrill MCP服务器

模型上下文协议（MCP）服务器，提供与Powerdrill数据集交互的工具，通过Powerdrill用户ID和项目API密钥进行验证。

请前往https://chat.powerdrill.ai/用于单独或与团队一起使用AI数据分析。

如果您拥有团队的Powerdrill用户ID和项目API密钥，您可以通过Powerdrill开源web客户端操作数据：

• Node.js版本: https://flow.powerdrill.ai/，或使用开源web客户端https://github.com/powerdrillai/powerdrill-flow.
• Python教育: https://powerdrill-flow.streamlit.app/，或使用开源web客户端https://github.com/powerdrillai/powerdrill-flow-streamlit.

特性

• 使用用户ID和项目API密钥通过Powerdrill进行身份验证
• 列出Powerdrill帐户中的可用数据集
• 获取特定数据集的详细信息
• 在包含自然语言问题的数据集上创建和运行作业
• 与Claude Desktop和其他MCP兼容客户端集成

安装

通过Smithery安装

通过以下方式自动安装powerdrill mcp for Claude Desktop 史密瑟里:

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服务器，您需要一个具有有效API凭据的Powerdrill帐户(用户ID 和 API密钥).以下是获取它们的方法：

1. 如果您还没有注册Powerdrill Team帐户，请注册
2. 导航到您的帐户设置
3. 查找API部分，您可以在其中找到：

- 用户ID：您帐户的唯一标识符 - API密钥：用于访问API的身份验证令牌

首先，观看此视频教程，了解如何创建Powerdrill团队：

然后，按照以下视频教程设置API凭据：

快速设置

设置服务器的最简单方法是使用提供的设置脚本：

# Make the script executable
chmod +x setup.sh

# Run the setup script
./setup.sh

这将：

1. 安装依赖项
2. 构建TypeScript代码
3. 创建一个 .env 如果文件不存在
4. 使用基于npx的配置为Claude Desktop和Cursor生成配置文件（推荐）

然后编辑您的 .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. 打开克劳德桌面
2. 转到“设置”>“服务器设置”
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：使用本地安装的节点

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

1. 保存配置
2. 重新启动克劳德桌面

与Cursor集成

1. 打开的游标
2. 前往“设置”>“MCP工具”
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：使用本地安装的节点

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

1. 保存配置
2. 如果需要，重新启动游标

使用工具

连接后，您可以在与Claude Desktop、Cursor、Cline、Windsurf等的对话中使用Powerdrill工具：

• 列出数据集： 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_getdataset_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”）：生成输出的语言。选项包括：“自动”、“EN”、“ES”、“AR”、“PT”、“ID”、“JA”、“RU”、“HI”、“FR”、“DE”、“VI”、“TR”、“PL”、“IT”、“KO”、“ZH-CN”、“ZH-TW”
• job_mode （可选，默认：“AUTO”）：会话的作业模式。选项包括：“自动”、“数据分析”
• max_contextual_job_history （可选，默认值：10）：保留作为下一个作业上下文的最近作业的最大数量（0-10）
• agent_id （可选，默认值：“DATA_ANALYSIS_AGENT”）：代理的ID

示例响应：

{
  "session_id": "session-abcdefghijklmnopqrstuvwxyz"
}

mcp_powerdrill_list_data_资源

列出特定数据集中的数据源。

参数：

• datasetId （必填）：用于列出数据源的数据集的ID
• pageNumber （可选，默认值：1）：开始列出的页码
• pageSize （可选，默认值：10）：单页上的项目数
• status （可选）：按状态筛选数据源：同步、无效、已同步（逗号分隔为多个）

示例响应：

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

故障排除

如果您遇到问题：

1. 确保在中正确设置了环境变量 .env
2. 检查服务器是否成功启动 npm start
3. 验证您的Claude Desktop配置指向正确的文件路径
4. 检查控制台输出是否有任何错误消息

许可证

麻省理工学院