Wuniq

Wuniq MCP

Wuniq es gratuito. Este paquete MCP requiere la aplicación de escritorio Wuniq, disponible actualmente para Windows y Linux. Descárgala solo a través de los enlaces oficiales y confiables en wuniq.com. No uses espejos de terceros.

Wuniq es un motor de conocimiento para el trabajo asistido por IA. Almacena decisiones, restricciones, intención y razonamiento humano en archivos .wuniq junto a los archivos de tu proyecto, de modo que cualquier IA compatible con MCP pueda leer y mantener el conocimiento exactamente donde vive el trabajo.

Wuniq prioriza lo local: sin cuenta, sin almacenamiento en la nube y sin telemetría.

Qué contiene este repositorio

Este repositorio contiene el pequeño lanzador MCP de código abierto publicado como @wuniq/mcp, el manifiesto enviado al Registro oficial de MCP, y envoltorios ligeros para Claude, Codex, Antigravity y Gemini CLI que todos inician el mismo lanzador.

El lanzador no tiene dependencias. Conecta tu cliente MCP al servidor MCP incluido con la aplicación de escritorio Wuniq instalada:

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

El propio Motor de Conocimiento de Wuniq no está contenido en este repositorio y no se distribuye a través de npm. La licencia MIT de este repositorio se aplica solo al lanzador.

Instalar y conectar

1. Instala la aplicación de escritorio gratuita de Wuniq usando un enlace de descarga oficial de wuniq.com.
2. Añade Wuniq desde la galería del registro MCP de tu IDE, donde sea compatible, o configúralo manualmente:

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

¿Ya tienes la aplicación instalada? También puedes apuntar tu configuración MCP directamente al comando wuniq-mcp colocado en tu PATH por la instalación oficial de Wuniq. Ambos métodos se conectan al mismo motor local.

Las instrucciones por IDE y la disponibilidad actual de plataformas se mantienen en wuniq.com.

OpenCode

OpenCode usa un archivo opencode.json a nivel de proyecto. Añade Wuniq bajo su clave mcp, conservando cualquier proveedor, permiso u otro servidor MCP ya presente:

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

Luego añade el flujo de trabajo de Wuniq al AGENTS.md del proyecto sin eliminar ninguna instrucción existente:

# 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`.

Esta ruta fue validada en Windows con OpenCode Desktop 1.18.4, Wuniq 1.15.1 y @wuniq/mcp 1.0.1. La conexión MCP y las llamadas open, read y sync funcionaron correctamente. Los modelos varían en cuán confiablemente actúan sobre AGENTS.md sin indicaciones, por lo que open list siempre se puede solicitar explícitamente.

Consulta la guía completa de integración Wuniq + OpenCode para verificación, instrucciones para Linux, modo Preciso y solución de problemas.

Plugin de Claude

La raíz del repositorio también es un plugin de Claude. No contiene un segundo servidor MCP: .mcp.json inicia el lanzador @wuniq/mcp publicado, que conecta Claude al servidor MCP dentro de la aplicación Wuniq instalada.

El plugin incluye una habilidad compacta que enseña a Claude el flujo de trabajo seguro de Wuniq: descubrir primero los proyectos visibles, leer su contexto antes de trabajar, preservar las decisiones confirmadas y sincronizar después de los cambios. No preaprueba herramientas ni eleva permisos.

Antes del envío al marketplace, el plugin se puede verificar y cargar localmente con Claude Code:

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

Plugin de Codex

El mismo repositorio también es un plugin de Codex. Su .codex-plugin/plugin.json reutiliza la misma habilidad y .mcp.json; inicia @wuniq/mcp localmente y no crea un servicio alojado ni sube datos del proyecto.

Añade el marketplace público de Wuniq desde Codex:

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

Luego abre el directorio Plugins en la aplicación de escritorio de ChatGPT, selecciona el marketplace Wuniq e instala Wuniq. Inicia una nueva sesión de Codex después de la instalación para que la habilidad y el servidor MCP se carguen.

ChatGPT en la web no puede ejecutar este servidor MCP stdio local. La integración completa de Wuniq es, por lo tanto, para clientes Codex locales: la aplicación de escritorio de ChatGPT, Codex CLI y la extensión de Codex para IDE.

Plugin de Antigravity

La raíz del repositorio es un plugin nativo de Antigravity. Su mcp_config.json inicia el lanzador @wuniq/mcp publicado, mientras que skills/wuniq/SKILL.md proporciona el flujo de trabajo seguro de Wuniq. No contiene un segundo servidor MCP ni sube datos del proyecto.

Instálalo en Antigravity CLI desde el repositorio público:

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

En Antigravity 2.0, Wuniq también se puede configurar como un servidor MCP personalizado con el mismo comando npx -y @wuniq/mcp mientras su listado en la MCP Store está en revisión.

Extensión de Gemini CLI

La raíz del repositorio también es una extensión de Gemini CLI. Su gemini-extension.json inicia el mismo lanzador @wuniq/mcp publicado, mientras que skills/wuniq/SKILL.md proporciona el flujo de trabajo seguro de Wuniq como una Habilidad de Agente. No contiene un segundo servidor MCP ni sube datos del proyecto.

Instálala directamente desde el repositorio público:

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

Reinicia Gemini CLI después de la instalación para que la extensión y sus herramientas MCP se carguen.

Google ha migrado a los usuarios personales, Pro y Ultra de Gemini CLI a Antigravity CLI. La extensión de Gemini CLI sigue disponible para entornos empresariales, de Google Cloud y basados en API compatibles.

Ejemplos de indicaciones

• "Abre los proyectos de Wuniq visibles para ti y resume el contexto importante para esta tarea."
• "Antes de cambiar el módulo de autenticación, lee su contexto de Wuniq y preserva las restricciones ya decididas."
• "Registra la decisión que acabamos de tomar, implementa el cambio y ejecuta la sincronización de Wuniq cuando termines."

Solución de problemas

• Falta la aplicación Wuniq: instálala solo desde los enlaces oficiales en wuniq.com y luego inicia una nueva sesión de Claude, Codex, Antigravity o Gemini CLI.
• open list no devuelve proyectos: abre el proyecto previsto en la interfaz de escritorio de Wuniq y pide a tu cliente de IA que lo intente de nuevo.
• El lanzador no puede iniciarse: confirma que Node.js y npx estén disponibles, o usa la configuración directa por cliente documentada en wuniq.com.

Cómo funciona el lanzador

El lanzador pasa la entrada y salida estándar del cliente MCP directamente al servidor MCP incluido con la aplicación instalada. Si Wuniq no está instalado, expone solo una respuesta MCP mínima que explica cómo obtener la aplicación oficial.

No configura IDEs, no contiene lógica de producto de Wuniq, no sube datos del proyecto ni proporciona un segundo Motor de Conocimiento.

Seguridad

Instala Wuniq solo a través de los enlaces publicados en wuniq.com. No uses espejos de terceros ni instaladores reempaquetados.

Para informar un problema de seguridad, usa el informe privado de vulnerabilidades de este repositorio en lugar de abrir un problema público. Consulta SECURITY.md.

Enlaces

• Sitio web de Wuniq y descargas oficiales
• Entrada del Registro oficial de MCP
• @wuniq/mcp en npm

Licencia

El lanzador MCP y los envoltorios de Claude, Codex, Antigravity y Gemini CLI en este repositorio están bajo la Licencia MIT. La aplicación de escritorio Wuniq y el Motor de Conocimiento son software separado y no están cubiertos por la licencia de este repositorio.