Whatap MXQL

WhaTap MXQL CLI and MCP Server - Query and manage WhaTap monitoring data with MXQL queries. Includes Claude Code integration via MCP.

typescript

2

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "devload-whatap-mxql-cli": {
      "command": "node",
      "args": [
        "/절대/경로/whatap-mxql-cli/dist/mcp/index.js"
      ]
    }
  }
}

You can run and manage the WhaTap MXQL CLI as an MCP server to execute MXQL queries against WhaTap data sources, from a centralized control plane. This MCP integration lets you start the query executor locally, connect it to your MCP client, and run powerful MXQL pipelines with secure session handling and multiple output formats.

How to use

You deploy the MXQL query executor as a local MCP server and connect to it from your MCP-aware client. Use the standard MCP workflow to start the server, then send MXQL queries through the client. You can browse projects, run MXQL queries, and use an interactive REPL for ad hoc exploration. The executor handles authentication sessions securely and supports multiple output formats (Table, JSON, CSV). When you start the MCP server, you can rely on the built-in session storage that uses AES-256-GCM to protect credentials.

How to install

# Prerequisites
# - Node.js (LTS) and npm installed on your system
node -v
npm -v

# Clone the project repository
# Replace <repository-url> with the actual URL
git clone <repository-url>
cd whatap-mxql-cli

# Install dependencies
npm install

# Build the project
npm run build

# Allow execution of the binary (if you will run the CLI directly)
chmod +x bin/whatap-mxql

Configuration and security

Security is built into the MXQL MCP integration. Session data is encrypted with AES-256-GCM and stored locally with restricted permissions to prevent unauthorized access.

The MCP configuration for the MXQL CLI is provided below. It defines a local stdio-based MCP server that launches the query executor from the built distribution.

Examples

{
  "mcpServers": {
    "whatap-mxql": {
      "command": "node",
      "args": ["/절대/경로/whatap-mxql-cli/dist/mcp/index.js"],
      "description": "WhaTap MXQL Query Executor"
    }
  }
}

Available tools

whatap.getProjects

Fetches the list of projects accessible to your account, enabling you to filter and select targets for MXQL queries.

whatap.executeMxql

Executes a given MXQL query against a selected project code, returning results in the requested format.