testform-mcp
Official Model Context Protocol (MCP) server for Testform (Test-as-Code): plan, apply, validate, query, scaffold, and report test suites with AI assistants
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/fromeroc9--testform-mcp)HTML
<a href="/listings/fromeroc9--testform-mcp"><img src="/api/listings/fromeroc9--testform-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
1. Claude Desktop Configuration
Add the following to your `claude_desktop_config.json`:
* **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json` * **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
{
"mcpServers": {
"testform": {
"command": "npx",
"args": ["-y", "@fromeroc9/testform-mcp"]
}
}
}2. Cursor IDE Configuration
Add to your project's `.cursor/mcp.json`:
{
"mcpServers": {
"testform": {
"command": "npx",
"args": ["-y", "@fromeroc9/testform-mcp"]
}
}
}3. Local Development / Direct Binary
git clone https://github.com/fromeroc9/testform-mcp.git cd testform-mcp npm install npm run build node dist/index.js
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 90 lines
- # 🤖 Testform MCP Server (`@fromeroc9/testform-mcp`)
- Official **Model Context Protocol (MCP)** server for **Testform** (Test-as-Code). Expose declarative QA orchestration, state ledger reconciliation, Gherkin DSL validation, and test authoring to AI assistants across **Claude Desktop**, **Cursor**, **Antigravity**, **VS Code**, and **Zed**.
- ---
- ## ⚡ Quickstart
- ### 1. Claude Desktop Configuration
- Add the following to your `claude_desktop_config.json`:
- * **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- * **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
- ```json
- {
- "mcpServers": {
- "testform": {
- "command": "npx",
- "args": ["-y", "@fromeroc9/testform-mcp"]
- }
- }
- }
- ```
- ### 2. Cursor IDE Configuration
- Add to your project's `.cursor/mcp.json`:
- ```json
- {
- "mcpServers": {
- "testform": {
- "command": "npx",
- "args": ["-y", "@fromeroc9/testform-mcp"]
- }
- }
- }
- ```
- ### 3. Local Development / Direct Binary
- ```bash
- git clone https://github.com/fromeroc9/testform-mcp.git
- cd testform-mcp
- npm install
- npm run build
- node dist/index.js
- ```
- ---
- ## 🛠️ MCP Tools
- | Tool | Description |
- |---|---|
- | **`testform_plan`** | Evaluates execution diffs, detects drift, and verifies changes against the state ledger without modifying state or disk. |
- | **`testform_apply`** | Reconciles declarative specifications (`.case.feature`, `.run.feature`, `.plan.feature`, `.bug.feature`) and updates `testform.state`. |
- | **`testform_validate`** | Validates Gherkin DSL syntax, policy rules, identity tag patterns, and `main.yml` schema. |
- | **`testform_query`** | Queries Testform resources (`testcase`, `testrun`, `testplan`, `bug`) using tag and field expressions. |
- | **`testform_show`** | Inspects tracked resources, serial, lineage, and outputs from `testform.state`. |
- | **`testform_status`** | Returns an aggregate overview of the workspace (counts, lock file status, and scaffold directories). |
- | **`testform_scaffold`** | Scaffolds standard Test-as-Code feature files with sequential identity tags (`@tc-*`, `@tr-*`, `@tp-*`, `@bg-*`). |
- | **`testform_report`** | Generates modular QA reports in Markdown, JSON, HTML, Excel (`.xlsx`), or Word (`.docx`). |
- | **`testform_attach`** | Attaches screenshots and evidence files according to Testform attachment governance rules (`scaffold.attach`). |
- ---
- ## 📦 MCP Resources
- | URI | MIME Type | Description |
- |---|---|---|
- | **`testform://state`** | `application/json` | The current state ledger (`testform.state`). |
- | **`testform://schema`** | `application/json` | The workspace configuration and scaffold directories declared in `main.yml`. |
- | **`testform://summary`** | `application/json` | Aggregate counts of testcases, scenarios, suites, testplans, and defects. |
- ---
- ## 💡 MCP Prompts
- * **`generate-test-cases`**: Prompts the AI assistant to author high-coverage declarative BDD scenarios with sequential `@tc-*` tags from user stories.
- * **`diagnose-test-failure`**: Prompts the AI assistant to analyze testrun execution failures and author linked `@bug` specifications.
- * **`create-regression-plan`**: Prompts the AI assistant to orchestrate a master release test plan (`.plan.feature`).
- ---
- ## 📜 License
- GPL-3.0-or-later © [Flavio Romero](mailto:flavio.arc9@gmail.com)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.