プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Unified AI System MCP Gateway

作者:happy520aiバージョン 0.8.0i★ 10 (リポジトリ全体のスター)iパソコンで動く公式サイト ↗
レジストリ名io.github.happy520ai/unified-ai-system

インストール方法

What it does

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

  • Connects パソコンで動く
  • Account or key No key needed
  • Category 検索・AIの記憶

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

作者:google-research★ 35,6291 個の skill

Skill · 手順書

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

作者:BigBodyCobain★ 11,6021 個の skill

Skill · 手順書

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

作者:gosom★ 8,2091 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気6/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア18/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Unified AI System MCP Gateway をインストールして。https://mcp.popnx.com/i/happy520ai-unified-ai-system.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Docker を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server Unified AI System MCP Gateway を入れてください。順番に:1) docker --version で Docker があるか確認。なければ https://www.docker.com/products/docker-desktop/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "unified-ai-system": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Unified AI System MCP Gateway のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Docker を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    docker --version
    • バージョン番号(例 Docker version …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です

    Docker のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version

    一度入れれば、Docker を使うすべてのツールで使えます

  2. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  3. この設定を貼り付けて保存

    {
      "mcpServers": {
        "unified-ai-system": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

    Unified AI System MCP Gateway を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Unified AI System MCP Gateway を使っていると言うか、回答に Unified AI System MCP Gateway のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Unified AI System MCP Gateway につなげません

Unified AI System MCP Gateway はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Unified AI System MCP Gateway につなげるアプリを使う

  • 先にパソコンへ Docker を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 先にパソコンへ Docker を入れてください(1 回だけ)
  • 先にパソコンへ Docker を入れてください(1 回だけ)
  • 先にパソコンへ Docker を入れてください(1 回だけ)

B · 検索・AIの記憶 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Docker を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server Unified AI System MCP Gateway を入れてください。順番に:1) docker --version で Docker があるか確認。なければ https://www.docker.com/products/docker-desktop/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user unified-ai-system -- docker run -i --rm ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Unified AI System MCP Gateway のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Docker を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    docker --version
    • バージョン番号(例 Docker version …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です

    Docker のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version

    一度入れれば、Docker を使うすべてのツールで使えます

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --scope user unified-ai-system -- docker run -i --rm ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0
  4. Claude Code で /mcp と入力

    Unified AI System MCP Gateway が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    Unified AI System MCP Gateway を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Unified AI System MCP Gateway を使っていると言うか、回答に Unified AI System MCP Gateway のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Docker を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server Unified AI System MCP Gateway を入れてください。順番に:1) docker --version で Docker があるか確認。なければ https://www.docker.com/products/docker-desktop/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "unified-ai-system": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Unified AI System MCP Gateway のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Docker を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    docker --version
    • バージョン番号(例 Docker version …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です

    Docker のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version

    一度入れれば、Docker を使うすべてのツールで使えます

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. Cursor の AI チャットを Agent モードで開く

  4. 試してみる

    Unified AI System MCP Gateway を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Unified AI System MCP Gateway を使っていると言うか、回答に Unified AI System MCP Gateway のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Docker を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server Unified AI System MCP Gateway を入れてください。順番に:1) docker --version で Docker があるか確認。なければ https://www.docker.com/products/docker-desktop/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "unified-ai-system": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Unified AI System MCP Gateway のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Docker を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    docker --version
    • バージョン番号(例 Docker version …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です

    Docker のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version

    一度入れれば、Docker を使うすべてのツールで使えます

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. VS Code の AI チャットを Agent モードで開く

  4. 試してみる

    Unified AI System MCP Gateway を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Unified AI System MCP Gateway を使っていると言うか、回答に Unified AI System MCP Gateway のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Unified AI System MCP Gateway を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

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

Claude Desktop (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"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

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

VS Code (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"
      ]
    }
  }
}

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

GitHubスターi
10 (リポジトリ全体のスター)
このリポジトリには複数の MCP があり、スターは順位で1件だけ数えます
週あたりのダウンロードi
npm/PyPIにない
接続方法
パソコンで動く
最新バージョンi
0.8.0
レジストリ公開日i
2026年9月25日
コードの最終更新i
2026年11月18日
作者
happy520ai
パッケージ
oci: ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0
ウェブサイト
happy520ai.github.io
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント happy520ai で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    Apache-2.0を使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

未確認:バージョン付きの npm と PyPI パッケージのみ確認できます

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/happy520ai-unified-ai-system.svg)](https://mcp.popnx.com/en/servers/happy520ai-unified-ai-system)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

検索・AIの記憶のほかのサーバーとの比較i

  • このカテゴリのほかの6394件のうち82%よりスターが多い
  • このカテゴリのほかの6394件のうち42%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの6394件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Unified AI System MCP Gatewayは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(0.8.0)がレジストリに届いたのは2 か月前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにDockerも必要です。

代わりに使えるものは?

同じカテゴリには:OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

作者:every-app広く使われている★ 2.8万5 日前更新

クラウドで動く✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

作者:exa-labs広く使われている★ 52422 か月前更新

クラウドで動く✓ 提供元 · exa.aiPopNx チームが実際に試用

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

作者:MicrosoftDocs広く使われている★ 199712 か月前更新

クラウドで動く✓ 提供元 · microsoft.comPopNx チームが実際に試用

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

作者:proxysoul成長中★ 16262 か月前更新

クラウドで動く✓ empryo.com
似たものと比べる
これ
Unified AI System MCP Gateway
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえはいはいはいいいえいいえ
基本チェック3/35/52/44/44/44/4
ライセンスApache-2.0MITMITCC-BY-4.0NOASSERTIONApache-2.0
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Unified AI System MCP Server

Connect Codex and other MCP hosts to the credential-free Unified AI System preview over stdio or MCP Streamable HTTP.

The server starts an isolated local gateway automatically, pins it to the deterministic fake provider, exposes authenticated permission-scoped tools, and removes the gateway when the MCP session ends. It does not enable or authorize real provider calls.

Tools

ToolBehavior
gateway_healthInspect gateway health and provider safety state.
gateway_readinessInspect first-run and chat readiness.
agent_governance_statusInspect Agent Governance status when the authenticated identity has platform-status access.
agent_governance_listList only governed Agents visible to the authenticated tenant.
agent_governance_describeDescribe one Agent only when it belongs to the authenticated tenant.
gateway_prompt_enhanceStructure a natural-language request locally without a provider call.
gateway_prompt_enhance_llmEnhance prompts via optional LLM backend (or falls back when unavailable).
gateway_chatSend one fake-provider-only chat request.
knowledge_readinessInspect local knowledge infrastructure.
knowledge_retrieveSearch the local knowledge base by keyword.
workflow_healthInspect the governed workflow subsystem.
workflow_actionsList workflow action definitions.
workflow_runExecute a three-step local workflow and atomically publish a tenant-partitioned artifact. Managed mode injects a dedicated file_write Agent; external governed gateways require agentId.
workforce_healthInspect the workforce subsystem.
workforce_agentsList workforce agent descriptors.

Agent Governance inspection tools are read-only. workflow_run writes one controlled local artifact. Agent creation remains available through the REST, shared-SDK, and human Agent Console surfaces because the MCP tool protocol cannot yet prove idempotent, cancellation-safe generation after a transport timeout. No MCP tool exposes Agent creation/execution/revocation, approval/rejection, or policy creation/activation. Governance tools never accept tenantId or ownerUserId: the Gateway binds both from its authenticated identity, and cross-tenant descriptions fail as not found. workflow_run never overwrites an existing path and is routed through Agent Governance when the connected Gateway enables that control plane. The chat tool checks the gateway safety state before every request and fails closed unless realProviderEnabled is exactly false and the response proves executionMode: "fake".

The source build exposes sixteen tools, including the four Agent Governance lifecycle tools and the provider-free gateway_prompt_enhance preview. Published images expose the tool set shipped by their pinned tag.

Run From Source

From the repository root:

pnpm install --frozen-lockfile

node packages/mcp-server/src/index.js

The project-level .codex/config.toml registers that command automatically in trusted Codex projects. Restart Codex after cloning or changing MCP configuration, then use /mcp to inspect the server.

Streamable HTTP

Start the source-build HTTP transport:

pnpm mcp:http

The MCP endpoint is http://127.0.0.1:3210/mcp. It listens on loopback by default, validates Host and Origin, starts the same fake-provider gateway, and exposes the same sixteen source-build tools as stdio. Point any MCP Streamable HTTP client at that URL.

For a local token-protected endpoint, set MCP_HTTP_AUTH_TOKEN and send it as Authorization: Bearer . Binding beyond loopback fails closed unless all of these variables are present:

VariableRequirement
MCP_HTTP_HOSTNon-loopback bind address, such as 0.0.0.0.
MCP_HTTP_AUTH_TOKENAt least 32 bytes; never place it in source control.
MCP_HTTP_ALLOWED_HOSTSComma-separated request hostnames, without ports.
MCP_HTTP_ALLOWED_ORIGINSComma-separated browser origin hostnames, without schemes or ports.

Example for a private deployment behind a TLS reverse proxy:

MCP_HTTP_HOST=0.0.0.0 \

MCP_HTTP_AUTH_TOKEN=replace-with-a-random-secret-of-at-least-32-bytes \ MCP_HTTP_ALLOWED_HOSTS=mcp.example.com \ MCP_HTTP_ALLOWED_ORIGINS=console.example.com \ pnpm mcp:http

The built-in Bearer token is a bounded self-hosting control, not an OAuth authorization server. Terminate TLS at a trusted reverse proxy and use a dedicated identity layer before exposing the endpoint to untrusted networks. The published v0.5.0 container remains stdio-only; the HTTP command above is source-build functionality until a later release publishes it.

Add To Codex With Docker

No clone or API key is required:

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

The dedicated image starts the MCP server by default; no command override is required, and it invokes Node directly so package-manager output cannot pollute the JSON-RPC stream. Its OCI identity and stdio transport are declared in the repository root server.json for the official MCP Registry.

The equivalent config.toml entry is:

[mcp_servers.unified_ai_system]

command = "docker" args = [ "run", "--rm", "-i", "ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0", ] startup_timeout_sec = 45 tool_timeout_sec = 60 default_tools_approval_mode = "writes"

For clients that accept the standard JSON mcpServers shape, use the generic MCP client configuration guide.

Try It In Codex

Restart Codex after adding the server, then run /mcp verbose to inspect the connected tools. A useful first task is:

Use gateway_prompt_enhance to turn "build a small API for my team" into a

coding prompt. Show the preserved original request, detected language,

enhanced prompt, and proof that no provider was called.

Then prove the fake-chat safety boundary:

Use the Unified AI System MCP tools to check gateway health and readiness,

then send MCP_READY through gateway chat only if the gateway proves

fake-only mode. Report the provider, model, execution mode, and response.

The 60-second Codex MCP quickstart includes two more safe tasks, expected evidence, diagnostics, and the removal command.

Connect To An Existing Safe Gateway

Set AI_GATEWAY_MCP_URL and a dedicated gateway access token to use an already running instance:

AI_GATEWAY_MCP_URL=http://127.0.0.1:3100 \

AI_GATEWAY_MCP_AUTH_TOKEN= \ node packages/mcp-server/src/index.js

The managed gateway uses a private least-privilege token whose lifetime is bounded by the isolated child process; it is never emitted in MCP results. External gateway startup rejects missing or weak tokens, URL credentials, non-loopback plaintext HTTP, invalid authentication, or any gateway that may call a real provider. Provider credentials and real-provider execution remain outside this preview surface.

For Agent Governance, give the dedicated Gateway identity only dashboard:read and workflow:run unless a broader operator workflow is explicitly required. agent_governance_status additionally requires the Gateway's platform-tenant identity; ordinary tenants can still use tenant-scoped list, generate, and describe. Do not grant workflow:approve or user:admin to an MCP model merely to use these tools.

Verify

The tests launch both transports through the official MCP v2 client. They pin the modern 2026-07-28 stateless era on stdio and Streamable HTTP, retain legacy 2025-11-25 plus 2025-06-18 initialize compatibility, list all source-build tools, prove local prompt enhancement and fake-provider safety, exercise HTTP/CORS access controls, close the clients, and confirm that each managed gateway stopped. The container-safe raw smoke also uses server/discover plus a per-request _meta envelope rather than inferring modern support from the SDK version:

pnpm verify:mcp