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

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.