MCP Frontend Testing Server
Description
This MCP server provides tools for frontend testing, including:
- Code Analysis: Analyzes JavaScript/TypeScript code to determine appropriate testing strategies.
- Test Generation: Generates unit and component tests for Jest and Cypress.
- Test Running: Executes tests using Jest and Cypress and returns results.
- Component Testing: Provides a tool specifically for testing React components.
Getting Started
Installation
- Clone the repository:
`git clone
mcp-frontend-testing` - Navigate to the project directory: `cd mcp-frontend-testing`
- Install dependencies: `npm install`
Running the Server
HTTP Transport
```bash
Build the server
npm run build
Start the server with HTTP transport
npm run start:http ```
Stdio Transport
```bash
Build the server
npm run build
Start the server with Stdio transport
npm run start:stdio ```
Usage
Tools
- analyzeCode: Analyzes code and returns analysis results.
- Parameters:
- `code` (string, required): The source code to analyze.
- `language` (enum, optional): Language of the code (`javascript` | `typescript` | `jsx` | `tsx`, default: `javascript`).
- Parameters:
- generateTest: Generates test code based on source code and framework.
- Parameters:
- `code` (string, required): The source code to generate tests for.
- `framework` (enum, required): Testing framework (`jest` | `cypress`).
- `type` (enum, required): Type of test (`unit` | `component` | `e2e`).
- `language` (enum, optional): Language of the code (`javascript` | `typescript` | `jsx` | `tsx`, default: `javascript`).
- `description` (string, optional): Description of the test case.
- Parameters:
- runTest: Runs tests and returns results.
- Parameters:
- `sourceCode` (string, required): The source code being tested.
- `testCode` (string, required): The test code to execute.
- `framework` (enum, required): Testing framework (`jest` | `cypress`).
- `type` (enum, required): Type of test (`unit` | `component` | `e2e`).
- `config` (record, optional): Configuration object for test execution.
- Parameters:
- testReactComponent: Runs component tests specifically for React components.
- Parameters:
- `componentCode` (string, required): The source code of the React component.
- `testCode` (string, optional): Test code for the component (auto-generated if not provided).
- `framework` (enum, optional): Testing framework (`jest` | `cypress`, default: `jest`).
- `props` (record, optional): Props to pass to the component during testing.
- `autoGenerateTest` (boolean, optional): Automatically generate test code if not provided (default: `true`).
- Parameters:
Resources
- templates: Provides test templates.
- URI: `templates://{framework}/{type}`
- Parameters:
- `framework` (string, required): Testing framework (`jest` | `cypress`).
- `type` (string, required): Type of template (`unit` | `component`).
- docs: Provides documentation for testing frameworks.
- URI: `docs://{topic}`
- Parameters:
- `topic` (string, required): Documentation topic (`jest` | `cypress` | `react-testing-library`).
Deployment
Docker
Build and run the server using Docker:
```bash docker build -t mcp-frontend-testing . docker run -p 3000:3000 mcp-frontend-testing ```
Cloud
Deploy to cloud platforms like AWS Lambda, Google Cloud Run, or Azure Functions for serverless or containerized deployments.
Note: This server is designed to be used with an MCP client to enable LLMs to perform frontend testing tasks.