@democratize-quality/mcp-server 1.1.2 → 1.1.4
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.
- package/README.md +17 -47
- package/docs/test-agents.md +673 -0
- package/package.json +2 -1
- package/src/chatmodes//360/237/214/220 api-planner.chatmode.md" +111 -16
- package/src/tools/api/api-generator.js +170 -5
- package/src/tools/api/api-planner.js +1026 -10
- package/src/tools/api/prompts/generation-prompts.js +131 -27
- package/src/tools/api/prompts/healing-prompts.js +56 -4
- package/src/tools/api/prompts/orchestrator.js +5 -4
- package/src/tools/api/prompts/validation-rules.js +90 -2
- package/src/utils/agentInstaller.js +1 -1
package/README.md
CHANGED
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
**The fastest way to get started** - Install with intelligent testing agents for GitHub Copilot:
|
|
14
14
|
|
|
15
15
|
```bash
|
|
16
|
-
npx @democratize-quality/mcp-server --agents
|
|
16
|
+
npx @democratize-quality/mcp-server@latest --agents
|
|
17
17
|
```
|
|
18
18
|
|
|
19
19
|
**What this does:**
|
|
@@ -22,6 +22,12 @@ npx @democratize-quality/mcp-server --agents
|
|
|
22
22
|
- ✅ Configures VS Code integration automatically
|
|
23
23
|
- ✅ Creates project folders (`.github/chatmodes/`, `.vscode/`)
|
|
24
24
|
|
|
25
|
+
## 🎥 Video Tutorial
|
|
26
|
+
|
|
27
|
+
[](https://www.youtube.com/watch?v=aEpdALTMCos)
|
|
28
|
+
|
|
29
|
+
**[▶️ Watch the complete walkthrough](https://www.youtube.com/watch?v=aEpdALTMCos)** - Learn how to use the API Test Agents to build comprehensive test coverage for REST and GraphQL APIs.
|
|
30
|
+
|
|
25
31
|
**One-Click Alternative:**
|
|
26
32
|
|
|
27
33
|
[<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522democratize-quality%2522%252C%2522type%2522%253A%2522stdio%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540democratize-quality%252Fmcp-server%2522%255D%252C%2522cwd%2522%253A%2522%2524%257BworkspaceFolder%257D%2522%252C%2522env%2522%253A%257B%2522NODE_ENV%2522%253A%2522production%2522%252C%2522OUTPUT_DIR%2522%253A%2522.%252Fapi-test-reports%2522%257D%257D) [<img alt="Install in VS Code Insiders" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5">](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522democratize-quality%2522%252C%2522type%2522%253A%2522stdio%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540democratize-quality%252Fmcp-server%2522%255D%252C%2522cwd%2522%253A%2522%2524%257BworkspaceFolder%257D%2522%252C%2522env%2522%253A%257B%2522NODE_ENV%2522%253A%2522production%2522%252C%2522OUTPUT_DIR%2522%253A%2522.%252Fapi-test-reports%2522%257D%257D)
|
|
@@ -318,14 +324,6 @@ npx playwright test tests/books.spec.ts
|
|
|
318
324
|
|
|
319
325
|
### Scenario 2: Quick API Documentation with Postman
|
|
320
326
|
|
|
321
|
-
**What healer fixes:**
|
|
322
|
-
- ✅ Endpoint URL updates (if API version changes)
|
|
323
|
-
- ✅ Response schema corrections (new/removed fields)
|
|
324
|
-
- ✅ Data type adjustments (string vs number IDs)
|
|
325
|
-
- ✅ Status code updates
|
|
326
|
-
|
|
327
|
-
### Scenario 2: Quick API Documentation with Postman
|
|
328
|
-
|
|
329
327
|
**Goal:** Generate a ready-to-use Postman collection for the Fake REST API
|
|
330
328
|
|
|
331
329
|
```
|
|
@@ -370,43 +368,6 @@ Import the generated collection into Postman and start testing!
|
|
|
370
368
|
|
|
371
369
|
### Tool 1: `api_planner`
|
|
372
370
|
|
|
373
|
-
```
|
|
374
|
-
@🌐 api-generator create Jest tests with environment-specific configurations
|
|
375
|
-
for dev (api-dev.example.com), staging (api-staging.example.com),
|
|
376
|
-
and prod (api.example.com) environments
|
|
377
|
-
```
|
|
378
|
-
|
|
379
|
-
**What you get:**
|
|
380
|
-
```javascript
|
|
381
|
-
// tests/config/environments.js
|
|
382
|
-
module.exports = {
|
|
383
|
-
dev: { baseURL: 'https://api-dev.example.com', timeout: 5000 },
|
|
384
|
-
staging: { baseURL: 'https://api-staging.example.com', timeout: 3000 },
|
|
385
|
-
prod: { baseURL: 'https://api.example.com', timeout: 2000 }
|
|
386
|
-
};
|
|
387
|
-
|
|
388
|
-
// Run with: NODE_ENV=staging npm test
|
|
389
|
-
```
|
|
390
|
-
|
|
391
|
-
---
|
|
392
|
-
|
|
393
|
-
## � Calling Individual Tools
|
|
394
|
-
|
|
395
|
-
### When to Use Individual Tools
|
|
396
|
-
|
|
397
|
-
**Use agents (@api-planner, @api-generator, @api-healer) when:**
|
|
398
|
-
- You want AI assistance and recommendations
|
|
399
|
-
- You're working on complex, multi-step workflows
|
|
400
|
-
- You need explanations and best practices
|
|
401
|
-
|
|
402
|
-
**Use individual tools when:**
|
|
403
|
-
- You need precise control over parameters
|
|
404
|
-
- You're automating tests in CI/CD
|
|
405
|
-
- You're integrating with other tools
|
|
406
|
-
- You want to script repetitive tasks
|
|
407
|
-
|
|
408
|
-
### Tool 1: `api_planner`
|
|
409
|
-
|
|
410
371
|
**Purpose:** Analyze API schemas and generate comprehensive test plans with realistic sample data
|
|
411
372
|
|
|
412
373
|
**Basic usage:**
|
|
@@ -929,6 +890,7 @@ MCP_FEATURES_ENABLEDEBUGMODE=true node mcpServer.js
|
|
|
929
890
|
- 📖 [Getting Started Guide](docs/getting-started.md) - Complete setup walkthrough
|
|
930
891
|
- 🔧 [Tool Reference](docs/api/tool-reference.md) - Detailed tool documentation
|
|
931
892
|
- 🎯 [API Tools Usage Guide](docs/api_tools_usage.md) - Advanced examples and patterns
|
|
893
|
+
- 🔷 [GraphQL Support Guide](GRAPHQL-SUPPORT.md) - GraphQL testing capabilities and features
|
|
932
894
|
- �💻 [Developer Guide](docs/development/adding-tools.md) - Extend the server
|
|
933
895
|
- ⚙️ [Configuration Guide](docs/development/configuration.md) - Advanced settings
|
|
934
896
|
- � [Examples](docs/examples/) - Real-world usage examples
|
|
@@ -1092,7 +1054,15 @@ ISC License - See [LICENSE](LICENSE) file for details
|
|
|
1092
1054
|
|
|
1093
1055
|
---
|
|
1094
1056
|
|
|
1095
|
-
##
|
|
1057
|
+
## � License
|
|
1058
|
+
|
|
1059
|
+
This project is licensed under the **ISC License** - see the [LICENSE](LICENSE) file for details.
|
|
1060
|
+
|
|
1061
|
+
**TL;DR:** Free to use, modify, and distribute. No warranty. Use at your own risk.
|
|
1062
|
+
|
|
1063
|
+
---
|
|
1064
|
+
|
|
1065
|
+
## �🙏 Acknowledgments
|
|
1096
1066
|
|
|
1097
1067
|
Built with the [Model Context Protocol](https://modelcontextprotocol.io/) framework.
|
|
1098
1068
|
|