coverage-orchestrator-mcp

A TypeScript MCP server that drives test coverage toward target thresholds by coordinating workspace test execution with code-tree-mcp uncovered-symbol analysis.

What It Does

• ensures workspace coverage tooling exists

• runs tests with coverage and collects failures

• imports LCOV into code-tree-mcp

• fetches uncovered symbols from code-tree-mcp

• ranks the next highest-impact coverage actions

• iterates until thresholds are met or a stop condition is reached

Related MCP server: MCP Java Testing Agent

Requirements

• Node.js 20+

• a reachable code-tree-mcp binary, typically via npx code-tree-mcp

• a target workspace with a Node-based test runner

Install

npm install
npm run build

Run

One-command server startup after build:

npx coverage-orchestrator-mcp

Run the fixture workflow and call the orchestrator from npx:

npx coverage-orchestrator-mcp implementTestCoverage

Optional target percentage:

npx coverage-orchestrator-mcp implementTestCoverage 90

If the percentage is omitted, this command targets 100% (highest possible target).

During local development:

npm run dev

Setup

Print VS Code MCP configuration:

npx coverage-orchestrator-mcp setup --print-config

Write .vscode/mcp.json in the current working directory:

npx coverage-orchestrator-mcp setup --client vscode

If the current directory is not the workspace you want to update, pass --project-root.

Workspace

This repository tree includes a multi-root workspace file at ../new mc.code-workspace that opens both:

• code-tree-mcp

• coverage-orchestrator-mcp

Tool Workflow Example

1. Call ensure_coverage_setup for the target workspace.

2. Call run_tests_with_coverage.

3. Call fetch_uncovered_code.

4. Call verify_coverage_target.

5. Call improve_test_coverage_orchestrator for iterative orchestration.

Troubleshooting

• If setup cannot write .vscode/mcp.json, rerun with --print-config and copy the JSON manually.

• If code-tree-mcp is not on your path, configure the orchestrator process with CODE_TREE_MCP_COMMAND and CODE_TREE_MCP_ARGS.

• If coverage artifacts are missing, confirm the target workspace can run npm run test:coverage and produces both coverage/coverage-summary.json and coverage/lcov.info.

Validation

• npm test runs unit coverage helpers, CLI, server routing, and orchestrator-loop tests.

• npm run test:integration rebuilds the sibling code-tree-mcp package, launches it over stdio, and verifies uncovered-symbol fetching against a real MCP server.