状态: 不稳定, 仅用于 PowerQL v1. Alpha 释放即将到来 PowerQL v2.

□ 概览

这个项目通过"模型背景协议"为哈苏拉的"快速QL"数据代理和AI助手提供了桥梁. 通过这种整合,AI助手可以直接使用自然语言查询您的企业数据,利用PowerQL强大的数据访问,分析和可视化能力.

□ 特性

• ** 自然语言数据查询** - 用简单英语询问有关企业数据的问题
• ** 表 人工支持 - 从数据查询中获取格式化的表格结果 安全存储和管理您的快速QL API 证书
• ** 双重认证模式** – – 支持公共和私人DDN部署
• 数据分析** - 从你的数据中获得真知灼见和可视化
• *简单集成-与克洛德桌面和其他MCP兼容客户端合作

□ 认证模式

PournalQL MCP服务器支持两种认证模式,以配合不同的DDN部署类型:

QQ 公共模式( 默认)

• 认证使用 Auth-Token 页眉
• 与公共DDN终点兼容

PromptQL MCP Server

Status: Unstable and only for PromptQL v1. Alpha release coming soon for PromptQL v2.

Overview

This project provides a bridge between Hasura’s PromptQL data agent and AI assistants through the Model Context Protocol. With this integration, AI assistants can directly query your enterprise data using natural language, leveraging PromptQL’s powerful capabilities for data access, analysis, and visualization.

Features

• 🔍 Natural Language Data Queries - Ask questions about your enterprise data in plain English
• 📊 Table Artifact Support - Get formatted table results from your data queries
• 🔐 Secure Configuration - Safely store and manage your PromptQL API credentials
• 🔑 Dual Authentication Modes - Support for both public and private DDN deployments
• 📈 Data Analysis - Get insights and visualizations from your data
• 🛠️ Simple Integration - Works with Claude Desktop and other MCP-compatible clients

Authentication Modes

The PromptQL MCP server supports two authentication modes to work with different DDN deployment types:

Public Mode (Default)

• Uses Auth-Token header for authentication
• Compatible with public DDN endpoints
• Backward compatible with existing configurations
• Use when: Your DDN deployment is publicly accessible

Private Mode

• Uses x-hasura-ddn-token header for authentication
• Compatible with private DDN endpoints
• Enhanced security for private deployments
• Use when: Your DDN deployment is private/internal

You can specify the authentication mode during configuration using the --auth-mode flag or auth_mode parameter.

Installation

Prerequisites

• Python 3.10 or higher
• A Hasura PromptQL project with API key, playground URL, and DDN Auth Token
• Claude Desktop (for interactive use) or any MCP-compatible client

Install from Source

1. Clone the repository:

git clone https://github.com/hasura/promptql-mcp.git
cd promptql-mcp

2. Set up a virtual environment (recommended):

# Create a virtual environment
python -m venv venv

# Activate the virtual environment
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install the package:

pip install -e .

Quick Start

1. Configure your PromptQL credentials:

# For public DDN deployments (default)
python -m promptql_mcp_server setup --api-key YOUR_PROMPTQL_API_KEY --playground-url YOUR_PLAYGROUND_URL --auth-token YOUR_AUTH_TOKEN --auth-mode public

# For private DDN deployments
python -m promptql_mcp_server setup --api-key YOUR_PROMPTQL_API_KEY --playground-url YOUR_PLAYGROUND_URL --auth-token YOUR_AUTH_TOKEN --auth-mode private

Alternative: Environment Variables

export PROMPTQL_API_KEY="your-api-key"
export PROMPTQL_PLAYGROUND_URL="your-playground-url"
export PROMPTQL_AUTH_TOKEN="your-auth-token"
export PROMPTQL_AUTH_MODE="public"  # or "private"

2. Test the server: