@yawlabs/mcp-compliance 0.14.2 → 0.14.3
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 +13 -13
- package/dist/index.js +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -9,9 +9,9 @@
|
|
|
9
9
|
|
|
10
10
|
Built and maintained by [Yaw Labs](https://yaw.sh).
|
|
11
11
|
|
|
12
|
-
[](yaw://install?name=mcp-compliance&command=npx&args=-y%2C%40yawlabs%2Fmcp-compliance&description=Test%20any%20MCP%20server%20against%20the%20spec%20-%2088-test%20suite%20with%20letter-grade%20scoring&source=https%3A%2F%2Fgithub.com%2FYawLabs%2Fmcp-compliance)
|
|
13
13
|
|
|
14
|
-
One click adds this to your
|
|
14
|
+
One click adds this to your local Yaw MCP config so it's available in every Yaw Terminal session. Or install manually below.
|
|
15
15
|
|
|
16
16
|
## Why this tool?
|
|
17
17
|
|
|
@@ -32,20 +32,20 @@ This tool solves that:
|
|
|
32
32
|
**Remote HTTP server:**
|
|
33
33
|
|
|
34
34
|
```bash
|
|
35
|
-
npx @yawlabs/mcp-compliance test https://my-server.com/mcp
|
|
35
|
+
npx @yawlabs/mcp-compliance@latest test https://my-server.com/mcp
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
**Local stdio server** (the vast majority of MCP servers on npm):
|
|
39
39
|
|
|
40
40
|
```bash
|
|
41
41
|
# Pass the command directly, Inspector-style
|
|
42
|
-
npx @yawlabs/mcp-compliance test npx @modelcontextprotocol/server-filesystem /tmp
|
|
42
|
+
npx @yawlabs/mcp-compliance@latest test npx @modelcontextprotocol/server-filesystem /tmp
|
|
43
43
|
|
|
44
44
|
# Or a local build
|
|
45
|
-
npx @yawlabs/mcp-compliance test node ./dist/server.js
|
|
45
|
+
npx @yawlabs/mcp-compliance@latest test node ./dist/server.js
|
|
46
46
|
|
|
47
47
|
# With env vars
|
|
48
|
-
npx @yawlabs/mcp-compliance test -E GITHUB_TOKEN=$GITHUB_TOKEN -- npx @modelcontextprotocol/server-github
|
|
48
|
+
npx @yawlabs/mcp-compliance@latest test -E GITHUB_TOKEN=$GITHUB_TOKEN -- npx @modelcontextprotocol/server-github
|
|
49
49
|
```
|
|
50
50
|
|
|
51
51
|
**Install globally:**
|
|
@@ -421,27 +421,27 @@ Required tests are worth 70% of the score, optional tests 30%. See the [full sco
|
|
|
421
421
|
```yaml
|
|
422
422
|
# GitHub Actions example
|
|
423
423
|
- name: MCP Compliance Check
|
|
424
|
-
run: npx @yawlabs/mcp-compliance test ${{ env.MCP_SERVER_URL }} --strict
|
|
424
|
+
run: npx @yawlabs/mcp-compliance@latest test ${{ env.MCP_SERVER_URL }} --strict
|
|
425
425
|
```
|
|
426
426
|
|
|
427
427
|
```yaml
|
|
428
428
|
# With JSON output for parsing
|
|
429
429
|
- name: MCP Compliance Check
|
|
430
430
|
run: |
|
|
431
|
-
npx @yawlabs/mcp-compliance test ${{ env.MCP_SERVER_URL }} --format json > compliance.json
|
|
431
|
+
npx @yawlabs/mcp-compliance@latest test ${{ env.MCP_SERVER_URL }} --format json > compliance.json
|
|
432
432
|
cat compliance.json | jq '.grade'
|
|
433
433
|
```
|
|
434
434
|
|
|
435
435
|
```yaml
|
|
436
436
|
# With retries for flaky network conditions
|
|
437
437
|
- name: MCP Compliance Check
|
|
438
|
-
run: npx @yawlabs/mcp-compliance test ${{ env.MCP_SERVER_URL }} --strict --retries 2 --timeout 30000
|
|
438
|
+
run: npx @yawlabs/mcp-compliance@latest test ${{ env.MCP_SERVER_URL }} --strict --retries 2 --timeout 30000
|
|
439
439
|
```
|
|
440
440
|
|
|
441
441
|
```yaml
|
|
442
442
|
# SARIF output for GitHub Code Scanning
|
|
443
443
|
- name: MCP Compliance Check
|
|
444
|
-
run: npx @yawlabs/mcp-compliance test ${{ env.MCP_SERVER_URL }} --format sarif > compliance.sarif
|
|
444
|
+
run: npx @yawlabs/mcp-compliance@latest test ${{ env.MCP_SERVER_URL }} --format sarif > compliance.sarif
|
|
445
445
|
- name: Upload SARIF
|
|
446
446
|
uses: github/codeql-action/upload-sarif@v3
|
|
447
447
|
with:
|
|
@@ -457,7 +457,7 @@ This package also exposes an MCP server with 3 tools that can be used from Claud
|
|
|
457
457
|
**Claude Code (one-liner):**
|
|
458
458
|
|
|
459
459
|
```bash
|
|
460
|
-
claude mcp add mcp-compliance -- npx -y @yawlabs/mcp-compliance mcp
|
|
460
|
+
claude mcp add mcp-compliance -- npx -y @yawlabs/mcp-compliance@latest mcp
|
|
461
461
|
```
|
|
462
462
|
|
|
463
463
|
**Or create `.mcp.json` in your project root:**
|
|
@@ -469,7 +469,7 @@ macOS / Linux / WSL:
|
|
|
469
469
|
"mcpServers": {
|
|
470
470
|
"mcp-compliance": {
|
|
471
471
|
"command": "npx",
|
|
472
|
-
"args": ["-y", "@yawlabs/mcp-compliance", "mcp"]
|
|
472
|
+
"args": ["-y", "@yawlabs/mcp-compliance@latest", "mcp"]
|
|
473
473
|
}
|
|
474
474
|
}
|
|
475
475
|
}
|
|
@@ -482,7 +482,7 @@ Windows:
|
|
|
482
482
|
"mcpServers": {
|
|
483
483
|
"mcp-compliance": {
|
|
484
484
|
"command": "cmd",
|
|
485
|
-
"args": ["/c", "npx", "-y", "@yawlabs/mcp-compliance", "mcp"]
|
|
485
|
+
"args": ["/c", "npx", "-y", "@yawlabs/mcp-compliance@latest", "mcp"]
|
|
486
486
|
}
|
|
487
487
|
}
|
|
488
488
|
}
|
package/dist/index.js
CHANGED
|
File without changes
|
package/package.json
CHANGED