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 知识引擎本身不包含在此仓库中，也不会通过 npm 分发。此仓库中的 MIT 许可证仅适用于启动器。

安装并连接

1. 使用 wuniq.com 上的官方下载链接安装免费的 Wuniq 桌面应用。
2. 在 IDE 支持的情况下，从其 MCP Registry 库中添加 Wuniq；也可以手动配置：

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

已经安装应用？你也可以将 MCP 配置直接指向官方 Wuniq 安装程序添加到 PATH 中的 wuniq-mcp 命令。两种方式连接的都是同一个本地引擎。

各 IDE 的说明和当前平台支持情况请参阅 wuniq.com。

OpenCode

OpenCode 使用项目级 opencode.json 文件。在其 mcp 键下添加 Wuniq，同时保留已有的提供商、权限或其他 MCP 服务：

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

然后将 Wuniq 工作流添加到项目的 AGENTS.md 中，不要删除任何现有指令：

# 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 连接到已安装的 Wuniq 应用中的 MCP 服务。

该插件包含一项简洁的技能，用于教 Claude 安全使用 Wuniq 的工作流：先发现可见项目，再在开始工作前读取项目上下文，保留已确认的决策，并在修改后进行同步。它不会预先批准工具或提升权限。

提交至市场前，可以使用 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 的完整集成面向本地 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 也可以通过相同的 npx -y @wuniq/mcp 命令配置为自定义 MCP 服务；目前其 MCP Store 条目仍在审核中。

Gemini CLI 扩展

此仓库根目录也是一个 Gemini CLI 扩展。它的 gemini-extension.json 会启动相同的已发布 @wuniq/mcp 启动器，而 skills/wuniq/SKILL.md 则以 Agent Skill 的形式提供安全的 Wuniq 工作流。它不包含第二个 MCP 服务，也不会上传项目数据。

直接从公开仓库安装：

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

安装后重新启动 Gemini CLI，以加载扩展及其 MCP 工具。

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 产品逻辑，不会上传项目数据，也不提供第二个 Knowledge Engine。

安全

仅通过 wuniq.com 上发布的链接安装 Wuniq。请勿使用第三方镜像或重新打包的安装程序。

如需报告安全问题，请使用此仓库的私密漏洞报告功能，而不要公开提交 issue。请参阅 SECURITY.md。

链接

• Wuniq 网站和官方下载
• 官方 MCP Registry 条目
• npm 上的 @wuniq/mcp

许可证

此仓库中的 MCP 启动器以及 Claude、Codex、Antigravity 和 Gemini CLI 封装程序均采用 MIT License 授权。Wuniq 桌面应用和 Knowledge Engine 是独立软件，不受此仓库许可证涵盖。