MCP 服务器

PromptQL MCP Server

用于 Hasura PromptQL 的模型上下文协议 (MCP) 服务器

hasura

开发者工具

访问服务器

README

PromptQL MCP 服务器

使用模型上下文协议 (MCP) 将 Hasura PromptQL 连接到 Claude 等 AI 助手。

概述

本项目提供了一个桥梁，连接 Hasura 的 PromptQL 数据代理和 AI 助手，通过模型上下文协议。通过此集成，AI 助手可以使用自然语言直接查询您的企业数据，从而利用 PromptQL 强大的数据访问、分析和可视化功能。

特性

🔍 自然语言数据查询 - 用简单的英语提问有关您的企业数据的问题
📊 表格工件支持 - 从您的数据查询中获取格式化的表格结果
🔐 安全配置 - 安全地存储和管理您的 PromptQL API 凭据
📈 数据分析 - 从您的数据中获取见解和可视化
🛠️ 简单集成 - 适用于 Claude Desktop 和其他 MCP 兼容的客户端

安装

前提条件

Python 3.10 或更高版本
具有 API 密钥和 DDN URL 的 Hasura PromptQL 项目
Claude Desktop（用于交互式使用）或任何 MCP 兼容的客户端

从源代码安装

git clone https://github.com/hasura/promptql-mcp-server.git
cd promptql-mcp-server
pip install -e .

快速开始

配置您的 PromptQL 凭据：

python -m promptql_mcp_server setup --api-key YOUR_API_KEY --ddn-url YOUR_DDN_URL

测试服务器：

python -m promptql_mcp_server

在新的终端中，尝试示例客户端：

python examples/simple_client.py

与 Claude Desktop 一起使用

安装 Claude Desktop
打开 Claude Desktop 并转到 Settings > Developer
点击 "Edit Config" 并添加以下内容：

{
  "mcpServers": {
    "promptql": {
      "command": "python",
      "args": ["-m", "promptql_mcp_server"]
    }
  }
}

重启 Claude Desktop
与 Claude 聊天并使用自然语言查询您的数据

Claude 的示例提示

"我们上个季度的总销售额是多少？"
"按收入计算，我们排名前五的客户是谁？"
"向我展示过去 6 个月新用户注册的趋势"
"哪些产品的利润率最高？"

可用工具和提示

工具

服务器公开以下 MCP 工具：

ask_question - 提出关于您的数据的自然语言问题
setup_config - 配置 PromptQL API 密钥和 DDN URL
check_config - 验证当前配置状态

提示

data_analysis - 为特定主题的数据分析创建专门的提示

架构

此集成遵循客户端-服务器架构：

PromptQL MCP 服务器 - 一个 Python 服务器，通过 MCP 协议公开 PromptQL 功能
MCP 客户端 - 任何实现 MCP 协议的客户端（例如，Claude Desktop）
PromptQL API - Hasura 的自然语言 API，用于数据访问和分析

服务器在 MCP 协议和 PromptQL 的 API 之间进行转换，从而实现 AI 助手和您的企业数据之间的无缝集成。

开发

项目结构

promptql-mcp-server/
├── promptql_mcp_server/     # 主包
│   ├── __init__.py
│   ├── __main__.py          # 入口点
│   ├── server.py            # MCP 服务器实现
│   ├── config.py            # 配置管理
│   └── api/                 # API 客户端
│       ├── __init__.py
│       └── promptql_client.py # PromptQL API 客户端
├── examples/                # 示例客户端
│   └── simple_client.py     # 简单的 MCP 客户端
├── setup.py                 # 包配置
└── README.md                # 文档