QIT MCP Server

An MCP (Model Context Protocol) server that wraps the QIT CLI, enabling natural language interaction and agent-based workflows for WordPress/WooCommerce plugin testing.

Features

• Natural Language Testing: Run QIT tests using conversational commands

• Agent Integration: Enable AI agents to run tests as part of automated workflows

• Full CLI Coverage: Access all essential QIT CLI functionality through MCP tools

• Smart CLI Detection: Automatically finds QIT CLI in PATH, local vendor, or custom location

Prerequisites

• Node.js 18+

• QIT CLI installed and accessible

Installation

git clone https://github.com/woocommerce/qit-mcp
cd qit-mcp
npm install
npm run build

Configuration

Claude Code

Add to your Claude Code MCP settings (~/.claude.json):

{
  "mcpServers": {
    "qit": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/qit-mcp/dist/index.js"],
      "env": {
        "QIT_CLI_PATH": "/path/to/qit-cli/qit"
      }
    }
  }
}

QIT CLI Detection

The MCP server automatically detects QIT CLI in this order:

1. QIT_CLI_PATH environment variable

2. qit in system PATH

3. ./vendor/bin/qit (local Composer installation)

Available Tools

Authentication (2 tools)

Test Execution (2 tools)

Test Results (4 tools)

Groups (1 tool)

Environment (5 tools)

Packages (2 tools)

Configuration (1 tool)

Utilities (5 tools)

Usage Examples

Natural Language (via Claude Code)

"Run security tests on my-plugin"
→ run_test(type="security", plugin="my-plugin")

"Start a test environment with PHP 8.2"
→ start_environment(php_version="8.2")

"Show me my recent failed tests"
→ list_tests(status="failed")

"What plugins can I test?"
→ list_extensions()

Programmatic Usage

The MCP server communicates via stdio using the Model Context Protocol. See the MCP documentation for integration details.

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Run tests
npm test

# Lint
npm run lint

License

MIT

Links

• QIT CLI

• QIT Documentation

• Model Context Protocol