Karibu Testing MCP Server

AI-powered Model Context Protocol server providing comprehensive access to Karibu Testing documentation, code generation, and migration tools

Browser-less Testing

What is Karibu Testing MCP?

This MCP (Model Context Protocol) server provides AI assistants with comprehensive tools for Karibu Testing - the server-side testing framework for Vaadin applications. Generate test code, migrate from other frameworks, and get expert guidance on Vaadin component testing.


Introduction to Karibu Testing by Simon Martinelli

35+
Available Tools
5
Service Categories
100%
Server-side Testing
∞
Code Generation
🧪

Test Generation

Generate complete test classes, methods, and assertions for Vaadin components and views

🔄

Migration Tools

Migrate from Selenium, TestBench, or other testing frameworks to Karibu Testing

📖

Documentation

Access comprehensive examples, patterns, and best practices for Vaadin testing

🎯

Component Testing

Specialized tools for testing all Vaadin components with proper assertions

🧪Test Generation

Generate comprehensive test code for Vaadin applications using Karibu Testing framework.

generateBasicTest
Generate a basic Karibu test class structure for a Vaadin view with MockVaadin setup and teardown
generateNavigationTest
Generate code to test navigation between Vaadin views
generateFormTest
Generate code for form interactions including field input and validation
generateGridTest
Generate code for Vaadin Grid component interactions including selection and data verification
generateViewInitializationTest
Generate test to verify view initialization and component presence
generateDialogTest
Generate test code for dialog interactions including opening, filling, and closing
generateConfirmDialogTest
Generate test code for ConfirmDialog interactions using ConfirmDialogKt helper

🎯Component Testing

Specialized tools for testing individual Vaadin components with proper lookup and interaction patterns.

generateComponentLookup
Generate code to find Vaadin components using LocatorJ with various search criteria
generateButtonClickTest
Generate code to find and click a button in Karibu Testing
generateTextFieldTest
Generate code for TextField interactions including setting value and validation
generateComboBoxTest
Generate code for ComboBox selection and interaction testing
generateCheckboxTest
Generate code for Checkbox interaction testing
generateRadioButtonTest
Generate code for RadioButtonGroup testing
generateDatePickerTest
Generate code for DatePicker testing
generateUploadTest
Generate code for Upload component testing
generateNestedComponentLookup
Generate code to find components within a specific parent component
generateTreeGridTest
Generate code for TreeGrid testing with hierarchical data
generateNotificationTest
Generate code for testing notifications using NotificationKt helper

✅Assertions

Generate comprehensive assertions for validating component states, values, and behaviors.

generateBasicAssertions
Generate common assertions for Vaadin components including visibility, enabled state, and value checks
generateTextAssertions
Generate assertions for text-based components like TextField, Label, Button text content
generateValidationAssertions
Generate assertions for form validation states and error messages
generateGridAssertions
Generate assertions for Grid component data, selection, and column verification
generateNotificationAssertions
Generate assertions for Notification components and their content
generateDialogAssertions
Generate assertions for Dialog components including modal state and content
generateLayoutAssertions
Generate assertions for layout components and their children arrangement
generateCustomComponentAssertions
Generate template for assertions on custom Vaadin components

🔄Migration & Conversion

Tools for migrating existing tests from other frameworks to Karibu Testing.

convertSeleniumToKaribu
Convert Selenium test code to Karibu Testing equivalent
migrateTestBenchToKaribu
Convert Vaadin TestBench test code to Karibu Testing
suggestTestImprovements
Analyze existing Karibu test code and suggest improvements for better maintainability and reliability
generateMigrationChecklist
Generate a checklist for migrating from browser-based testing to Karibu Testing
identifyNonMigratableTests
Analyze test code and identify which tests cannot be migrated to Karibu Testing and why
createHybridTestingPlan
Create a plan for implementing hybrid testing strategy with both Karibu and browser-based tests
getKaribuHelperClassReference
Get reference guide for Karibu Testing helper classes (GridKt, NotificationKt, etc.)

📖Documentation & Examples

Access comprehensive documentation, examples, and best practices for Karibu Testing.

getKaribuTestingExample
Get a complete working example of Karibu Testing for a specific use case
explainKaribuConcept
Explain key Karibu Testing concepts and best practices
getVaadinComponentTestPattern
Get specific testing patterns for different Vaadin components

🚀 Getting Started

To use this MCP server with your AI assistant, configure it in your MCP client:

{
    "mcpServers": {
        "KaribuTesting": {
            "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://karibu-testing-mcp.fly.dev/sse",
                    "--transport",
                    "sse-only"
                ]
            }
    }
}

or if you use Claude Code

claude mcp add --transport sse KaribuTesting https://karibu-testing-mcp.martinelli.ch/sse