Wuniq MCP

Wuniq бесплатен. Этому MCP-пакету требуется десктоп-приложение Wuniq, доступное сейчас для Windows и Linux. Скачивайте его только по официальным проверенным ссылкам на wuniq.com. Не используйте сторонние зеркала.

Wuniq — это движок знаний для работы с ИИ-ассистентами. Он хранит решения, ограничения, намерения и человеческие рассуждения в файлах .wuniq рядом с файлами проекта, благодаря чему любой совместимый с MCP ИИ может читать и поддерживать эти знания прямо там, где ведётся работа.

Wuniq построен по принципу local-first: ни аккаунта, ни облачного хранилища, ни телеметрии.

Что содержит этот репозиторий

В этом репозитории находится небольшой open-source MCP-лаунчер, опубликованный как @wuniq/mcp, манифест, представленный в официальном MCP Registry, и тонкие обёртки для Claude, Codex, Antigravity и Gemini CLI, каждая из которых запускает один и тот же лаунчер.

Лаунчер не имеет ни одной зависимости. Он соединяет ваш MCP-клиент с MCP-сервером, входящим в состав установленного десктоп-приложения Wuniq:

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, приложенная к этому репозиторию, распространяется только на лаунчер.

Установка и подключение

Установите бесплатное десктоп-приложение Wuniq по официальной ссылке для загрузки с wuniq.com.
Добавьте Wuniq из галереи MCP-реестра вашей IDE, где это поддерживается, или настройте вручную:

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

Приложение уже установлено? Тогда можно направить конфигурацию MCP напрямую на команду wuniq-mcp, которую официальный установщик Wuniq добавляет в PATH. Оба способа подключаются к одному и тому же локальному движку.

Инструкции для конкретных IDE и актуальные сведения о доступных платформах собраны на wuniq.com.

OpenCode

OpenCode использует файл opencode.json на уровне проекта. Добавьте Wuniq под ключом mcp, сохранив уже присутствующие провайдеры, разрешения и другие MCP-серверы:

{
  "$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 всегда можно запросить явно.

Полное руководство по интеграции Wuniq + OpenCode охватывает проверку, инструкции для Linux, режим Precise и устранение неполадок.

Плагин для Claude

Корень репозитория одновременно является плагином для Claude. Второго MCP-сервера здесь нет: файл .mcp.json запускает опубликованный лаунчер @wuniq/mcp, который подключает Claude к MCP-серверу внутри установленного приложения Wuniq.

Плагин включает один компактный skill, который обучает Claude безопасному рабочему процессу Wuniq: сначала обнаруживать видимые проекты, читать их контекст перед работой, сохранять подтверждённые решения и синхронизировать изменения после правок. Он не одобряет инструменты заранее и не повышает привилегии.

До публикации в marketplace плагин можно проверить и загрузить локально через Claude Code:

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

Плагин для Codex

Тот же репозиторий является и плагином для Codex. Его файл .codex-plugin/plugin.json переиспользует тот же skill и .mcp.json; он запускает @wuniq/mcp локально, не создаёт hosted-сервис и не выгружает данные проекта.

Добавьте публичный marketplace Wuniq из Codex:

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

Затем откройте каталог Plugins в десктоп-приложении ChatGPT, выберите marketplace Wuniq и установите Wuniq. После установки начните новую сессию Codex, чтобы загрузились skill и MCP-сервер.

ChatGPT в веб-версии не может запустить этот локальный MCP-сервер stdio. Поэтому полная интеграция Wuniq предназначена для локальных клиентов Codex: десктоп-приложения ChatGPT, Codex CLI и расширения Codex для IDE.

Плагин для Antigravity

Корень репозитория — нативный плагин для Antigravity. Его файл mcp_config.json запускает опубликованный лаунчер @wuniq/mcp, а skills/wuniq/SKILL.md описывает безопасный рабочий процесс Wuniq. Второго MCP-сервера здесь нет, данные проекта не выгружаются.

Установите его в Antigravity CLI из публичного репозитория:

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

В Antigravity 2.0 Wuniq также можно настроить как пользовательский MCP-сервер с той же командой npx -y @wuniq/mcp, пока его карточка в MCP Store проходит модерацию.

Расширение для Gemini CLI

Корень репозитория — также расширение для Gemini CLI. Его файл gemini-extension.json запускает тот же опубликованный лаунчер @wuniq/mcp, а skills/wuniq/SKILL.md предоставляет безопасный рабочий процесс Wuniq в формате Agent Skill. Второго MCP-сервера здесь нет, данные проекта не выгружаются.

Установите его напрямую из публичного репозитория:

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

После установки перезапустите Gemini CLI, чтобы загрузились расширение и его MCP-инструменты.

Google перевёл пользователей тарифов personal, 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 и попросите ИИ-клиент повторить попытку.
Лаунчер не запускается: убедитесь, что доступны Node.js и npx, либо воспользуйтесь прямой настройкой для конкретного клиента, описанной на wuniq.com.

Как работает лаунчер

Лаунчер передаёт стандартные потоки ввода и вывода MCP-клиента напрямую MCP-серверу, входящему в состав установленного приложения. Если Wuniq не установлен, лаунчер возвращает лишь минимальный MCP-ответ с объяснением, как получить официальное приложение.

Он не настраивает IDE, не содержит продуктовую логику Wuniq, не выгружает данные проекта и не предоставляет второй Knowledge Engine.

Безопасность

Устанавливайте Wuniq только по ссылкам, опубликованным на wuniq.com. Не используйте сторонние зеркала и перепакованные установщики.

Чтобы сообщить о проблеме безопасности, воспользуйтесь приватным механизмом сообщений об уязвимостях этого репозитория вместо создания публичного issue. Подробнее — в SECURITY.md.

Ссылки

Лицензия

MCP-лаунчер и обёртки для Claude, Codex, Antigravity и Gemini CLI в этом репозитории распространяются по лицензии MIT. Десктоп-приложение Wuniq и Knowledge Engine — отдельные продукты, и лицензия данного репозитория на них не распространяется.