Neither MCP

neither-mcp

Neither CLI 和 MCP 服务的公开源码镜像。

Neither 是面向 Cursor、Claude Desktop 和 Claude Code 的决策记忆工具，Gemini CLI 是额外的安装入口。开始使用 / 获取工作区 API 密钥：https://www.neither.online/start/?product=dev&utm_source=plugin&utm_campaign=neither-mcp。npm 包主页使用相同的 /start URL，并带有 utm_source=npm。

安装（Node 20+）： npx -y @neitherai/mcp-server@latest — 然后在 MCP 配置中设置 NEITHER_API_KEY（Cursor mcp.json、Claude Desktop 或 Claude Code claude mcp add）。

在 Cursor 中试用 Neither

从 https://www.neither.online/start/?product=dev&utm_source=plugin&utm_campaign=neither-mcp 获取工作区密钥。

然后添加到 Cursor：

在 Cursor 本地配置密钥（替换 REPLACE_WITH_YOUR_WORKSPACE_KEY）。需要 Node.js 20+。

然后按照现有的自有项目操作指南进行操作：llms-install.md（首次使用部分）。

MCP 服务（Cursor / Claude Desktop / Claude Code）

推荐安装方式：npx -y @neitherai/mcp-server@latest

备用方式 — 将以下内容添加到 Cursor MCP 设置（mcp.json）、Claude Desktop 配置或 Claude Code 用户 MCP 配置中：

{
  "mcpServers": {
    "neither": {
      "command": "npx",
      "args": ["-y", "@neitherai/mcp-server@latest"],
      "env": {
        "NEITHER_API_KEY": "REPLACE_WITH_YOUR_WORKSPACE_KEY",
        "NEITHER_API_BASE": "https://api.neither.online"
      }
    }
  }
}

• NEITHER_API_KEY — 必需的工作区密钥
• NEITHER_API_BASE — 可选；默认为 https://api.neither.online

文档：https://www.neither.online/docs/mcp

根目录中的 Dockerfile 会构建此 stdio 服务（而非远程 HTTP 进程），以便 Glama 等主机检查 tools/list。镜像会设置一个占位用的 NEITHER_API_KEY，以便进程启动；运行时请注入真实的工作区密钥。

Agent 安装指南：llms-install.md

Claude Code（CLI）

目前 Neither 尚未列入 Claude Code 的 marketplace 卡片。使用 Claude Code 的 MCP 命令运行相同的本地 stdio 服务（Node 20+）：

claude mcp add neither -s user \
  -e NEITHER_API_KEY=sk_ctx_… \
  -e NEITHER_API_BASE=https://api.neither.online \
  -- npx -y @neitherai/mcp-server@latest

然后，claude mcp list 应显示 neither 已连接。仅将工作区密钥放在该 -e 参数或配置环境变量中（切勿放在聊天中）。重启或打开新的 Claude Code 会话，然后请求对你推送的笔记执行 memory_search（参见 llms-install.md）。

等效的 JSON 配置（如果你手动编辑 Claude Code 用户 MCP 配置）与下方的 Cursor / Claude Desktop 配置块相同。

指南：防止 Claude Code 的规则和记忆被重写或丢失（拒绝规则、PreToolUse 钩子、git，以及 /compact 后仍保留的内容）。

Claude Desktop（MCPB）

适用于 Claude Desktop 的一键本地 stdio 捆绑包。打包命令：

bash scripts/pack-mcpb.sh

该命令会将 packages/mcp-server 打包进 .mcpb，并启动 Claude 捆绑的 Node（node ${__dirname}/server/index.js）。Cursor JSON 配置仍使用 npx -y @neitherai/mcp-server@latest。

旁加载步骤、环境变量以及 Windows 和 macOS 冒烟测试清单（人工执行；不会在 CI 中运行）：DESKTOP-EXTENSION.md。

此打包方式不表示该扩展已在 Anthropic 上架或提交审核。

另请参阅 mcpb/README.md。发布 GitHub Release 时，release-assets 工作流会同时附加 .mcpb 和 Gemini CLI 压缩包。请勿移除 .mcpb。

Gemini CLI（额外安装方式）

主要经过测试的客户端仍为 Cursor 和 Claude Desktop。Gemini CLI 使用相同的 stdio 服务（gemini-extension.json 中为 npx -y @neitherai/[email protected]；Cursor JSON 使用 @latest）。这不代表 Gemini Gallery 中已有可用卡片。

gemini extensions install https://github.com/stonianua/neither-mcp

出现提示时输入 NEITHER_API_KEY（必需）。需要 Node.js 20+。设置密钥之前，MCP 会保持断开连接状态。

