@testkase/test-management-mcp 2.4.0 → 2.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +88 -189
  2. package/build/index.js +1 -1
  3. package/package.json +8 -3
package/README.md CHANGED
@@ -1,189 +1,88 @@
1
- <p align="center">
2
- <a href="https://testkase.com">
3
- <img src="https://testkase.com/logo.png" alt="TestKase" width="120" />
4
- </a>
5
- </p>
6
-
7
- <h3 align="center">@testkase/test-management-mcp</h3>
8
-
9
- <p align="center">
10
- Official MCP server for <a href="https://testkase.com">TestKase</a> Test Management — connect your AI agent to a complete test management platform.<br/>Formerly <code>@testkase/mcp-server</code>. For real phones and browsers, see <code>@testkase/device-farm-mcp</code>.
11
- </p>
12
-
13
- <p align="center">
14
- <a href="https://www.npmjs.com/package/@testkase/test-management-mcp"><img src="https://img.shields.io/npm/v/@testkase/test-management-mcp.svg?style=flat-square" alt="npm version" /></a>
15
- <a href="https://www.npmjs.com/package/@testkase/test-management-mcp"><img src="https://img.shields.io/npm/dm/@testkase/test-management-mcp.svg?style=flat-square" alt="npm downloads" /></a>
16
- <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square" alt="MIT License" /></a>
17
- </p>
18
-
19
- ---
20
-
21
- ## What is this?
22
-
23
- This package gives AI agents — Claude Desktop, GitHub Copilot, Cursor, or any [MCP](https://modelcontextprotocol.io)-compatible client — full access to your TestKase projects. Your agent can create test cases, run test cycles, record execution results, and pull reports, all through natural language.
24
-
25
- **11 tools. Zero config beyond a token. Works out of the box.**
26
-
27
- ## Quick Start
28
-
29
- ### 1. Get a PAT token
30
-
31
- Log in to [TestKase](https://www.testkase.com) > **API Keys** > **Generate New Token**
32
-
33
- ### 2. Add to your AI agent
34
-
35
- <details>
36
- <summary><strong>Claude Desktop</strong></summary>
37
-
38
- Edit your config file:
39
- - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
40
- - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
41
-
42
- ```json
43
- {
44
- "mcpServers": {
45
- "testkase": {
46
- "command": "npx",
47
- "args": ["-y", "@testkase/test-management-mcp"],
48
- "env": {
49
- "TESTKASE_API_BASE_URL": "https://api.testkase.com",
50
- "TESTKASE_PAT_TOKEN": "xyz_your_token_here"
51
- }
52
- }
53
- }
54
- }
55
- ```
56
- </details>
57
-
58
- <details>
59
- <summary><strong>GitHub Copilot (VS Code)</strong></summary>
60
-
61
- Edit your config file:
62
- - **Windows:** `%APPDATA%\Code\User\globalStorage\github.copilot\mcp.json`
63
- - **macOS:** `~/Library/Application Support/Code/User/globalStorage/github.copilot/mcp.json`
64
-
65
- ```json
66
- {
67
- "mcpServers": {
68
- "testkase": {
69
- "command": "npx",
70
- "args": ["-y", "@testkase/test-management-mcp"],
71
- "env": {
72
- "TESTKASE_API_BASE_URL": "https://api.testkase.com",
73
- "TESTKASE_PAT_TOKEN": "xyz_your_token_here"
74
- }
75
- }
76
- }
77
- }
78
- ```
79
- </details>
80
-
81
- <details>
82
- <summary><strong>Claude Code (CLI)</strong></summary>
83
-
84
- ```bash
85
- claude mcp add testkase -e TESTKASE_API_BASE_URL=https://api.testkase.com -e TESTKASE_PAT_TOKEN=xyz_your_token_here -- npx -y @testkase/test-management-mcp
86
- ```
87
- </details>
88
-
89
- <details>
90
- <summary><strong>Cursor</strong></summary>
91
-
92
- Add to `.cursor/mcp.json` in your project root:
93
-
94
- ```json
95
- {
96
- "mcpServers": {
97
- "testkase": {
98
- "command": "npx",
99
- "args": ["-y", "@testkase/test-management-mcp"],
100
- "env": {
101
- "TESTKASE_API_BASE_URL": "https://api.testkase.com",
102
- "TESTKASE_PAT_TOKEN": "xyz_your_token_here"
103
- }
104
- }
105
- }
106
- }
107
- ```
108
- </details>
109
-
110
- ### 3. Restart your agent and start talking
111
-
112
- ```
113
- "List my projects"
114
- "Create a login test case in PRJ-1001 with steps"
115
- "Run TEST-1 as pass in cycle TCYCLE-5"
116
- "Show me the execution summary for PRJ-1001"
117
- ```
118
-
119
- ---
120
-
121
- ## Tools
122
-
123
- | Tool | Description |
124
- |------|-------------|
125
- | `list_projects` | List all accessible projects |
126
- | `get_project_structure` | Get folders, labels, members, and field options for a project |
127
- | `search_testcases` | Search test cases by text, folder, filters, sorting, and pagination |
128
- | `get_testcase` | Get full test case details including steps |
129
- | `manage_testcase` | Create, bulk create, update, or delete test cases; add, edit, delete or reorder test steps |
130
- | `manage_folder` | Create, rename, move, or delete folders (all sections) |
131
- | `search_test_cycles` | Search test cycles with execution progress |
132
- | `manage_test_cycle` | Full cycle lifecycle — CRUD, link/unlink/assign test cases |
133
- | `execute_tests` | Record execution results — manual (default) or as a CI/automation run |
134
- | `manage_test_plan` | Full plan lifecycle — CRUD, link/unlink cycles, view test cases |
135
- | `get_report` | Pull from 40+ report types (see below) |
136
-
137
- ### Reporting
138
-
139
- `get_report` covers execution, coverage, trends, team, defect, and insight report types (insights are computed from your data and use no AI credits):
140
-
141
- | Category | Report Types |
142
- |----------|-------------|
143
- | **Execution** | `execution_summary`, `execution_by_cycle`, `execution_by_tester`, `execution_by_priority`, `execution_by_environment`, `execution_by_folder`, `execution_by_automation` |
144
- | **Coverage** | `requirement_coverage`, `traceability_matrix`, `failed_requirements`, `uncovered_requirements`, `testcase_coverage`, `unlinked_testcases` |
145
- | **Trends** | `execution_trend`, `execution_burnup`, `execution_burndown`, `test_creation`, `requirement_coverage_trend`, `execution_velocity` |
146
- | **Comparison** | `cycle_comparison`, `created_vs_executed`, `scorecard_by_folder`, `scorecard_by_tester` |
147
- | **Team** | `tester_workload`, `testcase_distribution`, `tester_effectiveness` |
148
- | **Defects** | `defects_by_cycle`, `defects_by_tester`, `defects_by_folder`, `defect_hotspots` |
149
- | **Insights** | `predictive_failure`, `smart_prioritization`, `testcase_quality`, `stale_tests`, `flaky_tests`, `suite_optimization` |
150
- | **Risk & Release** | `release_readiness`, `risk_heatmap_folder`, `risk_heatmap_feature`, `requirement_risk_matrix`, `cycle_health`, `project_health` |
151
-
152
- ---
153
-
154
- ## Configuration
155
-
156
- | Variable | Required | Default | Description |
157
- |----------|----------|---------|-------------|
158
- | `TESTKASE_PAT_TOKEN` | Yes | — | Personal Access Token (starts with `xyz_`) |
159
- | `TESTKASE_API_BASE_URL` | No | `https://api.testkase.com` | API endpoint |
160
- | `TESTKASE_ORGANIZATION_ID` | No | your first organization | Set this if you belong to more than one organization |
161
- | `TESTKASE_APP_URL` | No | `https://test-management.testkase.com` | Base for the links returned with results |
162
-
163
- ---
164
-
165
- ## Troubleshooting
166
-
167
- | Problem | Solution |
168
- |---------|----------|
169
- | "Authentication required" | Verify your token starts with `xyz_` and hasn't expired |
170
- | Tool not showing up | Restart your AI agent completely; check JSON syntax in config |
171
- | API connection errors | Verify `TESTKASE_API_BASE_URL` is reachable |
172
-
173
- ---
174
-
175
- ## Links
176
-
177
- - [TestKase](https://testkase.com) — Product website
178
- - [Documentation](https://docs.testkase.com) — Full platform docs
179
- - [MCP Protocol](https://modelcontextprotocol.io) — Model Context Protocol spec
180
-
181
- ## License
182
-
183
- MIT
184
-
185
- ---
186
-
187
- <p align="center">
188
- Built by <a href="https://testkase.com">TestKase</a>
189
- </p>
1
+ <p align="center">
2
+ <a href="https://testkase.com">
3
+ <img src="https://testkase.com/logo.png" alt="TestKase" width="120" />
4
+ </a>
5
+ </p>
6
+
7
+ <h3 align="center">@testkase/test-management-mcp</h3>
8
+
9
+ <p align="center">
10
+ Official MCP server for <a href="https://testkase.com">TestKase Test Management</a>: let your AI assistant manage test cases, cycles, plans and reports.
11
+ </p>
12
+
13
+ <p align="center">
14
+ <a href="https://www.npmjs.com/package/@testkase/test-management-mcp"><img src="https://img.shields.io/npm/v/@testkase/test-management-mcp.svg?style=flat-square" alt="npm version" /></a>
15
+ <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square" alt="MIT License" /></a>
16
+ </p>
17
+
18
+ ---
19
+
20
+ Works with Claude, GitHub Copilot, Cursor and any [MCP](https://modelcontextprotocol.io) client. Pairs with [`@testkase/device-farm-mcp`](https://www.npmjs.com/package/@testkase/device-farm-mcp) for real phones and browsers.
21
+
22
+ > **Formerly `@testkase/mcp-server`.** Same tools and key: change the package name in your config to `@testkase/test-management-mcp`.
23
+
24
+ ## Quick start
25
+
26
+ 1. **Get an access key:** TestKase > **API Keys** > **Create API Key** (starts with `xyz_`).
27
+ 2. **Add it to your assistant** (Claude Desktop, Copilot, Cursor: same block in their MCP config file):
28
+
29
+ ```json
30
+ {
31
+ "mcpServers": {
32
+ "testkase": {
33
+ "command": "npx",
34
+ "args": ["-y", "@testkase/test-management-mcp"],
35
+ "env": { "TESTKASE_PAT_TOKEN": "xyz_your_token_here" }
36
+ }
37
+ }
38
+ }
39
+ ```
40
+
41
+ Claude Code:
42
+
43
+ ```bash
44
+ claude mcp add testkase -e TESTKASE_PAT_TOKEN=xyz_your_token_here -- npx -y @testkase/test-management-mcp
45
+ ```
46
+
47
+ 3. **Restart your assistant and ask:** "List my projects", "Create a login test case in PRJ-1001 with steps", "Mark TEST-1 passed in cycle TCYCLE-5", "Show the execution summary".
48
+
49
+ ## Tools
50
+
51
+ | Tool | What it does |
52
+ |------|--------------|
53
+ | `list_projects` / `get_project_structure` | Your projects, and their folders, labels, members and fields. |
54
+ | `search_testcases` / `get_testcase` | Find test cases; read one with its steps. |
55
+ | `manage_testcase` | Create, bulk-create, update or delete test cases and their steps. |
56
+ | `manage_folder` | Create, rename, move or delete folders. |
57
+ | `search_test_cycles` / `manage_test_cycle` | Find and manage test cycles; link and assign test cases. |
58
+ | `execute_tests` | Record results, manual or as a CI run. |
59
+ | `manage_test_plan` | Manage test plans and their cycles. |
60
+ | `get_report` | 40+ reports: execution, coverage, trends, team, defects, insights, risk and release. |
61
+
62
+ ## Your key and privacy
63
+
64
+ - The key stays on your machine and goes only to TestKase.
65
+ - It acts as you, with your project permissions.
66
+ - Test data you ask about is passed to your AI assistant.
67
+
68
+ ## Settings
69
+
70
+ | Variable | Required | Default |
71
+ |----------|----------|---------|
72
+ | `TESTKASE_PAT_TOKEN` | Yes | |
73
+ | `TESTKASE_API_BASE_URL` | No | `https://api.testkase.com` |
74
+ | `TESTKASE_ORGANIZATION_ID` | No | your first organization (set it if you belong to several) |
75
+
76
+ ## Troubleshooting
77
+
78
+ | Problem | Fix |
79
+ |---------|-----|
80
+ | "Authentication required" | Check the key starts with `xyz_` and hasn't expired. |
81
+ | Tools don't show up | Restart the assistant fully; check the JSON in your config. |
82
+ | Connection errors | Check `TESTKASE_API_BASE_URL` is reachable. |
83
+
84
+ ## Links
85
+
86
+ [TestKase](https://testkase.com) · [Docs](https://docs.testkase.com) · [`@testkase/device-farm-mcp`](https://www.npmjs.com/package/@testkase/device-farm-mcp)
87
+
88
+ MIT License
package/build/index.js CHANGED
@@ -12,7 +12,7 @@ const config = {
12
12
  : undefined,
13
13
  appUrl: process.env.TESTKASE_APP_URL?.replace(/\/+$/, ""),
14
14
  };
15
- const VERSION = "2.4.0";
15
+ const VERSION = "2.4.1";
16
16
  const REQUEST_TIMEOUT_MS = 60_000;
17
17
  // ─── Frontend URL helper ─────────────────────────────────────────────────────
18
18
  // Test management lives on its own subdomain
package/package.json CHANGED
@@ -1,10 +1,15 @@
1
1
  {
2
2
  "name": "@testkase/test-management-mcp",
3
- "version": "2.4.0",
3
+ "version": "2.4.1",
4
4
  "description": "Official MCP server for TestKase Test Management (formerly @testkase/mcp-server) — AI-powered test management for Claude, Copilot, and any MCP-compatible agent",
5
5
  "type": "module",
6
- "repository": { "type": "git", "url": "git+https://github.com/SolvionIT/testkase-test-management-mcp.git" },
7
- "publishConfig": { "access": "public" },
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "git+https://github.com/SolvionIT/testkase-test-management-mcp.git"
9
+ },
10
+ "publishConfig": {
11
+ "access": "public"
12
+ },
8
13
  "bin": {
9
14
  "testkase-mcp": "./build/index.js",
10
15
  "testkase-test-management-mcp": "./build/index.js"