Wuniq KE (Knowledge Engine)

Wuniq MCP

Wuniq は無料です。この MCP パッケージには Wuniq デスクトップアプリが必要です。現在、Windows と Linux で利用できます。wuniq.com の公式で信頼できるリンクからのみダウンロードしてください。サードパーティのミラーは使用しないでください。

Wuniq は、AI を活用した作業のためのナレッジエンジンです。判断、制約、意図、人間の推論をプロジェクトファイルの隣にある .wuniq ファイルに保存するため、MCP 互換の AI はどれでも、作業場所にあるナレッジをそのまま読み取り、維持できます。

Wuniq はローカルファーストです。アカウントも、クラウドストレージも、テレメトリーもありません。

このリポジトリに含まれるもの

このリポジトリには、@wuniq/mcp として公開されている小規模なオープンソース MCP ランチャー、公式 MCP Registry に提出されたマニフェスト、そしてすべてが同じランチャーを起動する、Claude、Codex、Antigravity、Gemini CLI 向けの薄いラッパーが含まれています。

ランチャーには依存関係がありません。MCP クライアントを、インストール済みの Wuniq デスクトップアプリに含まれる MCP サーバーに接続します。

MCP-compatible AI or IDE
          |
          v
    npx @wuniq/mcp
          |
          v
Installed Wuniq desktop app
          |
          v
Local projects and .wuniq knowledge

Wuniq Knowledge Engine 自体はこのリポジトリに含まれておらず、npm でも配布されていません。このリポジトリの MIT ライセンスは、ランチャーのみに適用されます。

インストールと接続

1. wuniq.com の公式ダウンロードリンクを使用して、無料の Wuniq デスクトップアプリをインストールします。
2. 対応している場合は IDE の MCP レジストリギャラリーから Wuniq を追加するか、手動で設定します。

{
  "mcpServers": {
    "wuniq": {
      "command": "npx",
      "args": ["-y", "@wuniq/mcp"]
    }
  }
}

アプリをすでにインストールしていますか？MCP 設定で、公式の Wuniq インストールによって PATH に配置された wuniq-mcp コマンドを直接指定することもできます。どちらの方法でも、同じローカルエンジンに接続します。

IDE ごとの手順と現在のプラットフォーム対応状況は、wuniq.com で確認できます。

OpenCode

OpenCode は、プロジェクトレベルの opencode.json ファイルを使用します。既存のプロバイダー、権限、その他の MCP サーバーはそのままにして、mcp キーの下に Wuniq を追加します。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "wuniq": {
      "type": "local",
      "command": ["npx", "-y", "@wuniq/mcp"],
      "enabled": true,
      "timeout": 30000
    }
  }
}

次に、既存の指示を削除せずに、プロジェクトの AGENTS.md に Wuniq のワークフローを追加します。

# Wuniq KE (Knowledge Engine)

At the start of every session, run `open list` using the Wuniq MCP tool. If it returns projects, `open` each one. If the list is empty, proceed normally — the user may open projects later from the Wuniq UI. Never assume the working directory is a Wuniq project; the working directory may be a container folder holding multiple projects. Only open paths that `open list` explicitly returns.

Before working on any code file, `read` its Wuniq sidecar for context. After changing code, run `sync`.

この方法は、Windows 上の OpenCode Desktop 1.18.4、Wuniq 1.15.1、@wuniq/mcp 1.0.1 で検証済みです。MCP 接続と open、read、sync の呼び出しは正常に動作しました。プロンプトがなくてもモデルがどれだけ確実に AGENTS.md の指示に従うかはモデルによって異なるため、open list を明示的に要求することもできます。

検証、Linux の手順、Precise モード、トラブルシューティングについては、Wuniq + OpenCode integration guide をご覧ください。

Claude プラグイン

リポジトリのルートは Claude プラグインでもあります。2 つ目の MCP サーバーは含まれていません。.mcp.json が公開済みの @wuniq/mcp ランチャーを起動し、Claude を、インストール済みの Wuniq アプリ内の MCP サーバーに接続します。

このプラグインには、Claude に安全な Wuniq ワークフローを教える簡潔なスキルが 1 つ含まれています。まず表示可能なプロジェクトを見つけ、作業前にそのコンテキストを読み、確定した判断を保持し、変更後に同期します。ツールを事前承認したり、権限を昇格したりすることはありません。

マーケットプレイスへの提出前に、Claude Code でプラグインを確認し、ローカルで読み込むことができます。

claude plugin validate --strict .
claude --plugin-dir .

Codex プラグイン

