@bigbrain-work/mcp-connect 1.0.0 → 1.2.0

package/README.md

@@ -2,9 +2,19 @@
 
 石榴 AI MCP 一键配置工具。用于将石榴 AI 的远程 MCP 服务接入 Codex、Claude Code 或 Cursor。
 
+客户不需要指定版本号。`npx` 会从 npm 获取 `latest` 对应的最新版：
+
 ## 使用
 
-先在石榴 AI 页面复制当前账户的 API Key，然后执行对应命令：
+先在石榴 AI 页面复制当前账户的 API Key。推荐直接运行智能一键配置，安装器会检测本机已有的 Codex、Claude Code 和 Cursor：
+
+```bash
+npx -y @bigbrain-work/mcp-connect
+```
+
+连接完成后，Agent 可通过同一个 MCP 地址调用 `get_openstoryline_installer`，获取 Windows 或 macOS 本地 AI 剪辑工具的短期安装地址。
+
+也可以明确指定客户端：
 
 ```bash
 npx -y @bigbrain-work/mcp-connect --agent codex
@@ -12,6 +22,15 @@ npx -y @bigbrain-work/mcp-connect --agent claude
 npx -y @bigbrain-work/mcp-connect --agent cursor
 ```
 
+其他 Agent 也可以使用任意名称，例如：
+
+```bash
+npx -y @bigbrain-work/mcp-connect --agent openclaw
+npx -y @bigbrain-work/mcp-connect --agent workbuddy
+```
+
+对于尚未内置配置适配器的 Agent，安装器不会修改未知配置文件，而是输出石榴 AI 的通用 HTTP MCP 地址和认证方式。
+
 安装器会隐藏输入 API Key。配置完成后，重启对应客户端并检查连接：
 
 ```bash
@@ -31,6 +50,7 @@ npx -y @bigbrain-work/mcp-connect status
 ## 服务信息
 
 - MCP 地址：`https://api.bigbrain.work/shiliu/mcp`
