Skip to main content

Local, keyless MCP server: standards-grounded QA knowledge retrieval (ISTQB, OWASP, IEEE, ISO, EU AI Act), deterministic QA effort estimation, QA document quality review, and test-results health analysis.

Project description

QAI Consultant

qai-consultant-mcp

A local, fully keyless MCP server: standards-grounded QA knowledge retrieval (ISTQB, OWASP, IEEE, ISO, EU AI Act), deterministic QA effort estimation, QA document quality review, and test-results health analysis — callable directly from Claude Code, Claude Desktop, or claude.ai.

No API keys, no Pinecone, no cloud LLM calls. It runs a local embedding index over a self-authored QA knowledge base and does the estimation math itself; the client LLM writes the narrative, this server just supplies grounding and numbers.

This package is the MCP companion to QAI Consultant, an AI QA Architect web app / CLI. If you're looking for the full app (Test Strategy / Risk Register / Effort Report generation with a browser UI), see the main project instead — this package is just the MCP server piece of it.

Install

uvx qai-consultant-mcp

Claude Code:

claude mcp add qai-consultant -- uvx qai-consultant-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "qai-consultant": {
      "command": "uvx",
      "args": ["qai-consultant-mcp"]
    }
  }
}

First run downloads the embedding model (sentence-transformers/all-MiniLM-L6-v2, CPU-only) and builds a local index — this takes a minute or two the first time, then it's cached.

Tools

Tool What it does
retrieve_qa_knowledge Grounding chunks from the knowledge base (ISTQB, OWASP, IEEE, ISO standards; testing methodologies; audit/evaluation frameworks; the EU AI Act), filterable by category
list_kb_sources Every document in the knowledge base, grouped by category
estimate_qa_effort Deterministic PERT-based effort estimate (baseline + complexity multipliers + team capacity + confidence score) — no LLM narrative, you write your own from the numbers
review_qa_document Deterministic 0–100 quality score for an existing Test Plan/Strategy/test case list across six ISTQB/IEEE-829-grounded dimensions, with findings and resolved KB citations — no LLM scoring, you write the narrative from the findings
analyze_test_results Deterministic health metrics from JUnit XML or CSV test execution data — flaky tests, ever-failing tests, slowest tests, and failure clustering — no LLM anywhere in this tool

Prompts

  • qa_project_interview — the project-intake interview (11 questions covering scope, tech stack, team, timeline, risks, compliance)
  • risk_register_structure — Risk Register document structure + grounding instructions
  • test_strategy_structure — Test Strategy document structure + grounding instructions
  • test_plan_structure — IEEE 829-aligned Test Plan structure + grounding instructions

Each *_structure prompt instructs the client to ground its generation in retrieve_qa_knowledge results with [Source N] citations, and to label the output as AI-generated.

Privacy

Usage telemetry is off by default. Set QAI_TELEMETRY=1 to opt in. Even then, only the tool name, a success flag, duration, retrieval k/category, package/Python version, OS family, and a random anonymous install ID are sent — never your query text, project details, or knowledge-base content.

Source

github.com/gvasile29/qai-consultant — Apache 2.0 licensed.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qai_consultant_mcp-3.1.4.tar.gz (312.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

qai_consultant_mcp-3.1.4-py3-none-any.whl (251.0 kB view details)

Uploaded Python 3

File details

Details for the file qai_consultant_mcp-3.1.4.tar.gz.

File metadata

  • Download URL: qai_consultant_mcp-3.1.4.tar.gz
  • Upload date:
  • Size: 312.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.3

File hashes

Hashes for qai_consultant_mcp-3.1.4.tar.gz
Algorithm Hash digest
SHA256 60c1f70b17959330dbe2f07b7daec8f406f0879738df50bf7174e12aadde1abb
MD5 651eff4905251af86537f2145c5dba29
BLAKE2b-256 057f2858abf393bf58b1cc6e918ff4e43071aba56f67887e6de4be74984be2a7

See more details on using hashes here.

File details

Details for the file qai_consultant_mcp-3.1.4-py3-none-any.whl.

File metadata

File hashes

Hashes for qai_consultant_mcp-3.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 228d95dedc40bbb845085bf9866b59cdb858c7434ab813a14d8d672dc46f4fc1
MD5 b527bfb21de412f74c1f9f5503c88dce
BLAKE2b-256 90e48cc2f95f9c9e502feb245d54268e8e3a6c098407cc700e24ef99e99079a0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page