Pictmcp

🚀 PictMCP

PictMCP is an MCP server tailored for software developers who design test cases with AI assistants. It offers reliable and algorithm - correct pairwise test generation.

🚀 Quick Start

After installation, you can prompt your AI assistant to generate test cases using pairwise combinatorial testing.

Example Prompt

Generate test cases for a login form with the following parameters:

• Browser: Chrome, Firefox, Safari
• OS: Windows, macOS, Linux
• Language: English, Japanese, Spanish

The AI assistant will utilize the generate - test - cases tool to create an optimized set of test cases that cover all pairwise combinations.

Example Result

AI assistants usually format the results as a table:

#	Browser	OS	Language
1	Chrome	Linux	Japanese
2	Chrome	macOS	Spanish
3	Safari	Linux	Spanish
4	Firefox	Linux	English
5	Safari	Windows	English
6	Firefox	Windows	Spanish
7	Firefox	macOS	Japanese
8	Safari	macOS	Japanese
9	Chrome	macOS	English
10	Chrome	Windows	Japanese

Example with Constraints

Generate test cases for:

• Browser: Chrome, Firefox, Safari
• OS: Windows, macOS, Linux
• Language: English, Japanese, Spanish

With constraint: Safari only works on macOS

You can describe constraints in plain language, and the AI assistant will automatically convert them into PICT constraint syntax.

#	Browser	OS	Language
1	Firefox	Linux	Spanish
2	Chrome	Windows	Spanish
3	Firefox	Windows	Japanese
4	Chrome	Linux	Japanese
5	Chrome	macOS	English
6	Firefox	Windows	English
7	Chrome	Linux	English
8	Safari	macOS	Spanish
9	Safari	macOS	Japanese
10	Firefox	macOS	Spanish
11	Safari	macOS	English

✨ Features

• 🔒 Local Processing - All processing occurs locally without any external network calls.
• ⚡ WebAssembly Powered - Achieves fast execution by using Microsoft's PICT algorithm compiled to WebAssembly.
• 🔗 Constraint Support - Allows you to define constraints to filter out invalid parameter combinations.
• 📊 Structured Output - Returns well - structured JSON results for easy integration.

📦 Installation

Prerequisites

• Node.js (v22 or higher)

MCP Client Configuration

Add the following configuration to your MCP client. This is an example configuration; the exact format may vary depending on your client. Please refer to your MCP client's documentation for details.

{
  "mcpServers": {
    "PictMCP": {
      "command": "npx",
      "args": ["-y", "pictmcp"]
    }
  }
}

📚 Documentation

Does this communicate with external servers?

No. All processing runs locally with no external network calls.

I already use the pict CLI. Do I need this?

If your AI agent can execute CLI commands directly, you may not need this tool. However, PictMCP provides:

• A standardized MCP interface for AI assistants.
• No need to install PICT separately (WebAssembly - based).
• Structured JSON output instead of TSV.

What is pairwise testing?

Pairwise testing (also known as all - pairs testing) is a combinatorial testing method that generates test cases covering all possible pairs of input parameters. This significantly reduces the number of test cases while maintaining high defect detection rates.

What constraint syntax is supported?

You don't need to write PICT syntax directly. Simply describe constraints in natural language, and your AI assistant will handle the conversion. PictMCP supports the full PICT constraint syntax. See the PICT documentation for details.

📄 License

This project is licensed under the MIT License—see the LICENSE file for details.

Disclaimer

PictMCP is provided "as is", without warranty of any kind. The authors are not liable for any damages arising from its use.

Generated test cases do not guarantee complete coverage or the absence of defects. Please supplement pairwise testing with other strategies as appropriate.

PictMCP is an independent project and is not affiliated with Microsoft Corporation.

If you find PictMCP useful, please consider starring the repository.