Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fromeroc9--testform-mcp/badge.svg)](/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

i

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
  1. # 🤖 Testform MCP Server (`@fromeroc9/testform-mcp`)
  2. 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**.
  3. ---
  4. ## ⚡ Quickstart
  5. ### 1. Claude Desktop Configuration
  6. Add the following to your `claude_desktop_config.json`:
  7. * **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
  8. * **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
  9. ```json
  10. {
  11. "mcpServers": {
  12. "testform": {
  13. "command": "npx",
  14. "args": ["-y", "@fromeroc9/testform-mcp"]
  15. }
  16. }
  17. }
  18. ```
  19. ### 2. Cursor IDE Configuration
  20. Add to your project's `.cursor/mcp.json`:
  21. ```json
  22. {
  23. "mcpServers": {
  24. "testform": {
  25. "command": "npx",
  26. "args": ["-y", "@fromeroc9/testform-mcp"]
  27. }
  28. }
  29. }
  30. ```
  31. ### 3. Local Development / Direct Binary
  32. ```bash
  33. git clone https://github.com/fromeroc9/testform-mcp.git
  34. cd testform-mcp
  35. npm install
  36. npm run build
  37. node dist/index.js
  38. ```
  39. ---
  40. ## 🛠️ MCP Tools
  41. | Tool | Description |
  42. |---|---|
  43. | **`testform_plan`** | Evaluates execution diffs, detects drift, and verifies changes against the state ledger without modifying state or disk. |
  44. | **`testform_apply`** | Reconciles declarative specifications (`.case.feature`, `.run.feature`, `.plan.feature`, `.bug.feature`) and updates `testform.state`. |
  45. | **`testform_validate`** | Validates Gherkin DSL syntax, policy rules, identity tag patterns, and `main.yml` schema. |
  46. | **`testform_query`** | Queries Testform resources (`testcase`, `testrun`, `testplan`, `bug`) using tag and field expressions. |
  47. | **`testform_show`** | Inspects tracked resources, serial, lineage, and outputs from `testform.state`. |
  48. | **`testform_status`** | Returns an aggregate overview of the workspace (counts, lock file status, and scaffold directories). |
  49. | **`testform_scaffold`** | Scaffolds standard Test-as-Code feature files with sequential identity tags (`@tc-*`, `@tr-*`, `@tp-*`, `@bg-*`). |
  50. | **`testform_report`** | Generates modular QA reports in Markdown, JSON, HTML, Excel (`.xlsx`), or Word (`.docx`). |
  51. | **`testform_attach`** | Attaches screenshots and evidence files according to Testform attachment governance rules (`scaffold.attach`). |
  52. ---
  53. ## 📦 MCP Resources
  54. | URI | MIME Type | Description |
  55. |---|---|---|
  56. | **`testform://state`** | `application/json` | The current state ledger (`testform.state`). |
  57. | **`testform://schema`** | `application/json` | The workspace configuration and scaffold directories declared in `main.yml`. |
  58. | **`testform://summary`** | `application/json` | Aggregate counts of testcases, scenarios, suites, testplans, and defects. |
  59. ---
  60. ## 💡 MCP Prompts
  61. * **`generate-test-cases`**: Prompts the AI assistant to author high-coverage declarative BDD scenarios with sequential `@tc-*` tags from user stories.
  62. * **`diagnose-test-failure`**: Prompts the AI assistant to analyze testrun execution failures and author linked `@bug` specifications.
  63. * **`create-regression-plan`**: Prompts the AI assistant to orchestrate a master release test plan (`.plan.feature`).
  64. ---
  65. ## 📜 License
  66. GPL-3.0-or-later © [Flavio Romero](mailto:flavio.arc9@gmail.com)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.