项目简介

Powerdrill MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它允许你通过 MCP 客户端（如 Claude Desktop, Cursor 等）连接到 Powerdrill 数据分析平台，并使用工具来管理和分析你的 Powerdrill 数据集。

主要功能点

Powerdrill 身份验证: 使用 Powerdrill 用户 ID 和项目 API 密钥进行身份验证，安全访问你的 Powerdrill 账户。
数据集管理:
- 列出 Powerdrill 账户中的可用数据集。
- 获取数据集的详细信息，包括描述、摘要、探索性问题和关键词。
- 创建新的数据集。
数据分析任务:
- 在数据集上创建和运行数据分析任务，使用自然语言提问。
- 创建会话来组织和关联分析任务。
数据源管理:
- 列出数据集中的数据源（如文件）。
- 从本地文件上传数据源到数据集。
会话管理:
- 列出和管理数据分析会话。

安装步骤

方法一：通过 npm 安装 (推荐全局安装)

确保你已安装 Node.js 和 npm。

打开终端，运行以下命令全局安装 'powerdrill-mcp'：

npm install -g @powerdrillai/powerdrill-mcp

方法二：从源代码安装

克隆 GitHub 仓库到本地：

git clone https://github.com/powerdrillai/powerdrill-mcp.git
cd powerdrill-mcp

安装项目依赖：
```
npm install
```
构建项目 (如果需要)：
```
npm run build
```

服务器配置

要将 Powerdrill MCP Server 连接到 MCP 客户端，你需要在客户端中配置服务器连接信息。以下是使用 'npx' 启动服务器的配置示例 (推荐)：

{
  "powerdrill": {
    "command": "npx",
    "args": [
      "-y",
      "@powerdrillai/powerdrill-mcp@latest"
    ],
    "env": {
      "POWERDRILL_USER_ID": "YOUR_POWERDRILL_USER_ID",  // 替换为你的 Powerdrill 用户 ID
      "POWERDRILL_PROJECT_API_KEY": "YOUR_POWERDRILL_PROJECT_API_KEY" // 替换为你的 Powerdrill 项目 API 密钥
    }
  }
}

配置参数说明:

'server name': 'powerdrill' (可以自定义，用于在客户端中标识该服务器连接)
'command': 'npx' (指定启动服务器的命令为 'npx')
'args': 启动命令的参数，这里指定为 '["-y", "@powerdrillai/powerdrill-mcp@latest"]'，表示使用 'npx' 运行最新版本的 '@powerdrillai/powerdrill-mcp' 包。 '-y' 参数表示自动确认安装包。
'env': 环境变量配置。
- 'POWERDRILL_USER_ID': 你的 Powerdrill 用户 ID，请替换为你的实际 User ID。
- 'POWERDRILL_PROJECT_API_KEY': 你的 Powerdrill 项目 API 密钥，请替换为你的实际 API Key。

重要提示:

你需要在 Powerdrill 平台获取 User ID 和 Project API Key。请参考仓库 README 中的视频教程获取凭据。
将上述 JSON 配置添加到你的 MCP 客户端的服务器配置中 (例如 Claude Desktop 的 Server Settings 或 Cursor 的 MCP Tools)。

基本使用方法

启动服务器:
- 如果是全局 npm 安装，在终端中运行 'powerdrill-mcp' 命令。
- 如果是源代码安装，在项目目录下运行 'npm start' 命令。
- 确保在运行服务器之前，已配置好环境变量 'POWERDRILL_USER_ID' 和 'POWERDRILL_PROJECT_API_KEY'，或者在 '.env' 文件中设置。
连接客户端:
- 在 MCP 客户端 (如 Claude Desktop, Cursor) 中，根据上述服务器配置添加 Powerdrill MCP Server 连接。
使用工具:
- 连接成功后，你可以在 MCP 客户端中使用自然语言调用 Powerdrill 提供的工具，例如：
  - 列出数据集: 'What datasets are available in my Powerdrill account?'
  - 获取数据集概览: 'Tell me more about this dataset: {dataset_id}'
  - 创建分析任务: 'Analyze dataset {dataset_id} with this question: "..."'
  - ... 更多工具和用法请参考仓库 README 文档。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息