# YAP — Yet Another Packager (oci · ghcr.io/m0rf30/yap-mcp:2.5.3)

Build native Linux packages (.deb/.rpm/.apk/.pkg.tar.zst) from a single PKGBUILD via MCP.

- Trust score: 38/100 (low)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- oci · `ghcr.io/m0rf30/yap-mcp:2.5.3`: 38/100 (this document), [markdown](https://verifymcp.io/servers/m0rf30-yap/ghcr-io-m0rf30-yap-mcp-2-5-3.md), [page](https://verifymcp.io/servers/m0rf30-yap/ghcr-io-m0rf30-yap-mcp-2-5-3)

## Channel facts

- Registry: `oci`
- Package: `ghcr.io/m0rf30/yap-mcp:2.5.3`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 0/100
  - Malware scan not yet available for this package.
  - CVE data not yet available for this package.
  - Install-script risk not yet assessed.
  - Dependency-health data not yet available.
- **Provenance & Transparency**: 32/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - License check failed: no license is declared.
  - Actively maintained (last published 0 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 85/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2167 tokens (~108/item across 20 items; 19 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 99% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 2 categories.** Categories scored 0 because we could not verify them: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add m0rf30-yap -- docker run --rm -i ghcr.io/m0rf30/yap-mcp:2.5.3
```

### Codex

```bash
codex mcp add m0rf30-yap -- docker run --rm -i ghcr.io/m0rf30/yap-mcp:2.5.3
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "m0rf30-yap": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "--rm",
        "-i",
        "ghcr.io/m0rf30/yap-mcp:2.5.3"
      ],
      "enabled": true
    }
  }
}
```

### Hermes

```yaml
mcp_servers:
  m0rf30-yap:
    command: "docker"
    args: ["run", "--rm", "-i", "ghcr.io/m0rf30/yap-mcp:2.5.3"]
