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.3.tar.gz (312.3 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.3-py3-none-any.whl (250.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: qai_consultant_mcp-3.1.3.tar.gz
  • Upload date:
  • Size: 312.3 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.3.tar.gz
Algorithm Hash digest
SHA256 ee35bb4f6c8a07b273c615dabe7f72c35b678d3a3073a8c26daae2059556ba5a
MD5 180d9d3fe93f40afaa53635b6090a5ef
BLAKE2b-256 cdeecf9fe13d920c9a644bf9bbe11d81572bd1ce13c85d117feb6f69b1310e50

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for qai_consultant_mcp-3.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 1c7470a3bafe6d543f49a1b6dab604102e484e625ce3fd65f71ab202ac78b69e
MD5 620c182eb196d120cb092992258e0099
BLAKE2b-256 6999f31fe58125bd5d885447053e11b79e4aa5ebc6b880c113df635a7426093e

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