Integration · MODEL CONTEXT PROTOCOL
powerdrillai powerdrill mcp
The MCP server for Powerdrill API.
WHAT IT CONNECTS
powerdrillai powerdrill mcp 为 AI Agent 提供什么
- Authenticate with Powerdrill using User ID and Project API Key
- List available datasets in your Powerdrill account
- Get detailed information about specific datasets
- Create and run jobs on datasets with natural language questions
- Integration with Claude Desktop and other MCP-compatible clients
- Sign up for a Powerdrill Team account if you haven't already
- Navigate to your account settings
- Look for the API section where you'll find your:
- User ID: A unique identifier for your account
- API Key: Your authentication token for API access
- Install dependencies
- Build the TypeScript code
- Create a `.env` file if it doesn't exist
- Generate configuration files for Claude Desktop and Cursor with the npx-based configuration (recommended)
- Open Claude Desktop
- Go to Settings > Server Settings
- Add a new server with one of the following configurations:
- Save the configuration
- Restart Claude Desktop
- Open Cursor
- Go to Settings > MCP Tools
- Add a new MCP tool with one of the following configurations:
- Save the configuration
- Restart Cursor if needed
- List datasets: `What datasets are available in my Powerdrill account?` or `Show me all my datasets`
- Create dataset: `Create a new dataset called "Sales Analytics"` or `Make a new dataset named "Customer Data" with description "Customer information for 2024 analysis"`
- Create data source from local file: `Upload the file /Users/your_name/Downloads/sales_data.csv to dataset {dataset_id}` or `Add my local file /path/to/customer_data.xlsx to my {dataset_id} dataset`
- Get dataset overview: `Tell me more about this dataset: {dataset_id}` or `Describe the structure of dataset {dataset_id}`
- Create a job: `Analyze dataset {dataset_id} with this question: "How has the trend changed over time?"` or `Run a query on {dataset_id} asking "What are the top 10 customers by revenue?"`
- Create a session: `Create a new session named "Sales Analysis 2024" for my data analysis` or `Start a session called "Customer Segmentation" for analyzing market data`
- List data sources: `What data sources are available in dataset {dataset_id}?` or `Show me all files in the {dataset_id} dataset`
- List sessions: `Show me all my current analysis sessions` or `List my recent data analysis sessions`
- `limit` (optional): Maximum number of datasets to return
- `datasetId` (required): The ID of the dataset to get overview information for
- `question` (required): The natural language question or prompt to analyze the data
- `dataset_id` (required): The ID of the dataset to analyze
- `datasource_ids` (optional): Array of specific data source IDs within the dataset to analyze
- `session_id` (optional): Session ID to group related jobs
- `stream` (optional, default: false): Whether to stream the results
- `output_language` (optional, default: "AUTO"): The language for the output
- `job_mode` (optional, default: "AUTO"): The job mode
- `name` (required): The session name, which can be up to 128 characters in length
- `output_language` (optional, default: "AUTO"): The language in which the output is generated. Options include: "AUTO", "EN", "ES", "AR", "PT", "ID", "JA", "RU", "HI", "FR", "DE", "VI", "TR", "PL", "IT", "KO", "ZH-CN", "ZH-TW"
- `job_mode` (optional, default: "AUTO"): Job mode for the session. Options include: "AUTO", "DATA_ANALYTICS"
- `max_contextual_job_history` (optional, default: 10): The maximum number of recent jobs retained as context for the next job (0-10)
- `agent_id` (optional, default: "DATA_ANALYSIS_AGENT"): The ID of the agent
- `datasetId` (required): The ID of the dataset to list data sources from
- `pageNumber` (optional, default: 1): The page number to start listing
- `pageSize` (optional, default: 10): The number of items on a single page
- `status` (optional): Filter data sources by status: synching, invalid, synched (comma-separated for multiple)
- `pageNumber` (optional): The page number to start listing (default: 1)
- `pageSize` (optional): The number of items on a single page (default: 10)
- `search` (optional): Search for sessions by name
- `name` (required): The dataset name, which can be up to 128 characters in length
- `description` (optional): The dataset description, which can be up to 128 characters in length
- `dataset_id` (required): The ID of the dataset to create the data source in
- `file_path` (required): The local path to the file to upload
- `file_name` (optional): Custom name for the file, defaults to the original filename
- `chunk_size` (optional, default: 5MB): Size of each chunk in bytes for multipart upload
- Make sure your environment variables are set correctly in `.env`
- Check that the server starts successfully with `npm start`
- Verify your Claude Desktop configuration points to the correct file paths
- Check the console output for any error messages
SECURITY
MCP 收录不等于安全审核
MCP 服务器可能获得模型上下文、凭据、本地文件或调用外部系统的权限。连接 Agent 前,请检查代码、环境变量、网络行为、软件包来源与维护状态。