https://github.com/sourcefuse/robotframework-mcp
https://github.com/sourcefuse/robotframework-mcp
Last synced: 6 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/sourcefuse/robotframework-mcp
- Owner: sourcefuse
- License: mit
- Created: 2025-07-28T05:25:52.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-07-31T17:29:46.000Z (6 months ago)
- Last Synced: 2025-08-01T00:54:20.598Z (6 months ago)
- Language: Python
- Size: 39.1 KB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Robot Framework MCP Server
A Model Context Protocol (MCP) server for Robot Framework test automation with custom features
## Features
- 🤖 Generate Robot Framework test cases with SeleniumLibrary
- 📄 Create page object models for web testing
- ⚡ Advanced Selenium keywords for common web interactions
- 📸 Screenshot capabilities and performance monitoring
- 🎯 Input validation and configurable selectors
- 📊 Performance monitoring and metrics collection
- 🔄 Data-driven testing templates
- 🌐 API integration testing capabilities
## Quick Demo Video
https://github.com/user-attachments/assets/47ef8f7b-e3f5-413c-b09f-40168a9d4b44
## Prerequisites
- **Python 3.10 or higher**
- **Node.js 14.0 or higher** (for npx method)
- **UV** (for UV method - optional but recommended)
- Git (for installation from repository)
## Installation & Usage
### Method 1: Using npx (Node.js Package Manager)
Add to your MCP client configuration (e.g., `mcp.json`) in your **VS code or VS code insider**:
```json
{
"servers": {
"robotframework-mcp": {
"command": "npx",
"args": [
"-y",
"git+https://github.com/sourcefuse/robotframework-MCP.git"
],
"type": "stdio"
}
}
}
```
### Method 2: Install from PyPI
```bash
# Install the package
pip3 install robotframework-mcp
# Run the MCP server
robotframework-mcp
```
**For MCP Clients (VS code or VS code inside, etc.):**
```json
{
"mcpServers": {
"robotframework-mcp": {
"command": "robotframework-mcp",
"type": "stdio"
}
}
}
```
### Method 3: Using UV
First install UV:
```bash
# Install UV (choose one method)
curl -LsSf https://astral.sh/uv/install.sh | sh # Unix/macOS
# OR
pip install uv # Any platform
# OR on Windows PowerShell (as Administrator)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
```
Then add to your MCP configuration:
```json
{
"servers": {
"robotframework-mcp": {
"command": "uv",
"args": [
"run",
"--with",
"git+https://github.com/sourcefuse/robotframework-MCP.git",
"python",
"-c",
"import mcp_server; mcp_server.main()"
],
"type": "stdio"
}
}
}
```
## Available Tools
The MCP server provides the following comprehensive tools for Robot Framework test automation:
### 🔧 Core Test Generation
- **`create_login_test_case(url, username, password, template_type="appLocator")`** - Generate validated login test with configurable selectors
- **`create_page_object_login(template_type="appLocator")`** - Generate login page object model with validation
- **`create_data_driven_test(test_data_file="test_data.csv")`** - Generate data-driven test templates
- **`create_api_integration_test(base_url, endpoint, method="GET")`** - Generate API + UI integration tests
### ⚡ Advanced Keywords
- **`create_advanced_selenium_keywords()`** - Generate advanced SeleniumLibrary keywords (dropdowns, checkboxes, file uploads, alerts, etc.)
- **`create_extended_selenium_keywords()`** - Generate extended keywords with screenshots, performance monitoring, and window management
### 📊 Performance & Monitoring
- **`create_performance_monitoring_test()`** - Generate comprehensive performance testing with metrics collection
### 🔍 Validation & Syntax
- **`validate_robot_framework_syntax(robot_code)`** - Validate Robot Framework syntax and provide improvement suggestions
### 📋 Template Options
The server supports multiple selector templates for different applications:
- **`appLocator`** (default) - For web apps
- **`generic`** - Generic web application selectors
- **`bootstrap`** - Bootstrap-based applications
### 🎯 Input Validation
All tools include comprehensive input validation:
- URL validation with protocol checking
- Credential sanitization and length limits
- Selector format validation
- Safe variable substitution in templates
### 🤝 Contributing
Contributions are welcome!
To contribute:
- Fork the repository
- Create a new branch
- Submit a pull request with a detailed description
### 📬 Contact
Name: Meenu Rani
Email: meenu.rani@sourcefuse.com
GitHub: meenurani1
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
Copyright (c) 2025 Sourcefuse