@bigbrain-work/mcp-connect 1.2.2 → 1.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bigbrain Work
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,80 +1,54 @@
 # @bigbrain-work/mcp-connect
 
-石榴 AI MCP 一键配置工具。用于将石榴 AI 的远程 MCP 服务接入 Codex、Claude Code 或 Cursor。
+石榴 AI 官方命令行工具。它负责验证当前凭据、配置常见 Agent、检查远程 MCP、读取实时工具清单，并为只支持 stdio 的客户端提供桥接。
 
-客户不需要指定版本号。`npx` 会从 npm 获取 `latest` 对应的最新版：
-
-## 使用
-
-先在石榴 AI 页面复制当前账户的 API Key。推荐直接运行智能一键配置，安装器会检测本机已有的 Codex、Claude Code 和 Cursor：
+## 命令
 
 ```bash
-npx -y @bigbrain-work/mcp-connect
-```
+# 微信扫码登录；令牌进入操作系统凭据库
+npx -y @bigbrain-work/mcp-connect login
 
-连接完成后，Agent 可通过同一个 MCP 地址调用 `get_openstoryline_installer`，获取 Windows 或 macOS 本地 AI 剪辑工具的短期安装地址。
+# Agent/无头环境：先创建会话并立即返回，再按返回的 poll_command 继续
+npx -y @bigbrain-work/mcp-connect login --no-wait --json
+npx -y @bigbrain-work/mcp-connect login poll --session <会话号> --wait --json
 
-也可以明确指定客户端：
-
-```bash
-npx -y @bigbrain-work/mcp-connect --agent codex
-npx -y @bigbrain-work/mcp-connect --agent claude
-npx -y @bigbrain-work/mcp-connect --agent cursor
-```
+# 自动检测并配置已安装的 Agent
+npx -y @bigbrain-work/mcp-connect install
 
-其他 Agent 也可以使用任意名称，例如：
+# 只配置一个 Agent
+npx -y @bigbrain-work/mcp-connect install --agent codex
 
-```bash
-npx -y @bigbrain-work/mcp-connect --agent openclaw
-npx -y @bigbrain-work/mcp-connect --agent workbuddy
-```
+# 检查本地配置、远程连接和 tools/list
+npx -y @bigbrain-work/mcp-connect status
 
-对于尚未内置配置适配器的 Agent，安装器不会猜测其私有配置文件，而是输出一份标准 stdio MCP 配置。该配置统一运行：
+# 显示服务实时返回的工具
+npx -y @bigbrain-work/mcp-connect tools
 
-```bash
-npx -y @bigbrain-work/mcp-connect proxy
+# 撤销刷新令牌并清除本机凭据
+npx -y @bigbrain-work/mcp-connect logout
 ```
 
-桥接器从本机安全存储读取 `SHILIU_AI_API_KEY`，再连接远程 HTTP MCP。这样 WorkBuddy、OpenClaw 以及后续其他支持 stdio MCP 的 Agent 不需要分别开发认证头适配器。支持远程 HTTP MCP 和自定义认证头的客户端仍可直接连接服务地址。
+安装后也可使用 `shiliu` 命令。原有 `mcp-connect` 命令保持兼容。
+
+`--url` 和 `--auth-url` 默认只接受石榴 AI 正式服务地址。开发者如需连接
+`127.0.0.1`、`localhost` 或 `::1` 上的测试服务，必须显式添加
+`--allow-localhost`；该开关不会放行局域网或公网第三方地址。
 
-安装器会隐藏输入 API Key。配置完成后，重启对应客户端并检查连接：
+## 通用 Agent
 
 ```bash
-npx -y @bigbrain-work/mcp-connect status
+npx -y @bigbrain-work/mcp-connect install --agent openclaw
 ```
 
-如已设置 `SHILIU_AI_API_KEY` 环境变量，安装器会直接使用该变量，不再提示输入。
-
-## 安全说明
-
-- npm 包源码中不包含任何用户 API Key。
-- Codex、Claude Code 和 Cursor 的 MCP 配置只保存环境变量引用，不保存真实 API Key。
-- Windows 上，安装器通过标准输入将 API Key 写入当前用户环境变量，避免进入终端历史和子进程命令行。
-- macOS/Linux 上，API Key 保存在权限为 `0600` 的 `~/.config/shiliu-ai/env`，并由用户登录配置加载。
-- `status` 命令只显示“已设置/未设置”，不会输出 API Key。
-- 通用 `proxy` 的 stdout 只承载 MCP 协议数据，不会输出 API Key。
+对未内置适配器的 Agent，CLI 会输出标准 stdio MCP 配置。名称只用于提示，不要求我们枚举所有 Agent。
 
