@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

@rog0x/mcp-testing-tools