Universal Test Framework MCP server
io.github.phoenice-labs/universal-test-framework·v1.0.2Polyglot MCP test generation with 8-section contract enforcement across Python, TS, Java, Go, C++.
0 stars18 downloads/wk
Reviews
Write oneNobody has reviewed Universal Test Framework yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Universal Test Framework tools (14, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
analyze_coverageAnalyze the coverage of a test suite and identify gaps.
build_traceability_matrixBuild a requirements-to-tests traceability matrix.
detect_language_frameworkDetect programming language and test framework from source code.
feedback_statusGet UTF feedback loop status: gap analysis, coverage health, trend, and delta requirements.
generate_reportGenerate the 8-section contract compliance report (Tool #12).
generate_testsGenerate a complete test suite satisfying the 8-section test contract.
healthHealth check for the Universal Test Framework MCP server.
import_test_resultsImport JUnit XML execution results into the UTF registry.
query_registryQuery the UTF persistent test registry.
register_contractsParse test files and register per-method 8-section contract records.
run_mutation_testswrite actionRun mutation testing on a source+test file pair and return coverage metrics.
run_testswrite actionExecute test files and return structured results with CI annotations.
suggest_test_typesAnalyze code/requirements and suggest which test types to apply.
validate_test_contractValidate a test or test suite against the 8-section contract.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan52 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 166 days ago8/15
- Maintainer identityregistry namespace matches repository owner6/10
How Universal Test Framework compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 57% of 48,255 servers
- Tools
- 14
- the typical server has 7
- Tools that change things
- 14%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 18
- more than 5% of 12,191 servers with a package
What its tools let an agent do: 8 read · 4 create · 2 run or deploy
Install Universal Test Framework in Claude Code, Cursor or VS Code
claude mcp add universal-test-framework -- uvx universal-test-framework
What the publisher says
From the Universal Test Framework repository's README, as published. We do not edit it. Read it on GitHub
Universal Test Framework (UTF)
Contract-driven test enforcement and reporting for LLM-generated code — via MCP, VS Code, Copilot CLI, Claude, Cursor, or Python SDK.
UTF is an MCP server and contract enforcement engine. It does not replace your AI coding assistant — it gives every test your AI writes a mandatory quality gate, a structured audit trail, and a comprehensive compliance report.
<!-- mcp-name: io.github.phoenice-labs/universal-test-framework -->
Why UTF? (Not Another Test Generator)
AI tools — GitHub Copilot, Claude, Cursor, Gemini — generate tests fast. The problem: fast ≠ trustworthy.
UTF vs Markdown Instructions / Prompt Files
You may already use markdown files (AGENTS.md, copilot-instructions.md, .cursorrules) to guide your AI. UTF is complementary — not competing:
Use markdown instructions to shape how your AI thinks. Use UTF to verify and report on what it produced.
Key Features
- 13 MCP tools — generate, validate, register, analyze, trace, execute, mutate, report, and query tests
- 6 languages — Python, TypeScript, JavaScript, Java, Go, C++
- 7 test types — unit, integration, API, E2E, contract, performance, security
- 8-section contract — every test must pass all 8 sections or it is blocked (minimum score: 0.85)
- 3-segment test IDs — TC-{PRJ}-{MODULE}-{NNN} and classic TC-{MODULE}-{NNN} both accepted
- Five install modes — uvx (zero-clone), local clone, Docker, GitHub MCP Registry, pip SDK
- VS Code @utf — chat participant with slash commands
- CI/CD ready — GitHub Actions, GitLab CI, pre-commit hooks
- Per-project overrides — YAML rules in .utf/rules/ override global defaults
Quick Start
Setup Method Comparison
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Universal Test Framework: common questions
- Is Universal Test Framework MCP server safe?
- Mostly: it is graded B (78/100). Read the Universal Test Framework safety report
- How do I install Universal Test Framework?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Universal Test Framework need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Universal Test Framework maintained?
- The last commit was 204 days ago (2026-04-14). The latest release is v1.0.2.
- How does Universal Test Framework compare with other MCP servers?
- safety score 78/100 (higher than 57% of 48,255 servers); tools 14 (the typical server has 7); tools that change things 14% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.