Skip to content
MCP server

MCP Test Runner

MCP server that runs pytest and Jest locally and reports normalized test results

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Linux
Runs
Locally
Version
0.1.0
Listing updated
today

Similar MCP servers

About MCP Test Runner

MCP Test Runner is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

The README says this server runs pytest and Jest inside a bounded working directory and returns the raw command output, so an AI client can check claims against real test execution instead of guessing. It also includes a parser that turns pytest and Jest JSON output into one common result format, plus a pytest-cov summary of coverage totals.

Execution is handled by subprocess calls with timeouts and POSIX CPU and memory caps rather than Docker, and the server itself does not use an LLM. Single pytest node ids and Jest test-name patterns can be targeted individually. Coverage summaries are pytest-only in this version.

The project is described as the verification layer in a three-server stack for the wayfinder codebase onboarding agent, alongside repository mapping and Python AST lookup servers. It suits developers wiring test evidence into agent workflows.

Install

Run in a terminal

claude mcp add mcp-test-runner -- uvx lovranran-mcp-test-runner

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-test-runner": {
      "command": "uvx",
      "args": [
        "lovranran-mcp-test-runner"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-test-runner": {
      "command": "uvx",
      "args": [
        "lovranran-mcp-test-runner"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-test-runner": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "lovranran-mcp-test-runner"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-test-runner": {
      "command": "uvx",
      "args": [
        "lovranran-mcp-test-runner"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-test-runner": {
      "command": "uvx",
      "args": [
        "lovranran-mcp-test-runner"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

health
Returns ok for smoke checks.
run_pytest
Run pytest in a bounded working directory and return raw command output.
run_jest
Run Jest through npx jest and return raw command output.
run_single_test
Run one pytest node id or one Jest test-name pattern.
parse_test_output
Normalize test runner JSON output.
get_coverage_summary
Return pytest-cov JSON coverage totals.

What it does

Pytest execution
Runs pytest in a bounded working directory with optional test filtering and resource limits.
Jest execution
Runs Jest through npx with JSON output written to a file.
Single test targeting
Runs one pytest node id or one Jest test-name pattern.
Normalized result parsing
Converts pytest and Jest JSON output into one shared result schema.
Coverage totals
Returns pytest-cov coverage totals from a JSON coverage report.
Resource-capped subprocesses
Applies timeouts and POSIX CPU and memory limits to test runs.

Good for

  • Verifying an AI agent's claims about code behaviour by running the relevant tests
  • Running a single failing pytest or Jest test from an agent workflow
  • Collecting pytest coverage totals during codebase onboarding
  • Normalizing raw Jest or pytest JSON output for downstream tooling

Pricing

Open source

Free and open source under the MIT licence.

MCP Test Runner FAQ

Does the server use an LLM?

No. The README says test results come from subprocess execution and structured parser output.

Is coverage reporting available for Jest?

No. The README says the coverage summary is pytest-only in v1.

Does it run in Docker?

No. The README says v1 does not use Docker and relies on cwd validation, subprocess timeouts, and POSIX resource limits.

What Python version is required?

The README lists Python 3.11+ as the supported scope.

Is MCP Test Runner free?

Yes. MCP Test Runner is open source, so you can use and self-host it for free.

How do I add MCP Test Runner to Claude Code?

Run this command in your terminal: claude mcp add mcp-test-runner -- uvx lovranran-mcp-test-runner

What are the best alternatives to MCP Test Runner?

The closest alternatives to MCP Test Runner are Test, Testing, Api Testing MCP, Test Inventory and Api Test MCP.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers