Testing

@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