Skip to content
MCP server

Unified AI System MCP Gateway

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

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.8.0
Listing updated
today

About Unified AI System MCP Gateway

Unified AI System MCP Gateway is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Unified AI System sits between your coding agent and execution as a single governed boundary. Its MCP server starts an isolated local gateway automatically, pins it to a deterministic fake provider, and removes the gateway when the session ends. The README is explicit that it does not enable or authorise real provider calls, and the project calls itself a hardened public preview whose verified path uses the fake provider only.

A local deterministic engine can take a rough request and add execution requirements, output constraints, clarification policy and completion criteria while preserving the original text, without calling any model. Read-only tools report gateway health, readiness, knowledge and workforce state and governed agents, while workflow_run executes a three-step local workflow and writes one tenant-partitioned artifact without overwriting existing paths. No tool creates, executes or revokes agents, or approves policies.

It runs from a published container image or from source over stdio or local streamable HTTP, with an optional bearer token and loopback binding by default. The source build exposes sixteen tools.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "unified-ai-system": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "unified-ai-system": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (15)

Taken from the project documentation; the running server may differ.

gateway_health
Inspect gateway health and provider safety state
gateway_readiness
Inspect first-run and chat readiness
agent_governance_status
Inspect Agent Governance status
agent_governance_list
List governed agents visible to the tenant
agent_governance_describe
Describe one agent in the tenant
gateway_prompt_enhance
Structure a request locally without a provider call
gateway_prompt_enhance_llm
Enhance prompts via an optional LLM backend
gateway_chat
Send one fake-provider-only chat request
knowledge_readiness
Inspect local knowledge infrastructure
knowledge_retrieve
Search the local knowledge base by keyword
workflow_health
Inspect the workflow subsystem
workflow_actions
List workflow action definitions
workflow_run
Execute a three-step local workflow and publish an artifact
workforce_health
Inspect the workforce subsystem
workforce_agents
List workforce agent descriptors

What it does

Provider-free prompt enhancement
Structures a rough request locally and keeps the original visible.
Fake-provider default
Chat is checked to fail closed unless the real provider flag is false.
Governance inspection
Lists and describes governed agents visible to the authenticated tenant.
Local workflows
Runs a three-step workflow that publishes a tenant-partitioned artifact.
Knowledge search
Searches the local knowledge base by keyword.
Stdio or HTTP
Run over stdio or a loopback streamable HTTP endpoint with optional token.

Good for

  • Try a governed MCP gateway in Codex, Cursor or Cline without any provider credentials
  • Turn vague requests into explicit task specs before sending them to a model
  • Inspect agent governance and workflow state from an editor
  • Evaluate gateway safety behaviour in a local sandbox

Pricing

Open source

Free and open source, self-hosted

Prices change. Check happy520ai.github.io before you buy.

Unified AI System MCP Gateway FAQ

Does it call real AI providers?

No. The server pins the gateway to a fake provider and does not authorise real calls.

Which clients does it target?

Codex, Cursor and Cline.

How is it run?

From a published OCI image over stdio, or from source with a local streamable HTTP option.

Is it production ready?

The project calls itself a hardened public preview and says production still needs independent deployment evidence.

Is Unified AI System MCP Gateway free?

Yes. Unified AI System MCP Gateway is open source, so you can use and self-host it for free.

How do I add Unified AI System MCP Gateway to Claude Code?

Run this command in your terminal: claude mcp add unified-ai-system -- docker run -i --rm ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0

What are the best alternatives to Unified AI System MCP Gateway?

The closest alternatives to Unified AI System MCP Gateway are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Unified AI System MCP Gateway

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools