@rog0x/mcp-testing-tools
Testing and quality assurance tools for AI agents, exposed via the Model Context Protocol (MCP).
Tools
generate_tests
Generate test cases from a function signature. Produces four categories of tests as ready-to-run Jest or Vitest code:
- Happy path -- valid inputs, expected outputs
- Edge cases -- empty strings, zero values, null parameters
- Error cases -- missing arguments, wrong types
- Boundary values -- extreme numbers, large arrays, NaN
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
signature | string | Yes | Function signature, e.g. async function fetchUser(id: number): Promise<User> |
framework | string | No | jest or vitest (default: vitest) |
module_path | string | No | Import path for the module under test (default: ./module) |
generate_mock_data
Generate realistic mock data for testing. Supported types:
name, email, address, date, uuid, phone, company, credit_card, ip
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
type | string | Yes | Data type to generate |
count | number | No | Number of items (default: 10, max: 1000) |
locale | string | No | en or es (default: en) |
types | string[] | No | Generate mixed records with multiple field types |
generate_api_mock
Generate mock API responses from a schema definition. Creates realistic JSON payloads for REST endpoints by inferring values from field names and types.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
endpoint | string | Yes | API endpoint path |
method | string | No | HTTP method (default: GET) |
fields | object[] | Yes | Field schemas with name, type, optional items, fields, nullable, enum |
count | number | No | Number of records (default: 1, max: 100) |
status_code | number | No | HTTP status code (default: 200) |
wrap_in_envelope | boolean | No | Wrap in { success, data, meta } (default: true) |
analyze_test_coverage
Analyze source code and test code to find untested functions. Prioritizes suggestions by:
- Export status (public API surface)
- Cyclomatic complexity estimate
- Parameter count
- Async functions (more error paths)
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
source_code | string | Yes | Source code to analyze |
test_code | string | Yes | Existing test code |
source_file_name | string | No | Filename label (default: source.ts) |
generate_assertions
Generate detailed assertion code by comparing expected and actual values. Performs deep diff and produces per-field assertions with descriptive comments.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
expected | string | Yes | Expected value as JSON string |
actual | string | Yes | Actual value as JSON string |
label | string | No | Description for the comparison |
framework | string | No | jest, vitest, or chai (default: jest) |
deep | boolean | No | Deep equality for objects/arrays (default: true) |
Setup
npm install
npm run build
Usage with Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"testing-tools": {
"command": "node",
"args": ["path/to/mcp-testing-tools/dist/index.js"]
}
}
}
License
MIT