# Unified AI System MCP Gateway (oci · ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0)

Self-hosted MCP gateway for Codex, Cursor, and Cline with provider-free prompt enhancement.

- Trust score: 50/100 (low)
- Change this week: +9
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-18

## Components

- oci · `ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0`: 50/100 (this document), [markdown](https://verifymcp.io/servers/happy520ai-unified-ai-system/ghcr-io-happy520ai-unified-ai-system-mcp-server-0-8-0.md), [page](https://verifymcp.io/servers/happy520ai-unified-ai-system/ghcr-io-happy520ai-unified-ai-system-mcp-server-0-8-0)

## Channel facts

- Registry: `oci`
- Package: `ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0`
- 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-10-18.

- **Supply Chain Security**: 0/100
  - No malware scan is available for this kind of package: the supply-chain vendors we use do not cover it. This is a permanent gap in our coverage, not a finding about the package.
  - Known CVEs could not be checked: this image's dependency list comes from an SBOM its publisher attached, which nothing verifies, so we will not report it as a clean result.
  - Install-script risk not yet assessed.
  - Dependency health could not be checked: this image's dependency list comes from an SBOM its publisher attached. It names packages and versions but not whether each is deprecated, still maintained or linked to its source, so there is nothing we can fairly grade.
- **Provenance & Transparency**: 48/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (Apache-2.0).
  - Actively maintained (last published 22 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 78/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 884 tokens (~58/item across 15 items; 15 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 67/100
  - Stability observed for 20 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 88/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 1 of 2 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "gateway_chat" implies "send" and declares readOnlyHint instead, contradicting what its own name says it does.
  - An AI judge read all 16 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

**Unverified: 1 category.** A category scored 0 because we could not verify it: 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

### How do I install the Unified AI System MCP Gateway server?

Unified AI System MCP Gateway runs locally as a container image, launched with docker run --rm -i ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0. Ready-made configuration for Claude, Cursor, VS Code, Codex and 3 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add happy520ai-unified-ai-system -- docker run --rm -i ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0
```

### Cursor

```json
{
  "mcpServers": {
    "happy520ai-unified-ai-system": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "happy520ai-unified-ai-system": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add happy520ai-unified-ai-system -- docker run --rm -i ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "happy520ai-unified-ai-system": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "--rm",
        "-i",
        "ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0"
      ],
      "enabled": true
    }
  }
}
```

### Hermes

```yaml
mcp_servers:
  happy520ai-unified-ai-system:
    command: "docker"
    args: ["run", "--rm", "-i", "ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0"]
```

### Netclaw

```json
{
  "McpServers": {
    "happy520ai-unified-ai-system": {
      "Transport": "stdio",
      "Command": "docker",
      "Arguments": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0"
      ]
    }
  }
}
```

### Other

```json
{
  "mcpServers": {
    "happy520ai-unified-ai-system": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0"
      ]
    }
  }
}
```

## 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-10-17 (score 50, +40)

- [security improvement] Injection markers: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Stability: unverified → 0.63

### 2026-10-15 (score 10, −31)

- [security regression] Tool safety: pass → unverified
- [security] Stability: Stability not yet verified: this package installed, but its server did not start, so we have no schema to compare.
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Capabilities: pass → unverified

### 2026-09-28 (score 41, +31)

- [security improvement] Injection markers: unverified → pass
- [security] First check of Judged manipulation: pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] MCP protocol: unverified → pass
- [functional] First check of Tool coverage: 100
- [functional] First check of Destructive annotations: 50
- [functional] First check of Schema quality: excellent
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: pass
- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-09-25 (score 10)

First indexed and scored.

## MCP tools (15)

### `gateway_health` (~22 tokens)

Gateway health

Inspect gateway health, provider mode, and the real-provider safety flag.

### `gateway_readiness` (~21 tokens)

Gateway readiness

Inspect first-run readiness for chat and the local gateway runtime.

### `agent_governance_status` (~40 tokens)

Agent Governance status

Inspect Agent Governance status through the authenticated Gateway identity. The tool accepts no tenant override and fails closed when that identity is not authorized for platform status.

### `agent_governance_list` (~33 tokens)

List governed Agents

List only the governed Agents visible to the Gateway-authenticated tenant. The tool accepts no tenant or owner override.

### `knowledge_readiness` (~20 tokens)

Knowledge readiness

Inspect the gateway knowledge infrastructure without loading or changing data.

### `workflow_health` (~18 tokens)

Workflow health

Inspect the governed workflow subsystem without starting a workflow.

### `workflow_actions` (~17 tokens)

Workflow actions

List workflow action definitions without invoking any action.

### `workforce_health` (~18 tokens)

Workforce health

Inspect the workforce subsystem without planning or executing work.

### `workforce_agents` (~18 tokens)

Workforce agents

List configured workforce agent descriptors without dispatching them.

### `agent_governance_describe` (~52 tokens)

Describe a governed Agent

Describe one governed Agent only when it is visible to the Gateway-authenticated tenant. Cross-tenant and missing identifiers remain indistinguishable.

Input parameters:

- `agentId` (string, required): Server-issued governed Agent identifier

### `gateway_prompt_enhance` (~95 tokens)

Natural-language prompt enhancement

Turn a plain-language request into a structured prompt locally without provider credentials or provider calls.

Input parameters:

- `input` (string, required): The natural-language request to preserve and structure
- `language` (string): Output language; auto follows the input language
- `profile` (string): Optional task profile; auto detects a profile from the request
- `target` (string): Execution target; agent adds a plan-verify-report execution protocol

### `gateway_prompt_enhance_llm` (~122 tokens)

LLM-enhanced prompt enhancement

Enhance a prompt using LLM semantic rewriting when a provider is available. Falls back to the deterministic local engine when no provider is configured.

Input parameters:

- `input` (string, required): The natural-language request to enhance
- `language` (string): Output language
- `modelId` (string): Optional model ID for LLM enhancement
- `profile` (string): Optional task profile hint
- `providerId` (string): Optional provider ID for LLM enhancement
- `target` (string): Execution target; agent adds a plan-verify-report execution protocol

### `gateway_chat` (~37 tokens)

Fake-provider chat

Send one chat request only when the gateway proves that real providers are disabled.

Input parameters:

- `prompt` (string, required): Prompt for the deterministic local fake provider

### `knowledge_retrieve` (~78 tokens)

Knowledge retrieve

Search the local knowledge base by keyword. Returns ranked chunks with citations. Does not call any provider.

Input parameters:

- `query` (string, required): Search query for keyword-based retrieval
- `sourceIds` (array): Optional filter to specific knowledge source IDs
- `topK` (integer): Number of results to return (1-5, default 3)

### `workflow_run` (~118 tokens)

Workflow run

Execute the 3-step local workflow: retrieve knowledge, compose a Markdown report, and write a controlled artifact. Does not call any provider.

Input parameters:

- `agentId` (string): Required when the Gateway has Agent Governance enabled
- `artifactName` (string): Optional filename for the output artifact (without path)
- `goal` (string, required): The workflow goal or objective
- `query` (string): Optional retrieval query; defaults to the goal
- `topK` (integer): Number of knowledge chunks to retrieve (1-5, default 3)

## Diagnostics

Captured diagnostic sections: Provenance, Vulnerabilities. The full working is on the page: https://verifymcp.io/servers/happy520ai-unified-ai-system/ghcr-io-happy520ai-unified-ai-system-mcp-server-0-8-0#diagnostics

## Score history

- 2026-10-18: 50
- 2026-10-17: 50
- 2026-10-16: 10
- 2026-10-15: 10
- 2026-10-14: 41
- 2026-10-13: 41
- 2026-10-12: 41
- 2026-10-10: 41
- 2026-10-08: 41
- 2026-10-06: 41
- 2026-10-04: 41
- 2026-10-03: 41
- 2026-10-02: 41
- 2026-10-01: 41
- 2026-09-30: 41
- 2026-09-29: 41
- 2026-09-28: 41
- 2026-09-27: 10
- 2026-09-26: 10
- 2026-09-25: 10

## Common questions

### What is the Unified AI System MCP Gateway server?

Unified AI System MCP Gateway is listed in the public MCP registry as io.github.happy520ai/unified-ai-system. Self-hosted MCP gateway for Codex, Cursor, and Cline with provider-free prompt enhancement. This page covers its container image (ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0).

### Is the Unified AI System MCP Gateway server safe to use?

Unified AI System MCP Gateway scores 50 out of 100 on VerifyMCP. The SBOM its publisher attached lists packages with 21 known advisories as of 18 October 2026. We do not grade that SBOM, as nothing verifies it. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Unified AI System MCP Gateway server expose?

Unified AI System MCP Gateway exposes 15 tools: gateway_health, gateway_readiness, agent_governance_status, agent_governance_list, knowledge_readiness, and 10 more. Their descriptions and schemas cost roughly 709 tokens of context every time the server is loaded.

### Is the Unified AI System MCP Gateway server still maintained?

Unified AI System MCP Gateway is still listed as active in the MCP registry. We last reached this channel on 18 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Unified AI System MCP Gateway server under?

Unified AI System MCP Gateway declares the Apache-2.0 licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- GitHub Container Registry: https://ghcr.io/happy520ai/unified-ai-system/mcp-server
- Repository: https://github.com/happy520ai/unified-ai-system
- Website: https://happy520ai.github.io/unified-ai-system/
- Changelog RSS feed: https://verifymcp.io/servers/happy520ai-unified-ai-system/ghcr-io-happy520ai-unified-ai-system-mcp-server-0-8-0.xml
- Changelog JSON feed: https://verifymcp.io/servers/happy520ai-unified-ai-system/ghcr-io-happy520ai-unified-ai-system-mcp-server-0-8-0.json
- HTML version of this page: https://verifymcp.io/servers/happy520ai-unified-ai-system/ghcr-io-happy520ai-unified-ai-system-mcp-server-0-8-0