@kryptosai/mcp-observatory 0.22.0 → 0.24.0

package/docs/safety-index/artifacts/filesystem-server.md

@@ -0,0 +1,156 @@
+# MCP Observatory Run Report
+
+Generated at 2026-06-24T02:07:23.999Z
+
+## Target and Environment Metadata
+
+- Target: `filesystem-server`
+- Adapter: `local-process`
+- Command: `npx -y @modelcontextprotocol/server-filesystem examples/filesystem-fixture`
+- Server: `secure-filesystem-server 0.2.0`
+- Platform: `darwin 25.5.0`
+- Node: `v22.22.1`
+
+## Executive Summary
+
+**Health Score: 77/100 (C)**
+
+| Dimension | Score | Weight |
+| --- | --- | --- |
+| Protocol Compliance | 100/100 | 30% |
+| Schema Quality | 60/100 | 20% |
+| Security | 60/100 | 20% |
+| Reliability | 67/100 | 20% |
+| Performance | 100/100 | 10% |
+
+| Gate | Total | Pass | Fail | Partial | Unsupported | Flaky | Skipped |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| pass | 7 | 2 | 0 | 3 | 2 | 0 | 0 |
+
+## At a Glance
+
+- Safety verdict: **Needs review** — The server is usable, but caveated checks should be reviewed before agents depend on it.
+- Top risks: schema-quality: Found 18 quality finding(s) across 14 item(s): 0 warnings, 18 info.; security: Found 3 security finding(s): 0 high, 3 medium, 0 low.; security-lite: Found 3 security finding(s): 0 high, 3 medium, 0 low.
+- Regression/schema drift: Run `mcp-observatory diff <previous-run.json> <current-run.json>` to classify regressions and schema drift.
+- Failing checks: none
+- Partial or flaky checks: security-lite, schema-quality, security
+- Skipped checks: none
+- Unsupported checks: prompts, resources
+- Suggested next step: Review the caveated checks next: security-lite, schema-quality, security.
+- CI next step: `Add CI: npx @kryptosai/mcp-observatory init-ci --all --command "npx -y <server-package>"`
+
+## Regressions and Recoveries
+
+_Use the `diff` command against another run artifact to classify regressions and recoveries over time._
+
+## Full Capability Status Table
+
+| Focus | Check | Status | Duration (ms) | Message |
+| --- | --- | --- | --- | --- |
+| healthy | conformance | pass | 5.24 | All 7 conformance checks passed. |
+| healthy | tools | pass | 5.63 | Advertised capability responded with the minimal expected shape (14 items). |
+| review | schema-quality | partial | 2.26 | Found 18 quality finding(s) across 14 item(s): 0 warnings, 18 info. |
+| review | security | partial | 2.14 | Found 3 security finding(s): 0 high, 3 medium, 0 low. |
+| review | security-lite | partial | 0.18 | Found 3 security finding(s): 0 high, 3 medium, 0 low. |
+| confirm intent | prompts | unsupported | 0.00 | Prompts are not advertised by the target. |
+| confirm intent | resources | unsupported | 0.00 | Resources are not advertised by the target. |
+
+## Evidence Snippets
+
+### conformance — pass
+
+Summary: All 7 conformance checks passed.
+
+- Endpoint: `conformance/check`
+  - Advertised: `true`
+  - Responded: `true`
+  - Minimal shape present: `true`
+  - Item count: `7`
+  - Identifiers: none
+  - Diagnostics: [pass] capabilities-present: Server returned capabilities object., [pass] server-info: Server provided initialization info., [pass] tools-capability-match: tools/list returned 14 tool(s). (+4 more)
+
+### tools — pass
+
+Summary: Advertised capability responded with the minimal expected shape (14 items).
+
+- Endpoint: `tools/list`
+  - Advertised: `true`
+  - Responded: `true`
+  - Minimal shape present: `true`
+  - Item count: `14`
+  - Identifiers: read_file, read_text_file, read_media_file, read_multiple_files, write_file (+9 more)
+  - Diagnostics: Secure MCP Filesystem Server running on stdio, Client does not support MCP Roots, using allowed directories set from server args: [, '/Users/williamweishuhn/Documents/New project/mcp-observatory/examples/filesystem-fixture' (+1 more)
+
+### schema-quality — partial
+
+Summary: Found 18 quality finding(s) across 14 item(s): 0 warnings, 18 info.
+
+- Endpoint: `schema-quality/scan`
+  - Advertised: `true`
+  - Responded: `true`
+  - Minimal shape present: `true`
+  - Item count: `18`
+  - Identifiers: read_file, read_text_file, read_media_file, write_file, edit_file (+7 more)
+  - Diagnostics: [info] tool "read_file": Property 'path' missing description, [info] tool "read_text_file": Property 'path' missing description, [info] tool "read_media_file": Property 'path' missing description (+15 more)
+
+### security — partial
+
+Summary: Found 3 security finding(s): 0 high, 3 medium, 0 low.
+
+- Endpoint: `security/scan`
+  - Advertised: `true`
+  - Responded: `true`
+  - Minimal shape present: `true`
+  - Item count: `3`
+  - Identifiers: write_file, edit_file, create_directory
+  - Diagnostics: [medium] Tool "write_file" accepts filesystem paths and has destructive capabilities., [medium] Tool "edit_file" accepts filesystem paths and has destructive capabilities., [medium] Tool "create_directory" accepts filesystem paths and has destructive capabilities.
+
+### security-lite — partial
+
+Summary: Found 3 security finding(s): 0 high, 3 medium, 0 low.
+
+- Endpoint: `security/scan-lite`
+  - Advertised: `true`
+  - Responded: `true`
+  - Minimal shape present: `true`
+  - Item count: `3`
+  - Identifiers: write_file, edit_file, create_directory
+  - Diagnostics: [medium] Tool "write_file" accepts filesystem paths and has destructive capabilities., [medium] Tool "edit_file" accepts filesystem paths and has destructive capabilities., [medium] Tool "create_directory" accepts filesystem paths and has destructive capabilities.
+
+### prompts — unsupported
+
+Summary: Prompts are not advertised by the target.
+
+- Endpoint: `prompts/list`
+  - Advertised: `false`
+  - Responded: `false`
+  - Minimal shape present: `false`
+  - Item count: `0`
+  - Identifiers: none
+  - Diagnostics: none
+
+### resources — unsupported
+
+Summary: Resources are not advertised by the target.
+
+- Endpoint: `resources/list | resources/templates/list`
+  - Advertised: `false`
+  - Responded: `false`
+  - Minimal shape present: `false`
+  - Item count: `0`
+  - Identifiers: none
+  - Diagnostics: none
+
+## Reproduction Commands
+
+```bash
+npm run cli -- run --target <path-to-target-config.json>
+npm run cli -- report --run <path-to-run-artifact.json> --format markdown
+```
+
+## Artifact Provenance
+
+- Artifact type: `run`
+- Schema version: `1.0.0`
+- Run ID: `run_2026-06-24T020723999Z_5297ea01`
+- Gate: `pass`

package/docs/safety-index/artifacts/memory-server.json

@@ -0,0 +1,469 @@
+{
+  "artifactType": "run",
+  "schemaVersion": "1.0.0",
+  "gate": "pass",
+  "runId": "run_2026-06-24T020723256Z_467de620",
+  "createdAt": "2026-06-24T02:07:23.256Z",
+  "toolVersion": "0.24.0",
+  "target": {
+    "targetId": "memory-server",
+    "adapter": "local-process",
+    "command": "npx",
+    "args": [
+      "-y",
+      "@modelcontextprotocol/server-memory"
+    ],
+    "cwd": ".",
+    "metadata": {
+      "package": "@modelcontextprotocol/server-memory",
+      "purpose": "mcp-safety-index",
+      "riskClass": "Agent memory mutation",
+      "failureClass": "Persistent state tools",
+      "whyItMatters": "Memory tools are agent-facing state; their schemas and write behavior should be visible before use."
+    },
+    "serverName": "memory-server",
+    "serverVersion": "0.6.3"
+  },
+  "environment": {
+    "platform": "darwin 25.5.0",
+    "nodeVersion": "v22.22.1"
+  },
+  "summary": {
+    "total": 7,
+    "pass": 4,
+    "fail": 0,
+    "partial": 1,
+    "unsupported": 2,
+    "flaky": 0,
+    "skipped": 0,
+    "gate": "pass"
+  },
+  "checks": [
+    {
+      "id": "tools",
+      "capability": "tools",
+      "status": "pass",
+      "durationMs": 7.443624999999884,
+      "message": "Advertised capability responded with the minimal expected shape (9 items).",
+      "evidence": [
+        {
+          "endpoint": "tools/list",
+          "advertised": true,
+          "responded": true,
+          "minimalShapePresent": true,
+          "itemCount": 9,
+          "identifiers": [
+            "create_entities",
+            "create_relations",
+            "add_observations",
+            "delete_entities",
+            "delete_observations",
+            "delete_relations",
+            "read_graph",
+            "search_nodes",
+            "open_nodes"
+          ],
+          "diagnostics": [
+            "Knowledge Graph MCP Server running on stdio"
+          ],
+          "schemas": {
+            "create_entities": {
+              "type": "object",
+              "properties": {
+                "entities": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "name": {
+                        "type": "string",
+                        "description": "The name of the entity"
+                      },
+                      "entityType": {
+                        "type": "string",
+                        "description": "The type of the entity"
+                      },
+                      "observations": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        },
+                        "description": "An array of observation contents associated with the entity"
+                      }
+                    },
+                    "required": [
+                      "name",
+                      "entityType",
+                      "observations"
+                    ]
+                  }
+                }
+              },
+              "required": [
+                "entities"
+              ],
+              "$schema": "http://json-schema.org/draft-07/schema#"
+            },
+            "create_relations": {
+              "type": "object",
+              "properties": {
+                "relations": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "from": {
+                        "type": "string",
+                        "description": "The name of the entity where the relation starts"
+                      },
+                      "to": {
+                        "type": "string",
+                        "description": "The name of the entity where the relation ends"
+                      },
+                      "relationType": {
+                        "type": "string",
+                        "description": "The type of the relation"
+                      }
+                    },
+                    "required": [
+                      "from",
+                      "to",
+                      "relationType"
+                    ]
+                  }
+                }
+              },
+              "required": [
+                "relations"
+              ],
+              "$schema": "http://json-schema.org/draft-07/schema#"
+            },
+            "add_observations": {
+              "type": "object",
+              "properties": {
+                "observations": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "entityName": {
+                        "type": "string",
+                        "description": "The name of the entity to add the observations to"
+                      },
+                      "contents": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        },
+                        "description": "An array of observation contents to add"
+                      }
+                    },
+                    "required": [
+                      "entityName",
+                      "contents"
+                    ]
+                  }
+                }
+              },
+              "required": [
+                "observations"
+              ],
+              "$schema": "http://json-schema.org/draft-07/schema#"
+            },
+            "delete_entities": {
+              "type": "object",
+              "properties": {
+                "entityNames": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "An array of entity names to delete"
+                }
+              },
+              "required": [
+                "entityNames"
+              ],
+              "$schema": "http://json-schema.org/draft-07/schema#"
+            },
+            "delete_observations": {
+              "type": "object",
+              "properties": {
+                "deletions": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "entityName": {
+                        "type": "string",
+                        "description": "The name of the entity containing the observations"
+                      },
+                      "observations": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        },
+                        "description": "An array of observations to delete"
+                      }
+                    },
+                    "required": [
+                      "entityName",
+                      "observations"
+                    ]
+                  }
+                }
+              },
+              "required": [
+                "deletions"
+              ],
+              "$schema": "http://json-schema.org/draft-07/schema#"
+            },
+            "delete_relations": {
+              "type": "object",
+              "properties": {
+                "relations": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "from": {
+                        "type": "string",
+                        "description": "The name of the entity where the relation starts"
+                      },
+                      "to": {
+                        "type": "string",
+                        "description": "The name of the entity where the relation ends"
+                      },
+                      "relationType": {
+                        "type": "string",
+                        "description": "The type of the relation"
+                      }
+                    },
+                    "required": [
+                      "from",
+                      "to",
+                      "relationType"
+                    ]
+                  },
+                  "description": "An array of relations to delete"
+                }
+              },
+              "required": [
+                "relations"
+              ],
+              "$schema": "http://json-schema.org/draft-07/schema#"
+            },
+            "read_graph": {
+              "type": "object",
+              "properties": {},
+              "$schema": "http://json-schema.org/draft-07/schema#"
+            },
+            "search_nodes": {
+              "type": "object",
+              "properties": {
+                "query": {
+                  "type": "string",
+                  "description": "The search query to match against entity names, types, and observation content"
+                }
+              },
+              "required": [
+                "query"
+              ],
+              "$schema": "http://json-schema.org/draft-07/schema#"
+            },
+            "open_nodes": {
+              "type": "object",
+              "properties": {
+                "names": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "An array of entity names to retrieve"
+                }
+              },
+              "required": [
+                "names"
+              ],
+              "$schema": "http://json-schema.org/draft-07/schema#"
+            }
+          }
+        }
+      ]
+    },
+    {
+      "id": "prompts",
+      "capability": "prompts",
+      "status": "unsupported",
+      "durationMs": 0.0019579999998313724,
+      "message": "Prompts are not advertised by the target.",
+      "evidence": [
+        {
+          "endpoint": "prompts/list",
+          "advertised": false,
+          "responded": false,
+          "minimalShapePresent": false,
+          "diagnostics": []
+        }
+      ]
+    },
+    {
+      "id": "resources",
+      "capability": "resources",
+      "status": "unsupported",
+      "durationMs": 0.001374999999825377,
+      "message": "Resources are not advertised by the target.",
+      "evidence": [
+        {
+          "endpoint": "resources/list | resources/templates/list",
+          "advertised": false,
+          "responded": false,
+          "minimalShapePresent": false,
+          "diagnostics": []
+        }
+      ]
+    },
+    {
+      "id": "security-lite",
+      "capability": "security-lite",
+      "status": "pass",
+      "durationMs": 0.03662500000018554,
+      "message": "No security issues detected (lightweight scan).",
+      "evidence": [
+        {
+          "endpoint": "security/scan-lite",
+          "advertised": true,
+          "responded": true,
+          "minimalShapePresent": true,
+          "itemCount": 0
+        }
+      ]
+    },
+    {
+      "id": "conformance",
+      "capability": "conformance",
+      "status": "pass",
+      "durationMs": 9.77066700000023,
+      "message": "All 7 conformance checks passed.",
+      "evidence": [
+        {
+          "endpoint": "conformance/check",
+          "advertised": true,
+          "responded": true,
+          "minimalShapePresent": true,
+          "itemCount": 7,
+          "identifiers": [],
+          "diagnostics": [
+            "[pass] capabilities-present: Server returned capabilities object.",
+            "[pass] server-info: Server provided initialization info.",
+            "[pass] tools-capability-match: tools/list returned 9 tool(s).",
+            "[pass] prompts-capability-match: Prompts not advertised — endpoint check skipped.",
+            "[pass] resources-capability-match: Resources not advertised — endpoint check skipped.",
+            "[pass] tool-response-content: Tool \"read_graph\" response has valid content array.",
+            "[pass] error-handling: Server returned proper error code -32601 for unknown method."
+          ]
+        }
+      ]
+    },
+    {
+      "id": "schema-quality",
+      "capability": "schema-quality",
+      "status": "partial",
+      "durationMs": 4.149374999999964,
+      "message": "Found 4 quality finding(s) across 9 item(s): 0 warnings, 4 info.",
+      "evidence": [
+        {
+          "endpoint": "schema-quality/scan",
+          "advertised": true,
+          "responded": true,
+          "minimalShapePresent": true,
+          "itemCount": 4,
+          "identifiers": [
+            "create_entities",
+            "create_relations",
+            "add_observations",
+            "delete_observations"
+          ],
+          "diagnostics": [
+            "[info] tool \"create_entities\": Property 'entities' missing description",
+            "[info] tool \"create_relations\": Property 'relations' missing description",
+            "[info] tool \"add_observations\": Property 'observations' missing description",
+            "[info] tool \"delete_observations\": Property 'deletions' missing description"
+          ]
+        }
+      ]
+    },
+    {
+      "id": "security",
+      "capability": "security",
+      "status": "pass",
+      "durationMs": 4.098707999999988,
+      "message": "No security issues detected.",
+      "evidence": [
+        {
+          "endpoint": "security/scan",
+          "advertised": true,
+          "responded": true,
+          "minimalShapePresent": true,
+          "itemCount": 0
+        }
+      ]
+    }
+  ],
+  "healthScore": {
+    "overall": 85,
+    "grade": "B",
+    "dimensions": [
+      {
+        "name": "Protocol Compliance",
+        "weight": 0.3,
+        "score": 100,
+        "details": [
+          "conformance: pass (100/100)"
+        ]
+      },
+      {
+        "name": "Schema Quality",
+        "weight": 0.2,
+        "score": 60,
+        "details": [
+          "schema-quality: partial (60/100)"
+        ]
+      },
+      {
+        "name": "Security",
+        "weight": 0.2,
+        "score": 100,
+        "details": [
+          "security-lite: pass (100/100)",
+          "security: pass (100/100)"
+        ]
+      },
+      {
+        "name": "Reliability",
+        "weight": 0.2,
+        "score": 67,
+        "details": [
+          "tools: pass (100/100)",
+          "prompts: unsupported (50/100)",
+          "resources: unsupported (50/100)"
+        ]
+      },
+      {
+        "name": "Performance",
+        "weight": 0.1,
+        "score": 100,
+        "details": [
+          "Connect: 703ms",
+          "p95 latency: 7ms (3 operations)"
+        ]
+      }
+    ]
+  },
+  "performanceMetrics": {
+    "connectMs": 703.391959,
+    "toolsListMs": 7.443624999999884,
+    "promptsListMs": 0.0019579999998313724,
+    "resourcesListMs": 0.001374999999825377
+  }
+}