```

### Other

```json
{
  "mcpServers": {
    "m0rf30-yap": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/m0rf30/yap-mcp:2.5.3"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 38)

First indexed and scored.

## MCP tools (19)

### `build` (~565 tokens)

Start a yap build asynchronously. Returns a buildID; poll via build_status. The tool-call context is NOT propagated to the build — use build_cancel to stop a running build.

Input parameters:

- `cleanBuild` (boolean): clean build dirs before starting
- `compressionDeb` (string): deb compression: zstd, gzip, or xz
- `compressionRpm` (string): rpm compression: zstd, gzip, or xz
- `debugDir` (string): dir to capture per-step build debug artifacts
- `distro` (string): target distro; auto-detected when empty
- `extraRepos` (null|array): extra apt/dnf repo defs (--repo syntax)
- `fromPkgName` (string): start build at this pkg
- `noBuild` (boolean): prepare/resolve only, skip the build step
- `noCheck` (boolean): skip the PKGBUILD check() function
- `noMakeDeps` (boolean): skip makedeps installation entirely
- `onlyPkgNames` (string): csv allowlist of pkg names to build
- `overridePkgRel` (string): override PKGBUILD pkgrel for all pkgs
- `overridePkgVer` (string): override PKGBUILD pkgver for all pkgs
- `parallel` (boolean): run independent build steps in parallel
- `path` (string, required): yap.json file, PKGBUILD file, or dir with either
- `release` (string): target release; auto-detected when empty
- `sbom` (boolean): emit CycloneDX+SPDX SBOMs per artifact
- `sbomFormat` (string): sbom format: cyclonedx, spdx, or both
- `sign` (boolean): sign produced artifacts
- `signKey` (string): signing key path
- `signKeyName` (string): key name embedded in APK signature stream
- `signPassphrase` (string): passphrase for the signing key
- `skipDeps` (null|array): pkgs to omit from makedeps
- `skipHashCheck` (boolean): disable sha verification of sources
- `skipPkgNames` (string): csv denylist of pkg names to skip
- `skipSyncDeps` (boolean): skip pkg-manager update before makedeps
- `skipToolchainValidation` (boolean): skip cross toolchain checks
- `targetArch` (string): cross target; arm64/amd64 aliases ok
- `toPkgName` (string): stop build order at this pkg (inclusive)
- `unverifiedRepos` (boolean): allow apt sources w/o Signed-By
- `verbose` (boolean): enable verbose logging for the build
- `zap` (boolean): remove the build dir after a successful build

Output parameters:

- `buildID` (string): opaque id; poll via build_status
- `containerImage` (string): resolved image tag, e.g. ubuntu-jammy
- `containerRuntime` (string): backend: cli (podman/docker) or rootless
- `distro` (string)
- `inContainer` (boolean): true when dispatched into a container image
- `path` (string)
- `release` (string)
- `state` (string)

### `build_cancel` (~39 tokens)

Cancel a running yap build by buildID. May leave partial artifacts or stale package-manager locks inside the build container.

Input parameters:

- `buildID` (string, required)

Output parameters:

- `canceled` (boolean)

### `build_logs` (~108 tokens)

Fetch captured stdout+stderr from a build session, with tail/since/grep filters.

Input parameters:

- `buildID` (string, required): identifier returned by build
- `context` (integer): with grep: include N lines before/after each match
- `grep` (string): return only lines matching this Go regexp
- `tail` (integer): return only the last N lines; 0 = all
- `withLineNo` (boolean): return per-line {lineno,text} structs alongside log

Output parameters:

- `buildID` (string)
- `bytes` (integer): byte count after filtering
- `lines` (integer): line count after filtering
- `log` (string): filtered log payload
- `numbered` (null|array): set when withLineNo=true
- `regexpInvalid` (boolean): true when the grep regexp failed to compile and was ignored
- `state` (string): running, succeeded, failed, canceled, or unknown

### `build_status` (~31 tokens)

Return the state of a previously-launched yap build.

Input parameters:

- `buildID` (string, required): identifier returned by build

Output parameters:

- `buildID` (string)
- `containerImage` (string): resolved image tag for the dispatch
- `containerRuntime` (string): container backend: cli or rootless
- `distro` (string)
- `endedAt` (string)
- `error` (string)
- `inContainer` (boolean): true when running in a yap image
- `logBytes` (integer): current size of captured log; fetch via build_logs
- `logLines` (integer): current line count of captured log
- `path` (string)
- `release` (string)
- `startedAt` (string)
- `state` (string): running, succeeded, failed, or canceled

### `build_summary` (~54 tokens)

One-shot terminal diagnosis: state, duration, last error line, best-guess failed step, artifact count, and keyword-based hints. Cheaper than fetching full logs.

Input parameters:

- `buildID` (string, required): identifier returned by build

Output parameters:

- `artifactCount` (integer): recognised artifacts found in output dir
- `buildID` (string)
- `durationSec` (integer)
- `error` (string): top-level error from the build pipeline
- `failedStep` (string): phase tag from log: build/strip/package/sign/sbom
- `hints` (null|array): diagnostic hints inferred from log keywords
- `lastErrorLine` (string): last log line matching ERROR/FAIL/fatal
- `state` (string): running, succeeded, failed, canceled, or unknown

### `build_wait` (~66 tokens)

Block until a build reaches a terminal state or the timeout elapses.

Input parameters:

- `buildID` (string, required): identifier returned by build
- `timeoutSec` (integer): max seconds to wait; 0/omitted uses the 50s server cap. Poll again when timedOut=true

Output parameters:

- `buildID` (string)
- `endedAt` (string)
- `error` (string)
- `startedAt` (string)
- `state` (string): final state, or 'running' on timeout
- `timedOut` (boolean)

### `graph` (~61 tokens)

Build the dependency graph (nodes+edges) for a yap project or single PKGBUILD.

Input parameters:

- `path` (string, required): yap.json file, PKGBUILD file, or dir with either
- `theme` (string): optional theme passed to loader; cosmetic only

Output parameters:

- `edges` (null|array)
- `nodes` (null|array)

### `inspect` (~75 tokens)

Inspect an artifact: format, size, sibling SBOM/signature presence. Accepts any host path the server can stat — there is no project sandboxing; clients should pass paths returned by list_artifacts or known build outputs.

Input parameters:

- `artifact` (string, required): path to a built package (.deb/.rpm/.apk/.pkg.tar.*)

Output parameters:

- `artifact` (string)
- `format` (string)
- `hasCycloneDX` (boolean)
- `hasSPDX` (boolean)
- `hasSig` (boolean)
- `sizeBytes` (integer)

### `install` (~60 tokens)

Install a built package artifact on the host. Requires confirm: true.

Input parameters:

- `artifact` (string, required): path to a built .deb/.rpm/.apk/.pkg.tar.* artifact
- `confirm` (boolean, required): must be true to perform the install; default refuses

Output parameters:

- `artifact` (string)
- `error` (string)
- `format` (string)
- `ok` (boolean)

### `list_artifacts` (~70 tokens)

List built package artifacts (.deb/.rpm/.apk/.pkg.tar.*) plus sibling SBOM/sig presence.

Input parameters:

- `buildID` (string): build session whose output dir to scan
- `path` (string): yap.json/PKGBUILD/dir to scan (used when buildID empty)

Output parameters:

- `artifacts` (null|array)
- `outputDir` (string)

### `list_distros` (~22 tokens)

List supported distributions, their package managers, and known packers.

Output parameters:

- `distros` (null|array): distro ids paired with their pkg manager
- `packers` (null|array): package managers yap knows how to drive
- `releases` (null|array): deprecated alias for distros[*].name

### `list_images` (~67 tokens)

List pre-built yap container image tags from build/deploy/ in the yap source tree. Requires running with repoPath pointing at a yap checkout; end-user installations should pass distros from list_distros instead.

Input parameters:

- `repoPath` (string): path to yap source tree; defaults to cwd

Output parameters:

- `images` (null|array)
- `repoPath` (string)

### `parse_pkgbuild` (~102 tokens)

Parse a PKGBUILD into structured JSON (name, version, deps, sources, ...).

Input parameters:

- `distro` (string): distro context for arch/distro-qualified directives
- `path` (string, required): path to a dir containing a PKGBUILD, or to PKGBUILD itself
- `release` (string): release/codename context; auto-detected when empty
- `targetArch` (string): target arch for cross-compile; empty for native

Output parameters:

- `arch` (null|array)
- `codename` (string)
- `conflicts` (null|array)
- `depends` (null|array)
- `distro` (string)
- `epoch` (string)
- `hashSums` (null|array)
- `isSplit` (boolean)
- `license` (null|array)
- `makeDepends` (null|array)
- `optDepends` (null|array)
- `pkgBase` (string)
- `pkgDesc` (string)
- `pkgName` (string)
- `pkgNames` (null|array)
- `pkgRel` (string)
- `pkgVer` (string)
- `provides` (null|array)
- `replaces` (null|array)
- `sources` (null|array)
- `targetArch` (string)
- `url` (string)

### `prepare` (~97 tokens)

Prepare the host build environment (toolchain + base makedeps) for a distro.

Input parameters:

- `distro` (string): distribution name; auto-detected when empty
- `goLang` (boolean): install Go toolchain
- `release` (string): release/codename; auto-detected when empty
- `skipSync` (boolean): skip package-manager update before prerequisites
- `targetArch` (string): target arch; empty for native

Output parameters:

- `distro` (string)
- `error` (string)
- `ok` (boolean)
- `release` (string)

### `pull` (~38 tokens)

Pull the yap container image for the requested distro.

Input parameters:

- `distro` (string, required): distro tag, e.g. 'ubuntu' or 'ubuntu-noble'

Output parameters:

- `distro` (string)
- `error` (string)
- `ok` (boolean)
- `runtime` (string)

### `resolve_distro` (~59 tokens)

Auto-detect distribution and release from /etc/os-release.

Input parameters:

- `distro` (string): distro name; auto-detected from /etc/os-release when empty
- `release` (string): release/codename; auto-detected when matching host

Output parameters:

- `distro` (string): resolved distribution name
- `release` (string): resolved release / codename

### `status` (~20 tokens)

Return yap version, build metadata, and runtime/container detection info.

Output parameters:

- `buildTime` (string): RFC3339 build timestamp
- `commit` (string): git short commit hash
- `goVersion` (string): go runtime version
- `goarch` (string): runtime GOARCH
- `goos` (string): runtime GOOS
- `inContainer` (boolean): true when running inside a container
- `version` (string): yap semantic version

### `validate` (~58 tokens)

Validate a PKGBUILD: parse + check mandatory vars + general validation.

Input parameters:

- `distro` (string): distro context
- `path` (string, required): path to PKGBUILD or its directory
- `release` (string): release/codename context

Output parameters:

- `errors` (null|array): validation error messages; empty when valid
- `pkg` (string): resolved package name
- `valid` (boolean): true when all mandatory fields are well-formed

### `zap` (~114 tokens)

Deeply clean a yap project's build env and artifacts. Requires confirm: true.

Input parameters:

- `confirm` (boolean, required): must be true; zap removes build state and artifacts
- `distro` (string): distro context; auto-detected when empty
- `fromPkgName` (string): only clean from this package onward
- `path` (string, required): yap.json file, PKGBUILD file, or dir with either
- `release` (string): release context
- `toPkgName` (string): only clean up to this package

Output parameters:

- `distro` (string)
- `error` (string)
- `ok` (boolean)
- `path` (string)
- `release` (string)

## Diagnostics

Captured diagnostic sections: Provenance. The full working is on the page: https://verifymcp.io/servers/m0rf30-yap/ghcr-io-m0rf30-yap-mcp-2-5-3#diagnostics

## Score history

- 2026-08-03: 38
- 2026-08-02: 38

## Links

- Repository: https://github.com/M0Rf30/yap
- Changelog RSS feed: https://verifymcp.io/servers/m0rf30-yap/ghcr-io-m0rf30-yap-mcp-2-5-3/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/m0rf30-yap/ghcr-io-m0rf30-yap-mcp-2-5-3/changelog.json
- HTML version of this page: https://verifymcp.io/servers/m0rf30-yap/ghcr-io-m0rf30-yap-mcp-2-5-3
