Skip to main content
Glama
release-evidence-pack-mcp

release-evidence-pack-mcp

by xiaohuxi

Release Evidence Pack MCP

A read-only Model Context Protocol server that converts local Git changes and JUnit XML reports into traceable release evidence, risk findings, and a rollback checklist.

Why

Release decisions often rely on scattered screenshots, chat messages, CI logs, and assumptions. This server creates a reproducible evidence pack without deploying, modifying the repository, or uploading source code.

Related MCP server: mcp-policy-guardian

Tools

inspect_release_changes

Inspect a working-tree diff from a base revision and flag high-risk surfaces such as destructive SQL and source changes without test evidence.

summarize_test_reports

Summarize JUnit XML totals while excluding testcase logs and captured output.

build_release_evidence_pack

Combine Git changes and test summaries into structured JSON plus a Markdown decision pack with findings and rollback checks.

Install

npm install
npm run build

Node.js 20 or later is required.

Configure

Set RELEASE_EVIDENCE_ALLOWED_ROOTS to one or more repository roots. Separate paths with ; on Windows or : on Linux/macOS. The current directory is the only allowed root when the variable is absent.

{
  "mcpServers": {
    "release-evidence-pack": {
      "command": "node",
      "args": ["/absolute/path/release-evidence-pack-mcp/dist/index.js"],
      "env": {
        "RELEASE_EVIDENCE_ALLOWED_ROOTS": "/absolute/path/repositories"
      }
    }
  }
}

Example

build_release_evidence_pack({
  "repositoryRoot": "/workspace/service",
  "baseRef": "origin/main",
  "reportFiles": ["target/surefire-reports/TEST-api.xml"]
})

Paired Skill

skills/release-readiness-review turns MCP findings into a strict GO, CONDITIONAL GO, or NO-GO decision with evidence inventory, release gates, owners, and rollback steps.

Security Model

  • Read-only Git and file inspection.

  • No network calls or deployment actions.

  • No shell interpolation; Git is invoked with an argument array.

  • Repository access restricted to configured roots.

  • Report paths cannot escape the repository root.

  • Testcase logs and captured output are not returned.

Development

npm test
npm run build
npm pack --dry-run

License

MIT

Available Tools

3 tools
build_release_evidence_packBuild release evidence packA
Read-onlyIdempotent

Combine Git changes and JUnit reports into a risk decision, findings, and rollback checklist.

Inputs: repositoryRoot (required), baseRef, reportFiles.

inspect_release_changesInspect release changesA
Read-onlyIdempotent

Inspect a local Git diff and classify release risk without changing the repository.

Inputs: repositoryRoot (required), baseRef.

summarize_test_reportsSummarize test reportsA
Read-onlyIdempotent

Summarize local JUnit XML reports without returning testcase logs or captured output.

Inputs: reportFiles (required), repositoryRoot (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct responsibility: one inspects Git changes, one summarizes test reports, one combines them into a final pack. No overlap or ambiguity in purpose.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun snake_case pattern (inspect_release_changes, summarize_test_reports, build_release_evidence_pack), making the set predictable and easy to navigate.

    Tool Count5/5

    Three tools is well-scoped for the server's specific purpose of generating a release evidence pack. Each tool earns its place and there is no redundancy or bloat.

    Completeness5/5

    The tool set covers the entire workflow from inspecting changes and summarizing reports to building the final evidence pack. There are no obvious gaps or dead ends for the stated domain.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers