agent2agent-cli 0.3.3 → 0.3.5

package/a2a-mcp.js

@@ -24,7 +24,7 @@ const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
 
-const VERSION = '0.3.3';
+const VERSION = '0.3.5';
 const PROTOCOL_VERSION = '2024-11-05'; // MCP 当前稳定协议版本
 
 /* ------------------------------------------------------------------ *
@@ -357,12 +357,29 @@ async function apiText(config, pathName) {
 /* ------------------------------------------------------------------ *
  * MCP stdio 传输（换行分隔 JSON-RPC 2.0）
  * ------------------------------------------------------------------ */
+// 兼容的 MCP 协议版本（Cursor 可能请求较新版本，回显客户端请求值）
+const KNOWN_PROTOCOLS = ['2024-11-05', '2025-03-26', '2025-06-18'];
+
+/* 崩溃兜底：任何未捕获异常/拒绝都打印真实堆栈到 stderr（Cursor 会显示出来），便于定位 */
+process.on('uncaughtException', (err) => {
+  console.error('[a2a-mcp] uncaughtException:', err && err.stack ? err.stack : err);
+  process.exit(1);
+});
+process.on('unhandledRejection', (err) => {
+  console.error('[a2a-mcp] unhandledRejection:', err && err.stack ? err.stack : err);
+  process.exit(1);
+});
+
 function main() {
+  // 找不到配置不再退出：server 照常启动（tools 可用），调用工具时才给出明确指引
   const config = resolveConfig();
-  if (!config.url) {
-    console.error('[a2a-mcp] 未找到平台配置：请在项目根运行（含 .a2a.json），或设置 A2A_URL / A2A_TOKEN / A2A_ACCOUNT');
-    console.error('[a2a-mcp] 首次接入：a2a init');
-    process.exit(1);
+  const cfgMissing = !config.url;
+  if (cfgMissing) {
+    console.error(`[a2a-mcp v${VERSION}] 当前工作目录: ${process.cwd()}`);
+    console.error('[a2a-mcp] 未找到平台配置（.a2a.json）：请在含 .a2a.json 的项目目录使用；');
+    console.error('[a2a-mcp] 或设置 A2A_URL / A2A_TOKEN / A2A_ACCOUNT 环境变量；首次接入：a2a init');
+  } else {
+    console.error(`[a2a-mcp v${VERSION}] 已加载配置: ${config.url}（账号: ${config.accountId || '?'}）`);
   }
 
   const rl = readline.createInterface({ input: process.stdin, crlfDelay: Infinity });
@@ -397,14 +414,18 @@ function main() {
       err && err.message ? err.message : String(err));
 
     switch (method) {
-      case 'initialize':
+      case 'initialize': {
         serverReady = true;
+        // 协议版本协商：回显客户端请求的已知版本，避免较新客户端不兼容
+        const reqVer = params && params.protocolVersion;
+        const ver = KNOWN_PROTOCOLS.includes(reqVer) ? reqVer : PROTOCOL_VERSION;
         finish({
-          protocolVersion: PROTOCOL_VERSION,
+          protocolVersion: ver,
           capabilities: { tools: { listChanged: false } },
           serverInfo: { name: 'a2a-mcp', version: VERSION },
         });
         break;
+      }
       case 'ping':
         finish({});
         break;
@@ -413,6 +434,11 @@ function main() {
         break;
       case 'tools/call': {
         const { name, arguments: args } = params || {};
+        if (cfgMissing) {
+          const errText = '平台未配置：请在含 .a2a.json 的项目目录使用本 MCP（Cursor 的项目级 .cursor/mcp.json 会把工作目录设为项目根），或设置 A2A_URL/A2A_TOKEN/A2A_ACCOUNT 环境变量。首次接入运行 a2a init。';
+          finish({ isError: true, content: [{ type: 'text', text: errText }] });
+          break;
+        }
         callTool(config, name, args || {})
           .then((result) => {
             const text = typeof result === 'string' ? result : JSON.stringify(result, null, 2);

package/a2a.js

@@ -1371,6 +1371,29 @@ async function cmdHeartbeat(opts, ctx) {
   );
 }
 
+/** `a2a mcp-setup`：在当前项目生成 .cursor/mcp.json（Cursor/Windsurf 用），使用绝对路径免 PATH 问题 */
+async function cmdMcpSetup() {
+  const nodePath = process.execPath; // 当前 node 绝对路径（避免 Cursor 环境 PATH 无 node/nvm）
+  const mcpPath = path.join(__dirname, 'a2a-mcp.js');
+  if (!fs.existsSync(mcpPath)) {
+    fail('未找到 a2a-mcp.js（' + mcpPath + '）。请使用 npm 全局安装：npm install -g agent2agent-cli');
+  }
+  const config = {
+    mcpServers: {
+      a2a: { command: nodePath, args: [mcpPath] },
+    },
+  };
+  const dir = path.join(process.cwd(), '.cursor');
+  fs.mkdirSync(dir, { recursive: true });
+  const target = path.join(dir, 'mcp.json');
+  fs.writeFileSync(target, JSON.stringify(config, null, 2) + '\n');
+  console.log(paint(C.green, `已生成 ${target}`));
+  console.log('  server: a2a（command=' + nodePath + '）');
+  console.log('说明：该配置随项目提交，团队 clone 后无需再配；');
+  console.log('      请在当前项目（含 .a2a.json）使用，a2a-mcp 会自动匹配该项目账号。');
+  console.log('重启 Cursor 后生效（MCP 面板应显示 13 个工具）。');
+}
+
 /* ------------------------------------------------------------------------- *
  * 帮助
  * ------------------------------------------------------------------------- */
@@ -1397,6 +1420,7 @@ function printHelp() {
     ['sync', '双向镜像同步本地 doc 目录 ↔ 平台'],
     ['memory', '记忆（get / set）'],
     ['heartbeat', '心跳'],
+    ['mcp-setup', '生成 .cursor/mcp.json（Cursor/Windsurf MCP 接入）'],
     ['update-check', '检查各组件是否有新版本'],
     ['update', '一键更新 CLI + skills'],
     ['update-skills', '更新已安装的 skills（--to 指定目录 / --yes 免确认）'],
@@ -1491,6 +1515,10 @@ async function main() {
     await cmdUpdate(opts);
     return;
   }
+  if (cmd === 'mcp-setup') {
+    await cmdMcpSetup();
+    return;
+  }
   if (cmd === 'update-check') {
     // 有 .a2a.json 则附带平台版本对比；无配置只检查 CLI / skills
     let cfg = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent2agent-cli",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Agent2Agent 统一 CLI（命令名 a2a）：跨 AI 编程代理协作平台的命令行客户端 — 异步消息、任务看板、文档双向同步、持久记忆",
   "bin": {
     "a2a": "a2a.js",