同じリポジトリは Codex プラグインでもあります。その .codex-plugin/plugin.json は同じスキルと .mcp.json を再利用します。@wuniq/mcp をローカルで起動し、ホスト型サービスを作成したり、プロジェクトデータをアップロードしたりすることはありません。

Codex から Wuniq の公開マーケットプレイスを追加します。

codex plugin marketplace add Wuniq/wuniq-mcp --ref main

次に、ChatGPT デスクトップアプリで Plugins ディレクトリを開き、Wuniq マーケットプレイスを選択して、Wuniq をインストールします。インストール後に新しい Codex セッションを開始すると、スキルと MCP サーバーが読み込まれます。

ウェブ版の ChatGPT では、このローカルの stdio MCP サーバーを実行できません。そのため、Wuniq の完全な連携は、ChatGPT デスクトップアプリ、Codex CLI、Codex IDE 拡張機能といったローカルの Codex クライアント向けです。

Antigravity プラグイン

リポジトリのルートは、ネイティブの Antigravity プラグインです。その mcp_config.json は公開されている @wuniq/mcp ランチャーを起動し、skills/wuniq/SKILL.md は安全な Wuniq ワークフローを提供します。2つ目の MCP サーバーは含まれておらず、プロジェクトデータをアップロードすることもありません。

公開リポジトリから Antigravity CLI にインストールします。

agy plugin install https://github.com/Wuniq/wuniq-mcp

Antigravity 2.0 では、MCP Store の掲載審査中も、同じ npx -y @wuniq/mcp コマンドを使って Wuniq をカスタム MCP サーバーとして設定できます。

Gemini CLI 拡張機能

リポジトリのルートは、Gemini CLI 拡張機能でもあります。その gemini-extension.json は同じ公開済みの @wuniq/mcp ランチャーを起動し、skills/wuniq/SKILL.md はエージェントスキルとして安全な Wuniq ワークフローを提供します。2つ目の MCP サーバーは含まれておらず、プロジェクトデータをアップロードすることもありません。

公開リポジトリから直接インストールします。

gemini extensions install https://github.com/Wuniq/wuniq-mcp

拡張機能とその MCP ツールを読み込むため、インストール後に Gemini CLI を再起動してください。

Google は、個人、Pro、Ultra ユーザーを Gemini CLI から Antigravity CLI に移行しました。Gemini CLI 拡張機能は、サポート対象の Enterprise、Google Cloud、API ベースの環境で引き続き利用できます。

プロンプトの例

• 「利用可能な Wuniq プロジェクトを開き、このタスクに関する重要なコンテキストを要約してください。」
• 「認証モジュールを変更する前に、Wuniq のコンテキストを読み、すでに決定済みの制約を維持してください。」
• 「今決定した内容を記録し、変更を実装して、完了したら Wuniq sync を実行してください。」

トラブルシューティング

• Wuniq アプリが見つからない場合： wuniq.com の公式リンクからのみインストールし、新しい Claude、Codex、Antigravity、または Gemini CLI セッションを開始してください。
• open list でプロジェクトが表示されない場合： Wuniq デスクトップインターフェースで目的のプロジェクトを開き、AI クライアントにもう一度試すよう依頼してください。
• ランチャーを起動できない場合： Node.js と npx が利用可能であることを確認するか、wuniq.com に記載されているクライアントごとの直接セットアップを使用してください。

ランチャーの仕組み

ランチャーは、MCP クライアントの標準入力と標準出力を、インストール済みアプリに含まれる MCP サーバーへ直接渡します。Wuniq がインストールされていない場合は、公式アプリの入手方法を説明する最小限の MCP 応答のみを返します。

IDE の設定、Wuniq の製品ロジック、プロジェクトデータのアップロード、2つ目の Knowledge Engine の提供は行いません。

セキュリティ

Wuniq は wuniq.com で公開されているリンクからのみインストールしてください。サードパーティのミラーや再パッケージされたインストーラーは使用しないでください。

セキュリティ上の問題を報告する場合は、公開イシューを作成せず、このリポジトリの非公開の脆弱性報告機能を利用してください。SECURITY.md を参照してください。

リンク

• Wuniq のウェブサイトと公式ダウンロード
• 公式 MCP Registry のエントリー
• npm の @wuniq/mcp

ライセンス

このリポジトリの MCP ランチャーと Claude、Codex、Antigravity、Gemini CLI 用ラッパーは、MIT License の下でライセンスされています。Wuniq デスクトップアプリと Knowledge Engine は別個のソフトウェアであり、このリポジトリのライセンスの対象ではありません。