-## 服务信息
+## 凭据安全
 
-- MCP 地址：`https://api.bigbrain.work/shiliu/mcp`
-- MCP 地址是 Agent 连接服务所用的完整 HTTP 接口地址，不需要另配其他域名。
-- 认证方式：`Authorization: Bearer <API_KEY>`
-- 配置名称：`shiliu_mcp`
+- 不支持 `--api-key` 参数，避免密钥进入 shell 历史。
+- 默认微信扫码后获得短期访问令牌；过期前使用可轮换刷新令牌自动更新。
+- 令牌保存在 Windows Credential Manager、macOS Keychain 或 Linux Secret Service，不写入 Agent 的 MCP 配置。
+- 登录后先以新访问令牌调用一次 `tools/list`，验证成功后才保存。
+- 非阻塞登录只把设备码暂存在系统凭据库，JSON 输出不包含设备码或访问令牌。
+- `status --json` 与 `tools --json` 不输出任何令牌。
 
-## 发布
-
-首次发布前，确认 npm 账号属于 `bigbrain-work` organization，并启用双重验证：
-
-```bash
-npm login
-npm whoami
-npm pack --dry-run
-npm publish --access public
-```
-
-后续版本先更新 `package.json` 版本号，再发布：
-
-```bash
-npm version patch
-npm publish --access public
-```
+迁移期如确需使用现有 API Key，可显式运行 `login --legacy-api-key`；此入口将在设备登录稳定后移除。

package/bin/mcp-connect.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
-import { runCli } from '../src/cli.js'
+import { runCli } from "../src/cli.js";
 
 runCli().catch((error) => {
-  console.error(`安装失败：${error.message}`)
-  process.exitCode = 1
-})
+  console.error(`错误：${error.message}`);
+  process.exitCode = 1;
+});

package/bin/shiliu.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+import { runCli } from "../src/cli.js";
+
+runCli().catch((error) => {
+  console.error(`错误：${error.message}`);
+  process.exitCode = 1;
+});

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "@bigbrain-work/mcp-connect",
-  "version": "1.2.2",
-  "description": "石榴 AI MCP 智能配置工具，支持自动检测、通用 HTTP MCP 接入和本地 AI 剪辑工具安装。",
+  "version": "1.3.0",
+  "description": "石榴 AI 官方 CLI：登录、配置 Agent、检查 MCP 状态并桥接远程工具。",
   "type": "module",
   "bin": {
-    "mcp-connect": "bin/mcp-connect.js"
+    "mcp-connect": "bin/mcp-connect.js",
+    "shiliu": "bin/shiliu.js"
   },
   "files": [
     "bin",
     "src",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
     "test": "node --test",
@@ -30,7 +32,9 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.29.0",
+    "@napi-rs/keyring": "2.0.0",
+    "qrcode": "1.5.4",
     "zod": "^3.25.0"
   },
-  "license": "UNLICENSED"
+  "license": "MIT"
 }

package/src/arguments.js