Gemini CLI 0.59 会将该 GitHub URL 视为 github-release 安装：它会下载自定义 Release 资源，并且只解压 .tar.gz / .zip。Release v0.1.3 除 Claude Desktop .mcpb 外，还附加了 linux.neither-mcp.tar.gz、darwin.neither-mcp.tar.gz 和 win32.neither-mcp.zip（归档根目录中包含 gemini-extension.json，npm 版本固定为 @neitherai/[email protected]）。如果 Release 中唯一的自定义资源是 .mcpb，0.59 仍会将非扩展目录树解包，然后 git clone 会因同一个非空临时目录而失败——请勿移除 .mcpb。

如果这些 Gemini 压缩包运行异常，请改为克隆 main：

gemini extensions install https://github.com/stonianua/neither-mcp --ref=main

也可以通过本地路径安装此仓库（所检出的仓库中已包含 gemini-extension.json）。

Cursor Marketplace 打包

此仓库是一个单独的 Cursor Plugin（不是多插件 marketplace）。清单遵循 cursor/plugin-template 和 Cursor Plugins 参考文档：

路径	作用
.cursor-plugin/plugin.json	Cursor Plugin 清单 + NEITHER_API_KEY 用户变量
mcp.json	本地 stdio MCP：npx -y @neitherai/mcp-server@latest

此处没有 .cursor-plugin/marketplace.json（该文件仅用于多插件仓库）。这里没有远程 MCP URL，也没有仅通过 OAuth 安装的方式。

通过 marketplace 安装后，在 Plugins → Configure 下设置 NEITHER_API_KEY（来自 quickstart 的 workspace 密钥）。PATH 中必须包含 Node 20+ 和 npx。此打包方式不表示 Neither 已在 Cursor Marketplace 上架；维护者仍需在 cursor.com/marketplace/publish 提交公开仓库，以供人工审核。

试用示例：https://github.com/stonianua/neither-demo

CLI

将本地文档推送到决策记忆（与 MCP 安装分开）：

npx -y neither@latest push <path>

Homebrew（macOS / Linuxbrew）：

brew install stonianua/neither/neither

文档：https://www.neither.online/docs/cli

软件包

已发布的 npm 软件包：

• @neitherai/mcp-server — 适用于 Cursor、Claude Desktop、Claude Code 和 Gemini CLI 的 MCP 服务
• neither — 用于将本地文档推送到决策记忆的 CLI

隐私政策

Neither 的隐私政策（收集、使用和存储、第三方共享 / 子处理方、保留期限和联系方式）发布于 https://www.neither.online/privacy/。隐私相关联系邮箱：[email protected]。支持：[email protected]。

此仓库的 MCP 服务、Claude Desktop 扩展和 Gemini CLI 扩展是一个本地 stdio 进程，并非远程 HTTPS MCP 服务。

• 收集。 你或模型提供的工具参数（搜索查询、相对于仓库的文件路径、片段 ID，以及 memory_push 的片段文本和可选来源信息）。工作区 API 密钥会作为 HTTP Bearer 令牌发送到 Neither API（NEITHER_API_BASE，默认值为 https://api.neither.online）。
• 使用和存储。 本地进程仅使用此密钥调用该 API。Claude Desktop 会将敏感的 user_config 值存储在操作系统密钥链中。Neither 按隐私政策所述存储工作区决策记忆。
• 第三方共享。 此连接器会向你配置的 Neither API 主机发送请求。Neither 的子处理方和共享规则详见隐私政策。除该 API 主机外，此连接器不会引入其他供应商。
• 保留期限。 根据隐私政策，账户处于活动状态期间会保留工作区数据；删除账户或数据后，会在 30 天内删除（备份窗口期）。本地扩展不会在磁盘上保留 API 响应的第二份副本。
• 联系。 [email protected]、[email protected] 或 GitHub issues。

问题

请在 https://github.com/stonianua/neither-mcp/issues 报告错误和功能请求。

仓库结构

路径	软件包
packages/mcp-server/	@neitherai/mcp-server
packages/cli/	neither CLI
mcpb/	Claude Desktop MCPB（打包的 Node stdio）
gemini-extension.json	Gemini CLI 扩展清单（stdio npx）
GEMINI.md	Gemini CLI 扩展上下文
DESKTOP-EXTENSION.md	构建、旁加载、环境变量、Win/macOS 冒烟测试清单
.cursor-plugin/plugin.json	Cursor 插件清单（市场打包）
mcp.json	Cursor 插件 stdio MCP 配置（npx 启动）
llms-install.md	可供 Agent 安装的简短步骤
scripts/pack-gemini-extension.sh	Gemini CLI github-release 归档（.tar.gz / .zip）

许可证：MIT（见 LICENSE）。