PQL MCP Server

An industrial-grade Model Context Protocol (MCP) server that provides high-performance Pipelined Query Language (PQL) to SQL compilation using WASM and Extism.

🚀 Features

• High Performance: Powered by a Go-based PQL compiler compiled to WASM.
• Zero Dependencies (Runtime): Self-contained WASM execution via Extism.
• Semantic Validation: Provides error messages for syntax and semantic PQL issues.
• MCP Native: Fully compliant with the latest MCP SDK for seamless integration with AI agents (Claude, etc.).

🛠️ Tools

compile_pql

Compiles a PQL query (similar to Kusto/KQL) into standard SQL.

Arguments:

• query (string, required): The PQL query to compile.

Example:

StormEvents 
| where DamageProperty > 5000 
| sort by DamageProperty desc 
| limit 10

📦 Installation

git clone https://github.com/Angelebeats/pql-mcp-server.git
cd pql-mcp-server
npm install
npm run build

⚙️ Configuration

Add the server to your MCP client (e.g., Claude Desktop) config:

{
  "mcpServers": {
    "pql-server": {
      "command": "node",
      "args": ["/path/to/pql-mcp-server/build/index.js"],
      "env": {}
    }
  }
}

🏗️ Architecture

The server consists of two parts:

1. Core Compiler: Written in Go, utilizing extism-go for WASM plugin support.
2. MCP Wrapper: A TypeScript/Node.js application using the @modelcontextprotocol/sdk to expose the compiler via stdio.

📄 License

MIT © Angelebeats