@@ -1,4 +1,15 @@
-import { parseArgs } from 'node:util'
+import { parseArgs } from "node:util";
+
+const COMMANDS = new Set([
+  "install",
+  "login",
+  "logout",
+  "status",
+  "tools",
+  "mcp",
+  "proxy",
+  "update",
+]);
 
 export function parseCliArguments(args) {
   const parsed = parseArgs({
@@ -7,49 +18,94 @@ export function parseCliArguments(args) {
     strict: true,
     options: {
       agent: {
-        type: 'string',
-        short: 'a',
+        type: "string",
+        short: "a",
       },
-      'dry-run': {
-        type: 'boolean',
+      "dry-run": {
+        type: "boolean",
         default: false,
       },
       home: {
-        type: 'string',
+        type: "string",
       },
       url: {
-        type: 'string',
+        type: "string",
+      },
+      "auth-url": {
+        type: "string",
+      },
+      "allow-localhost": {
+        type: "boolean",
+        default: false,
+      },
+      "legacy-api-key": {
+        type: "boolean",
+        default: false,
+      },
+      "no-wait": {
+        type: "boolean",
+        default: false,
+      },
+      wait: {
+        type: "boolean",
+        default: false,
+      },
+      session: {
+        type: "string",
+      },
+      json: {
+        type: "boolean",
+        default: false,
       },
       help: {
-        type: 'boolean',
-        short: 'h',
+        type: "boolean",
+        short: "h",
         default: false,
       },
       version: {
-        type: 'boolean',
-        short: 'v',
+        type: "boolean",
+        short: "v",
         default: false,
       },
     },
-  })
+  });
 
-  const command = parsed.positionals[0] || 'install'
-  if (!['install', 'proxy', 'status'].includes(command)) {
-    throw new Error(`不支持的命令：${command}`)
+  const command = parsed.positionals[0] || "install";
+  if (!COMMANDS.has(command)) {
+    throw new Error(`不支持的命令：${command}`);
+  }
+  const subcommand = parsed.positionals[1];
+  if (
+    parsed.positionals.length > 2 ||
+    (subcommand && !(command === "login" && subcommand === "poll"))
+  ) {
+    throw new Error(`无法识别的参数：${parsed.positionals.slice(1).join(" ")}`);
   }
 
-  const agent = parsed.values.agent?.toLowerCase()
+  const agent = parsed.values.agent?.toLowerCase();
   if (agent && !/^[a-z0-9][a-z0-9_-]{0,63}$/u.test(agent)) {
-    throw new Error('客户端名称只能包含小写字母、数字、下划线和连字符')
+    throw new Error("客户端名称只能包含小写字母、数字、下划线和连字符");
+  }
+  const session = parsed.values.session;
+  if (session && !/^[A-HJ-NP-Z2-9]{4}-[A-HJ-NP-Z2-9]{4}$/u.test(session)) {
+    throw new Error("登录会话编号格式无效");
   }
 
   return {
     command,
+    subcommand,
     agent,
-    dryRun: parsed.values['dry-run'],
+    dryRun: parsed.values["dry-run"],
     home: parsed.values.home,
     url: parsed.values.url,
+    authUrl: parsed.values["auth-url"],
+    allowLocalhost: parsed.values["allow-localhost"],
+    legacyApiKey: parsed.values["legacy-api-key"],
+    noWait: parsed.values["no-wait"],
+    wait: parsed.values.wait,
+    session,
+    json: parsed.values.json,
     help: parsed.values.help,
     version: parsed.values.version,
-  }
+  };
 }

package/src/authorization.js

@@ -0,0 +1,49 @@
+import { AUTH_URL } from "./constants.js";
+import { readPersistedApiKey } from "./credentials.js";
+import {
+  DeviceAuthClient,
+  normalizeTokenResponse,
+} from "./device-auth-client.js";
+import { TokenStore } from "./token-store.js";
+
+const REFRESH_WINDOW_MS = 60_000;
+
+export async function resolveAuthorization({
+  home,
+  platform = process.platform,
+  env = process.env,
+  authUrl = AUTH_URL,
+  tokenStore = new TokenStore(),
+  authClient = new DeviceAuthClient({ baseUrl: authUrl }),
+  now = Date.now,
+} = {}) {
+  let tokenSet;
+  try {
+    tokenSet = await tokenStore.load();
+  } catch (error) {
+    const legacyApiKey = readPersistedApiKey({ home, platform, env })?.trim();
+    if (legacyApiKey) {
+      return {
+        token: legacyApiKey,
+        source: "legacy_api_key",
+        warning: error.message,
+      };
+    }
+    throw error;
+  }
+  if (tokenSet) {
+    if (tokenSet.expiresAt > now() + REFRESH_WINDOW_MS) {
+      return { token: tokenSet.accessToken, source: "device" };
+    }
+    const refreshed = normalizeTokenResponse(
+      await authClient.refresh(tokenSet.refreshToken),
+      now(),
+    );
+    await tokenStore.save(refreshed);
+    return { token: refreshed.accessToken, source: "device" };
+  }
+
+  const legacyApiKey = readPersistedApiKey({ home, platform, env })?.trim();
+  if (legacyApiKey) return { token: legacyApiKey, source: "legacy_api_key" };
+  return { token: "", source: "none" };
+}