Mallikarjun-Roddannavar/ai-testcase-generator-mcp

🤖 AI Testcase Generator MCP

An Model Context Protocol(MCP) server that generates comprehensive API test plans (positive, negative, and boundary/edge cases) directly from endpoint metadata—powered by LLMs.

This is a TypeScript-based Model Context Protocol(MCP) server for QA engineers. It demonstrates core Model Context Protocol concepts by providing:

• AI-powered tool for generating exhaustive test case plans from API endpoints and payloads
• Prompt-driven LLM integration for quality and coverage
• Extensible structure for future automation tooling

✨ Features

• 🔌 MCP-compliant server (stdio transport).
• 📝 Tool: generate_tests_excel
  • Input: endpoint, HTTP method, payload, extra context.
  • Input options:
    • Direct endpoint details: endpoint, HTTP method, payload
    • Use extraContext to provide any additional testing notes or constraints
  • OutputPut: 📊 Excel test plan with columns: Sl no, Test Name, Pre-Condition, Steps, Expected Result.
• 🧠 Prompt-driven test generation with configurable LLM (Groq, OpenAI, Anthropic).
• 📜 Detailed logging with Winston.

🏗️ Architecture

flowchart TD
    A[Claude / MCP Client] -->|Run Tool| B[MCP Server]
    B -->|Prompt| C[LLM API]
    C -->|Test Cases JSON| B
    B -->|Excel Export| D[(Test Plan .xlsx)]
    B -->|Logs| E[Server Log File]

📂 Project Structure

<details>

ai-testcase-designer-mcp/
├── build/                         # Compiled JavaScript output
├── assets/                        # Demo gifs, images, and sample files
│    ├── demo.gif
│    ├── excel_preview.png
│    └── sample_chat_message.txt
├── configs/
│    └── config.json               # Server/tool config
├── src/
│    ├── index.ts                  # Main server entry point (MCP interface & routing)
│    ├── excel.ts                  # Excel file creation & writing logic (modular)
│    ├── logger.ts                 # Winston logger configuration & l