Sorify
MCP server for Sorify QA testing platform, enabling AI agents to manage test suites, generate and run tests, and receive notifications through natural language commands.
README
<h1 align="center"><img src="resources/images/sorify-icon.svg" width="192" align="center"/></h1>
<p align="center"> Next generation AI First - QA platform <br><br> QA Platform over MCP<br> Low Tokens consumption<br> Built for AI Agents - Claude/Codex<br><br> Zero-code test management<br> Built for developers, QA or both<br> </p>
<h3 align="center">Control entire QA thru MCP</h3>
Automate: Automate browser testing, using claude, codex - with skills, mcp, test runners & dashboard.
Zero Code: Zero code management, playwright browser automation tests using AI.
Test Management: Organize test suites and test cases, run them on demand or on a schedule.
Test Runners: Playwright-powered execution with full run history.
Notifications: Get notified when suites finish or fail.
User Management: Roles, permissions, and per-user IAM.
MCP Server: Low token consumption over MCP layer, control all aspects of tests cases, code.
Agent Plugins: Claude/Codex plugins for zero-code test generation and management.
Versioning: Every test edit is snapshotted, so you can review and roll back changes.
Feature Matrix
| Feature | MCP | Dashboard | CI Webhook |
|---|---|---|---|
| Suites: list / get / create / update / delete | ✅ | ✅ | - |
| Suite Teams-notification settings | ✅ | ✅ | - |
| Suite schedule (cron): create/update/delete | ✅ | ✅ | - |
| Tests: list / get / create / update / update code / toggle status / delete / bulk-delete | ✅ | ✅ | - |
| Tests: bulk-create (up to 100) | ✅ | - | - |
| Runs: trigger | ✅ | ✅ | ✅ |
| Runs: get | ✅ | ✅ | - |
| Runs: get status | ✅ | ✅ | ✅ |
| Runs: cancel | ✅ | ✅ | - |
| Runs: delete | ✅ | ✅ | - |
| Screenshots: list / get | ✅ | ✅ | - |
| Login / Register / Logout / Password reset | - | ✅ | - |
| Profile: update name / password | - | ✅ | - |
| Dashboard analytics (stats, recent runs) | - | ✅ | - |
| Suite webhook token: regenerate | - | ✅ | - |
| Suite members: add/update/remove privileges | - | ✅ | - |
| Test code-version: restore | - | ✅ | - |
| Admin: manage users (create, list, role, delete, reset password) | - | ✅ | - |
AI Usage
claude /plugin marketplace add https://github.com/rakutentech/sorify.git
codex plugin marketplace add https://github.com/rakutentech/sorify.git
STEP 1 - Setup Sorify MCP
╰─$ cat ~/.sorify
SORIFY_URL=http://localhost:8000/sorify
SORIFY_USERNAME=admin@sorify.local
SORIFY_PASSWORD=changeme
/sorify:gateway create a test suite called "Awesome App"
/sorify:gateway list latest failing tests
/sorify:gateway Create new test suite. Get requirements from JIRA/GHE/Excel. Write using /sorify:generate
/sorify:gateway Update the test suite http://localhost:8000/sorify/suites/{id} by adding retry twice
STEP 2 - QA Skills
# Tests from source code (git)
/sorify:generate Scan my code and generate tests for <github.com/your/repo> <further prompt..>
# Tests from source code (path)
/sorify:generate Scan my code and generate tests for </path/to/your/source> <further prompt..>
# Tests from url (remote)
/sorify:generate Crawl site and generate tests for https://rakuten.co.jp <further prompt..>
# Tests from url (local)
/sorify:generate Crawl site and generate tests for http://localhost:3000/awesome-app <further prompt..>
# Tests from requirements
/sorify:generate Read requirements here <link to docs> <path to docs> <raw paste>
<you got the idea...>
Development (local)
Option 1 - Simple
cp .env.example .env
composer setup
php artisan dev
Option 2 - Detailed
npm run dev
php artisan serve
php artisan queue:work --queue=sorify,default
php artisan schedule:work
Self Hosting
cp .env.docker.example .env.docker
# Update: APP_KEY, DB_PASSWORD, MYSQL_ROOT_PASSWORD
# Change: APP_ENV=prod for prod ready
docker compose --env-file .env.docker up
Verify
http://localhost:8000/sorify
- User: admin@sorify.local
- Password: changeme
Owners
<table> <tr> <td align="center"> <a href="https://github.com/asghar-ahmed"> <img src="https://github.com/asghar-ahmed.png" width="80" height="80" alt="asghar-ahmed"/><br /> <sub><b>asghar-ahmed</b></sub> </a> </td> <td align="center"> <a href="https://github.com/kevincobain2000"> <img src="https://github.com/kevincobain2000.png" width="80" height="80" alt="kevincobain2000"/><br /> <sub><b>kevincobain2000</b></sub> </a> </td> <td align="center"> <a href="https://github.com/pulkit-kathuria"> <img src="https://github.com/pulkit-kathuria.png" width="80" height="80" alt="pulkit-kathuria"/><br /> <sub><b>pulkit-kathuria</b></sub> </a> </td> <td align="center"> <a href="https://github.com/HiromichiHagiwara"> <img src="https://github.com/HiromichiHagiwara.png" width="80" height="80" alt="HiromichiHagiwara"/><br /> <sub><b>HiromichiHagiwara</b></sub> </a> </td> </tr> <tr> <td align="center"> <a href="https://github.com/MarikoKikugawa"> <img src="https://github.com/MarikoKikugawa.png" width="80" height="80" alt="MarikoKikugawa"/><br /> <sub><b>MarikoKikugawa</b></sub> </a> </td> <td align="center"> <a href="https://github.com/chetra-tep"> <img src="https://github.com/chetra-tep.png" width="80" height="80" alt="chetra-tep"/><br /> <sub><b>chetra-tep</b></sub> </a> </td> <td align="center"> <a href="https://github.com/chetratep"> <img src="https://github.com/chetratep.png" width="80" height="80" alt="chetratep"/><br /> <sub><b>chetratep</b></sub> </a> </td> </tr> </table>
Contribution
- Raise an issue or PR to
master
License
Licensed under the Apache License, Version 2.0.
CHANGE LOG
- v1 - Intial Release
- v1.1 - Batteries added on user management, mcp enhancement
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.
E2B
Using MCP to run code via e2b.