PromptQL MCP Server

PromptQL MCP Server

site icon
2025.04.08 5
Python自然语言查询数据分析AI 助手集成开发效率数据库
PromptQL MCP Server 是一个连接 Hasura PromptQL 和 AI 助手(如 Claude)的桥梁,通过 Model Context Protocol (MCP) 实现。该服务允许 AI 助手通过自然语言直接查询企业数据,利用 PromptQL 的强大功能进行数据访问、分析和可视化。
View on GitHub

Overview

基本能力

产品定位

PromptQL MCP Server 是一个连接 Hasura PromptQL 和 AI 助手的桥梁,通过 Model Context Protocol (MCP) 实现自然语言数据查询和分析。

核心功能

  • 🔍 自然语言数据查询 - 使用普通英语查询企业数据
  • 📊 表格支持 - 获取格式化表格结果
  • 🔐 安全配置 - 安全存储和管理 PromptQL API 凭证
  • 📈 数据分析 - 从数据中获取洞察和可视化
  • 🛠️ 简单集成 - 与 Claude Desktop 和其他 MCP 兼容客户端配合使用

适用场景

  • 企业数据分析
  • 自然语言查询数据库
  • AI 助手集成企业数据

工具列表

  • ask_question - 使用自然语言查询数据
  • setup_config - 配置 PromptQL API 密钥和 DDN URL
  • check_config - 验证当前配置状态

常见问题解答

  • 如何配置 PromptQL 凭证?
  • 如何测试服务器?
  • 如何与 Claude Desktop 集成?

使用教程

使用依赖

  • Python 3.10 或更高版本
  • Hasura PromptQL 项目(包含 API 密钥和 DDN URL)
  • Claude Desktop 或其他 MCP 兼容客户端

安装教程

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

调试方式

  1. 配置 PromptQL 凭证:
python -m promptql_mcp_server setup --api-key YOUR_API_KEY --ddn-url YOUR_DDN_URL
  1. 测试服务器:
python -m promptql_mcp_server
  1. 使用示例客户端:
python examples/simple_client.py

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。