+- MCP 地址是 Agent 连接服务所用的完整 HTTP 接口地址，不需要另配其他域名。
 - 认证方式：`Authorization: Bearer <API_KEY>`
 - 配置名称：`shiliu_mcp`
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bigbrain-work/mcp-connect",
-  "version": "1.0.0",
-  "description": "石榴 AI MCP 一键配置工具，支持 Codex、Claude Code 和 Cursor。",
+  "version": "1.2.0",
+  "description": "石榴 AI MCP 智能配置工具，支持自动检测、通用 HTTP MCP 接入和本地 AI 剪辑工具安装。",
   "type": "module",
   "bin": {
     "mcp-connect": "bin/mcp-connect.js"

package/src/arguments.js

@@ -1,7 +1,5 @@
 import { parseArgs } from 'node:util'
 
-import { SUPPORTED_AGENTS } from './constants.js'
-
 export function parseCliArguments(args) {
   const parsed = parseArgs({
     args,
@@ -38,11 +36,8 @@ export function parseCliArguments(args) {
   }
 
   const agent = parsed.values.agent?.toLowerCase()
-  if (agent && !SUPPORTED_AGENTS.includes(agent)) {
-    throw new Error(`不支持的客户端：${agent}。可选值：${SUPPORTED_AGENTS.join('、')}`)
-  }
-  if (command === 'install' && !agent && !parsed.values.help && !parsed.values.version) {
-    throw new Error('请通过 --agent 指定客户端：codex、claude 或 cursor')
+  if (agent && !/^[a-z0-9][a-z0-9_-]{0,63}$/u.test(agent)) {
+    throw new Error('客户端名称只能包含小写字母、数字、下划线和连字符')
   }
 
   return {

package/src/cli.js

@@ -3,11 +3,13 @@ import path from 'node:path'
 
 import { parseCliArguments } from './arguments.js'
 import { configureAgent } from './configurators.js'
+import { detectInstalledAgents } from './detection.js'
 import {
   API_KEY_ENV,
   MCP_URL,
   PACKAGE_NAME,
   PACKAGE_VERSION,
+  SERVER_NAME,
   SUPPORTED_AGENTS,
 } from './constants.js'
 import { persistApiKey, resolveApiKey } from './credentials.js'
@@ -17,7 +19,8 @@ function printHelp() {
   console.log(`${PACKAGE_NAME} ${PACKAGE_VERSION}
 
 用法：
-  mcp-connect --agent <${SUPPORTED_AGENTS.join('|')}>
+  mcp-connect
+  mcp-connect --agent <name>
   mcp-connect status
 
 选项：
@@ -29,7 +32,21 @@ function printHelp() {
 
 认证：
   安装器优先读取 ${API_KEY_ENV}；未设置时会隐藏提示输入。
-  真实 API Key 不会写入生成的 MCP 配置。`)
+  真实 API Key 不会写入生成的 MCP 配置。
+
+智能配置：
+  不指定 --agent 时，自动检测并配置已安装的 ${SUPPORTED_AGENTS.join('、')}。
+  其他 Agent 名称也可传入；未内置适配器时会输出通用 HTTP MCP 配置。`)
+}
+
+function printGenericInstructions(agent, { dryRun = false } = {}) {
+  console.log(`暂未内置 ${agent} 的自动配置适配器，请在该 Agent 中添加远程 HTTP MCP：
+
+名称：${SERVER_NAME}
+地址：${MCP_URL}
+认证头：Authorization: Bearer <你的石榴 AI API Key>
+
+${dryRun ? `演练模式未保存 API Key；正式运行时会安全保存到 ${API_KEY_ENV}。` : `API Key 已安全保存到 ${API_KEY_ENV}。`}请勿将真实 API Key 写入项目代码或提交到 Git。`)
 }
 
 export async function runCli(argv = process.argv.slice(2)) {
@@ -57,12 +74,28 @@ export async function runCli(argv = process.argv.slice(2)) {
     dryRun: options.dryRun,
     home,
   })
-  await configureAgent(options.agent, {
-    dryRun: options.dryRun,
-    home,
-  })
+  const requestedAgent = options.agent === 'auto' ? undefined : options.agent
+  if (requestedAgent && !SUPPORTED_AGENTS.includes(requestedAgent)) {
+    printGenericInstructions(requestedAgent, { dryRun: options.dryRun })
+    return
+  }
+
+  const agents = requestedAgent
+    ? [requestedAgent]
+    : await detectInstalledAgents({ home })
+  if (agents.length === 0) {
+    printGenericInstructions('当前客户端', { dryRun: options.dryRun })
+    return
+  }
+
+  for (const agent of agents) {
+    await configureAgent(agent, {
+      dryRun: options.dryRun,
+      home,
+    })
+  }
 
   console.log(options.dryRun
-    ? `检查完成：将为 ${options.agent} 配置 ${MCP_URL}，未写入任何文件。`
-    : `配置完成：${options.agent} 已接入石榴 AI MCP。请重启客户端后运行 ${PACKAGE_NAME} status 检查连接。`)
+    ? `检查完成：将为 ${agents.join('、')} 配置 ${MCP_URL}，未写入任何文件。`
+    : `配置完成：${agents.join('、')} 已接入石榴 AI MCP。请重启客户端后运行 ${PACKAGE_NAME} status 检查连接。`)
 }

package/src/constants.js

@@ -1,5 +1,5 @@
 export const PACKAGE_NAME = '@bigbrain-work/mcp-connect'
-export const PACKAGE_VERSION = '1.0.0'
+export const PACKAGE_VERSION = '1.2.0'
 export const SERVER_NAME = 'shiliu_mcp'
 export const MCP_URL = 'https://api.bigbrain.work/shiliu/mcp'
 export const API_KEY_ENV = 'SHILIU_AI_API_KEY'

package/src/detection.js

@@ -0,0 +1,41 @@
+import { access } from 'node:fs/promises'
+import path from 'node:path'
+import { spawnSync } from 'node:child_process'
+
+
+export function commandExists(command, spawn = spawnSync) {
+  const result = spawn(command, ['--version'], {
+    encoding: 'utf8',
+    windowsHide: true,
+    shell: false,
+    timeout: 5000,
+  })
+  return !result.error && result.status === 0
+}
+
+async function pathExists(targetPath) {
+  try {
+    await access(targetPath)
+    return true
+  } catch {
+    return false
+  }
+}
+
+export async function detectInstalledAgents({
+  home,
+  hasCommand = commandExists,
+  exists = pathExists,
+} = {}) {
+  const agents = []
+  if (hasCommand('codex')) {
+    agents.push('codex')
+  }
+  if (hasCommand('claude')) {
+    agents.push('claude')
+  }
+  if (hasCommand('cursor') || await exists(path.join(home, '.cursor'))) {
+    agents.push('cursor')
+  }
+  return agents
+}