Powerdrill MCP服务器
](https://smithery.ai/server/@powerdrillai/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 installCLI使用情况
如果全局安装：
# 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密钥).以下是获取它们的方法：
- 如果您还没有注册Powerdrill Team帐户，请注册
- 导航到您的帐户设置
- 查找API部分，您可以在其中找到：
- 用户ID：您帐户的唯一标识符 - API密钥：用于访问API的身份验证令牌
首先，观看此视频教程，了解如何创建Powerdrill团队：
然后，按照以下视频教程设置API凭据：
快速设置
设置服务器的最简单方法是使用提供的设置脚本：
# Make the script executable
chmod +x setup.sh
# Run the setup script
./setup.sh这将：
- 安装依赖项
- 构建TypeScript代码
- 创建一个
.env如果文件不存在 - 使用基于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：使用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"
}
}
}- 保存配置
- 重新启动克劳德桌面
与Cursor集成
- 打开的游标
- 前往“设置”>“MCP工具”
- 添加具有以下配置之一的新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"
}
}
}- 保存配置
- 如果需要，重新启动游标
使用工具
连接后，您可以在与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（必填）：要分析的数据集的IDdatasource_ids（可选）：要分析的数据集中的特定数据源ID数组session_id（可选）：组相关作业的会话IDstream（可选，默认值：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（必填）：用于列出数据源的数据集的IDpageNumber（可选，默认值：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（必填）：在中创建数据源的数据集的IDfile_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配置指向正确的文件路径
- 检查控制台输出是否有任何错误消息
许可证
麻省理工学院