PHPackages                             kwaku/laravel-test-mcp - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Testing & Quality](/categories/testing)
4. /
5. kwaku/laravel-test-mcp

ActiveLibrary[Testing & Quality](/categories/testing)

kwaku/laravel-test-mcp
======================

MCP server for running Laravel Pest and PHPUnit tests from AI assistants like Claude, Cursor, and ChatGPT

186PHP

Since Jan 5Pushed 4mo agoCompare

[ Source](https://github.com/kwakuOfosuAgyeman/laravel-test-mcp)[ Packagist](https://packagist.org/packages/kwaku/laravel-test-mcp)[ RSS](/packages/kwaku-laravel-test-mcp/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Laravel Test Runner MCP
=======================

[](#laravel-test-runner-mcp)

Run Pest and PHPUnit tests directly from AI assistants like Claude, Cursor, and ChatGPT.

Features
--------

[](#features)

- **Progress Tracking**: Real-time progress updates during test execution
- **Cancellation Support**: Cancel long-running operations via operation ID
- **Dry-Run Mode**: Preview what tests would run without executing
- **Confirmation Threshold**: Safety check for large test suites
- **MCP Prompts**: Built-in prompts for TDD workflow, debugging, and coverage analysis

Installation
------------

[](#installation)

```
composer require kwaku/laravel-test-mcp
```

Configuration
-------------

[](#configuration)

Add to your MCP client config:

### Claude Desktop

[](#claude-desktop)

```
{
    "mcpServers": {
        "laravel-tests": {
            "command": "php",
            "args": ["/path/to/your/project/artisan", "mcp:start", "test-runner", "--stdio"]
        }
    }
}
```

### Cursor

[](#cursor)

Same as above, in Cursor's MCP settings.

Available Tools
---------------

[](#available-tools)

### run\_tests

[](#run_tests)

Run tests with optional filtering by path, name, or group.

**Parameters:**

- `path` - File or directory path to test
- `filter` - Filter tests by name (regex supported)
- `group` - Run only tests in specific group(s)
- `exclude_group` - Exclude tests in specific group(s)
- `stop_on_failure` - Stop on first failure
- `parallel` - Run tests in parallel (Pest only)
- `dry_run` - Preview tests without running
- `force` - Skip confirmation for large suites

**Example prompts:**

- "Run the user tests" → `run_tests path: "tests/Unit/UserTest.php"`
- "Run all feature tests" → `run_tests path: "tests/Feature"`
- "Preview what tests would run" → `run_tests dry_run: true`

### list\_tests

[](#list_tests)

List all available tests without running them.

**Parameters:**

- `path` - Directory to scan
- `format` - Output format: tree, flat, or json

### get\_coverage

[](#get_coverage)

Run tests with code coverage analysis.

**Parameters:**

- `path` - Path to test or directory
- `filter_file` - Only show coverage for specific file
- `min_coverage` - Fail if coverage is below this percentage
- `format` - Output format: summary, detailed, or uncovered
- `dry_run` - Preview without running

**Example prompts:**

- "Check my code coverage" → `get_coverage`
- "Get coverage for User model" → `get_coverage filter_file: "app/Models/User.php"`
- "Fail if coverage is below 80%" → `get_coverage min_coverage: 80`

### watch\_tests

[](#watch_tests)

Watch for file changes and auto-run related tests.

**Parameters:**

- `path` - Directory to watch (default: app)
- `test_path` - Test directory (default: tests)
- `duration` - How long to watch in seconds (max: 300)

**Example prompts:**

- "Watch my code for 5 minutes" → `watch_tests duration: 300`
- "Start TDD mode" → `watch_tests`

### cancel\_operation

[](#cancel_operation)

Cancel a running operation by its ID.

**Parameters:**

- `operation_id` - The operation ID (e.g., op\_abc123)

**Example prompts:**

- "Cancel the current operation" → `cancel_operation operation_id: "op_xxx"`

### mutation\_test

[](#mutation_test)

Run mutation testing with Infection to find weak tests.

**Parameters:**

- `path` - Path to test
- `min_msi` - Minimum mutation score indicator

### generate\_test

[](#generate_test)

Analyze a Laravel class and generate comprehensive test stubs with optional factory generation.

**Parameters:**

- `class_path` (required) - Path to the PHP class file (e.g., "app/Models/User.php")
- `test_type` - Type of test: auto, unit, or feature (default: auto)
- `include_comments` - Include explanatory comments (default: true)

**Supported Class Types:**

- **Controllers** → Feature tests with route assertions, auth checks
- **Models** → Unit tests for relationships, scopes, accessors, mutators + Factory generation
- **Services** → Unit tests with dependency mocking
- **FormRequests** → Validation rule tests
- **Jobs** → Dispatch and handle tests
- **Middleware** → Request handling tests
- **Listeners** → Event handling tests

**Example prompts:**

- "Generate tests for the User model" → `generate_test class_path: "app/Models/User.php"`
- "Create tests for UserController" → `generate_test class_path: "app/Http/Controllers/UserController.php"`
- "Generate tests without comments" → `generate_test class_path: "app/Services/PaymentService.php" include_comments: false`

**Output includes:**

- Class analysis (type, methods, dependencies, Laravel features)
- Generated Pest test code
- Factory code (for models)
- Coverage summary
- TODOs for manual completion

Available Resources
-------------------

[](#available-resources)

### test://results/latest

[](#testresultslatest)

Get the latest test run results.

### test://coverage/summary

[](#testcoveragesummary)

Get code coverage statistics.

### test://config

[](#testconfig)

Get test configuration details.

### test://files/{path}

[](#testfilespath)

Read the contents of a specific test file.

### test://history

[](#testhistory)

Get historical test results and trends.

### test://coverage/uncovered/{file}

[](#testcoverageuncoveredfile)

Show uncovered code snippets for a file.

Available Prompts
-----------------

[](#available-prompts)

### tdd\_workflow

[](#tdd_workflow)

Get a structured guide for Test-Driven Development.

**Arguments:**

- `feature` (required) - The feature to implement
- `type` - Test type: unit, feature, or integration

### debug\_failing\_test

[](#debug_failing_test)

Get debugging strategies for a failing test.

**Arguments:**

- `test_name` (required) - Name of the failing test
- `error_message` - The error message

### analyze\_coverage

[](#analyze_coverage)

Get recommendations for improving test coverage.

**Arguments:**

- `target_coverage` - Target percentage (default: 80)
- `focus_area` - Area to focus on (e.g., Models, Controllers)

Environment Variables
---------------------

[](#environment-variables)

```
# Test framework: 'pest', 'phpunit', or leave empty for auto-detection
TEST_MCP_FRAMEWORK=

# Test execution timeout in seconds (default: 300)
TEST_MCP_TIMEOUT=300

# Coverage driver: 'xdebug', 'pcov', or leave empty for auto-detection
TEST_MCP_COVERAGE_DRIVER=

# Confirmation threshold: warn when running more than N tests (default: 50)
TEST_MCP_CONFIRMATION_THRESHOLD=50

# Rate limiting
TEST_MCP_RATE_LIMIT_ENABLED=true
TEST_MCP_RATE_LIMIT_MAX_ATTEMPTS=60
TEST_MCP_RATE_LIMIT_DECAY_SECONDS=60
```

Progress Tracking
-----------------

[](#progress-tracking)

Tools that support progress tracking will output:

1. Operation ID for cancellation
2. Stage updates during execution
3. Percentage completion

Example output:

```
🚀 Operation started (ID: op_abc123xyz)
🔍 Discovering tests...
⏳ Running tests: [5/10] 50.0%
✅ PASSED | 10/10 tests | 2.5s

```

Cancellation
------------

[](#cancellation)

To cancel a running operation:

1. Note the operation ID from the tool output
2. Use `cancel_operation` with that ID
3. The operation will stop at the next checkpoint

Troubleshooting
---------------

[](#troubleshooting)

### Tests not running

[](#tests-not-running)

- Ensure Pest or PHPUnit is installed: `composer require pestphp/pest --dev`
- Check the test path exists
- Verify permissions on vendor/bin/pest or vendor/bin/phpunit

### Coverage not working

[](#coverage-not-working)

- Install Xdebug: `pecl install xdebug`
- Or install PCOV: `pecl install pcov`
- Enable in php.ini

### Rate limit exceeded

[](#rate-limit-exceeded)

- Wait for the decay period (default: 60 seconds)
- Increase `TEST_MCP_RATE_LIMIT_MAX_ATTEMPTS` in .env

### Large test suite warnings

[](#large-test-suite-warnings)

- Use `force: true` to run anyway
- Use `dry_run: true` to preview first
- Adjust `TEST_MCP_CONFIRMATION_THRESHOLD` in .env

License
-------

[](#license)

MIT

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance52

Moderate activity, may be stable

Popularity15

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity12

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/5f833b6e630582dc3e44abe5995d6be02be1d9f76756f5b61ff7e0184216d2fa?d=identicon)[kwakuAgyeman](/maintainers/kwakuAgyeman)

---

Top Contributors

[![kwakuOfosuAgyeman](https://avatars.githubusercontent.com/u/112822461?v=4)](https://github.com/kwakuOfosuAgyeman "kwakuOfosuAgyeman (3 commits)")

---

Tags

laravelmcppestphpunit-teststesting

### Embed Badge

![Health badge](/badges/kwaku-laravel-test-mcp/health.svg)

```
[![Health](https://phpackages.com/badges/kwaku-laravel-test-mcp/health.svg)](https://phpackages.com/packages/kwaku-laravel-test-mcp)
```

###  Alternatives

[phpspec/prophecy

Highly opinionated mocking framework for PHP 5.3+

8.5k551.7M682](/packages/phpspec-prophecy)[vimeo/psalm

A static analysis tool for finding errors in PHP applications

5.8k77.5M6.7k](/packages/vimeo-psalm)[brianium/paratest

Parallel testing for PHP

2.5k118.8M754](/packages/brianium-paratest)[beberlei/assert

Thin assertion library for input validation in business models.

2.4k96.9M570](/packages/beberlei-assert)[mikey179/vfsstream

Virtual file system to mock the real file system in unit tests.

1.4k108.0M2.7k](/packages/mikey179-vfsstream)[orchestra/testbench

Laravel Testing Helper for Packages Development

2.2k39.1M32.1k](/packages/orchestra-testbench)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)