relayax-cli 0.3.48 → 0.3.49

package/dist/index.js

@@ -25,6 +25,7 @@ const access_js_1 = require("./commands/access.js");
 const grant_js_1 = require("./commands/grant.js");
 const versions_js_1 = require("./commands/versions.js");
 const diff_js_1 = require("./commands/diff.js");
+const server_js_1 = require("./mcp/server.js");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const pkg = require('../package.json');
 const program = new commander_1.Command();
@@ -56,4 +57,10 @@ program
 (0, grant_js_1.registerGrant)(program);
 (0, versions_js_1.registerVersions)(program);
 (0, diff_js_1.registerDiff)(program);
+program
+    .command('mcp')
+    .description('MCP 서버 모드로 실행합니다 (stdio transport)')
+    .action(async () => {
+    await (0, server_js_1.startMcpServer)();
+});
 program.parse();

package/dist/mcp/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createMcpServer(): McpServer;
+export declare function startMcpServer(): Promise<void>;

package/dist/mcp/server.js

@@ -0,0 +1,267 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMcpServer = createMcpServer;
+exports.startMcpServer = startMcpServer;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+const config_js_1 = require("../lib/config.js");
+const api_js_1 = require("../lib/api.js");
+const slug_js_1 = require("../lib/slug.js");
+const storage_js_1 = require("../lib/storage.js");
+const ai_tools_js_1 = require("../lib/ai-tools.js");
+const preamble_js_1 = require("../lib/preamble.js");
+const installer_js_1 = require("../lib/installer.js");
+const paths_js_1 = require("../lib/paths.js");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const pkg = require('../../package.json');
+// ─── Helpers ───
+async function resolveUsername(token) {
+    try {
+        const res = await fetch(`${config_js_1.API_URL}/api/auth/me`, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        if (!res.ok)
+            return undefined;
+        const body = await res.json();
+        return body.username;
+    }
+    catch {
+        return undefined;
+    }
+}
+function countFiles(dir) {
+    let count = 0;
+    if (!fs_1.default.existsSync(dir))
+        return 0;
+    for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.isDirectory())
+            count += countFiles(path_1.default.join(dir, entry.name));
+        else
+            count++;
+    }
+    return count;
+}
+function jsonText(obj) {
+    return { type: 'text', text: JSON.stringify(obj) };
+}
+// ─── Server ───
+function createMcpServer() {
+    const server = new mcp_js_1.McpServer({ name: 'relay', version: pkg.version }, { capabilities: { tools: {}, prompts: {} } });
+    // ═══ Tools ═══
+    server.tool('relay_search', '에이전트를 검색합니다', {
+        query: zod_1.z.string().describe('검색 키워드'),
+        tag: zod_1.z.string().optional().describe('태그 필터'),
+    }, async ({ query, tag }) => {
+        try {
+            const results = await (0, api_js_1.searchAgents)(query, tag);
+            return { content: [jsonText({ results: results.map((r) => ({ slug: r.slug, name: r.name, description: r.description, installs: r.install_count })) })] };
+        }
+        catch (err) {
+            return { content: [jsonText({ error: String(err) })], isError: true };
+        }
+    });
+    server.tool('relay_install', '에이전트를 설치합니다', {
+        slug: zod_1.z.string().describe('에이전트 slug (예: @owner/name)'),
+        project_path: zod_1.z.string().optional().describe('프로젝트 경로 (기본: cwd)'),
+    }, async ({ slug: slugInput, project_path }) => {
+        try {
+            const projectPath = project_path ?? (0, paths_js_1.resolveProjectPath)();
+            const token = await (0, config_js_1.getValidToken)();
+            const parsed = await (0, slug_js_1.resolveSlug)(slugInput);
+            const fullSlug = parsed.full;
+            const agent = await (0, api_js_1.fetchAgentInfo)(fullSlug);
+            if (!agent)
+                throw new Error('에이전트 정보를 가져오지 못했습니다.');
+            if ((agent.visibility ?? 'public') !== 'public' && !token) {
+                return { content: [jsonText({ error: 'LOGIN_REQUIRED', message: '이 에이전트는 로그인이 필요합니다.' })], isError: true };
+            }
+            const tempDir = (0, storage_js_1.makeTempDir)();
+            try {
+                const tarPath = await (0, storage_js_1.downloadPackage)(agent.package_url, tempDir);
+                const agentDir = path_1.default.join(projectPath, '.relay', 'agents', parsed.owner, parsed.name);
+                if (fs_1.default.existsSync(agentDir))
+                    fs_1.default.rmSync(agentDir, { recursive: true, force: true });
+                fs_1.default.mkdirSync(agentDir, { recursive: true });
+                await (0, storage_js_1.extractPackage)(tarPath, agentDir);
+                (0, preamble_js_1.injectPreambleToAgent)(agentDir, fullSlug);
+                const installed = (0, config_js_1.loadInstalled)();
+                installed[fullSlug] = { agent_id: agent.id, version: agent.version, installed_at: new Date().toISOString(), files: [agentDir] };
+                (0, config_js_1.saveInstalled)(installed);
+                await (0, api_js_1.reportInstall)(agent.id, fullSlug, agent.version);
+                (0, api_js_1.sendUsagePing)(agent.id, fullSlug, agent.version);
+                return { content: [jsonText({ status: 'ok', agent: agent.name, slug: fullSlug, version: agent.version, files: countFiles(agentDir), install_path: agentDir })] };
+            }
+            finally {
+                (0, storage_js_1.removeTempDir)(tempDir);
+            }
+        }
+        catch (err) {
+            return { content: [jsonText({ error: String(err) })], isError: true };
+        }
+    });
+    server.tool('relay_uninstall', '에이전트를 제거합니다', {
+        slug: zod_1.z.string().describe('에이전트 slug'),
+    }, async ({ slug: slugInput }) => {
+        try {
+            const local = (0, config_js_1.loadInstalled)();
+            const global = (0, config_js_1.loadGlobalInstalled)();
+            const entry = local[slugInput] ?? global[slugInput];
+            if (!entry) {
+                return { content: [jsonText({ error: 'NOT_INSTALLED', message: `'${slugInput}'는 설치되어 있지 않습니다.` })], isError: true };
+            }
+            let removed = 0;
+            if (local[slugInput]) {
+                removed += (0, installer_js_1.uninstallAgent)(local[slugInput].files).length;
+                delete local[slugInput];
+                (0, config_js_1.saveInstalled)(local);
+            }
+            if (global[slugInput]) {
+                removed += (0, installer_js_1.uninstallAgent)(global[slugInput].files).length;
+                delete global[slugInput];
+                (0, config_js_1.saveGlobalInstalled)(global);
+            }
+            return { content: [jsonText({ status: 'ok', removed_files: removed })] };
+        }
+        catch (err) {
+            return { content: [jsonText({ error: String(err) })], isError: true };
+        }
+    });
+    server.tool('relay_list', '설치된 에이전트 목록을 조회합니다', {}, async () => {
+        const local = (0, config_js_1.loadInstalled)();
+        const global = (0, config_js_1.loadGlobalInstalled)();
+        const agents = [
+            ...Object.entries(local).map(([slug, e]) => ({ slug, version: e.version, installed_at: e.installed_at, scope: 'local' })),
+            ...Object.entries(global).map(([slug, e]) => ({ slug, version: e.version, installed_at: e.installed_at, scope: 'global' })),
+        ];
+        return { content: [jsonText({ agents })] };
+    });
+    server.tool('relay_status', '현재 relay 환경 상태를 표시합니다', {
+        project_path: zod_1.z.string().optional().describe('프로젝트 경로'),
+    }, async ({ project_path }) => {
+        const projectPath = project_path ?? (0, paths_js_1.resolveProjectPath)();
+        const token = await (0, config_js_1.getValidToken)();
+        let username;
+        if (token)
+            username = await resolveUsername(token);
+        const detected = (0, ai_tools_js_1.detectAgentCLIs)(projectPath);
+        const mounted = (0, ai_tools_js_1.detectMountedCLIs)();
+        const relayYaml = path_1.default.join(projectPath, '.relay', 'relay.yaml');
+        let project = null;
+        if (fs_1.default.existsSync(relayYaml)) {
+            try {
+                const cfg = js_yaml_1.default.load(fs_1.default.readFileSync(relayYaml, 'utf-8'));
+                project = { is_agent: true, name: cfg.name, slug: cfg.slug, version: cfg.version };
+            }
+            catch { /* skip */ }
+        }
+        return { content: [jsonText({ login: { authenticated: !!token, username }, agent_clis: detected.map((t) => t.name), mounted_paths: mounted.map((m) => m.basePath), project })] };
+    });
+    server.tool('relay_scan', '배포 가능한 스킬/에이전트/커맨드를 스캔합니다', {
+        project_path: zod_1.z.string().optional().describe('프로젝트 경로'),
+    }, async ({ project_path }) => {
+        const projectPath = project_path ?? (0, paths_js_1.resolveProjectPath)();
+        const homeDir = (0, paths_js_1.resolveHome)();
+        const sources = [];
+        // 로컬
+        for (const tool of (0, ai_tools_js_1.detectAgentCLIs)(projectPath)) {
+            const items = (0, ai_tools_js_1.scanLocalItems)(projectPath, tool);
+            if (items.length > 0)
+                sources.push({ path: tool.skillsDir, location: 'local', name: tool.name, items: items.map((i) => ({ name: i.name, type: i.type })) });
+        }
+        // 글로벌
+        const { detectGlobalCLIs } = await import('../lib/ai-tools.js');
+        for (const tool of detectGlobalCLIs(homeDir)) {
+            const items = (0, ai_tools_js_1.scanGlobalItems)(tool, homeDir);
+            if (items.length > 0)
+                sources.push({ path: `~/${tool.skillsDir}`, location: 'global', name: `${tool.name} (global)`, items: items.map((i) => ({ name: i.name, type: i.type })) });
+        }
+        // 마운트 (Cowork)
+        for (const { tool, basePath } of (0, ai_tools_js_1.detectMountedCLIs)()) {
+            const items = (0, ai_tools_js_1.scanMountedItems)(basePath, tool);
+            if (items.length > 0)
+                sources.push({ path: `${basePath}/${tool.skillsDir}`, location: 'mounted', name: `${tool.name} (mounted)`, items: items.map((i) => ({ name: i.name, type: i.type })) });
+        }
+        return { content: [jsonText({ sources })] };
+    });
+    server.tool('relay_publish', '에이전트를 마켓플레이스에 배포합니다', {
+        project_path: zod_1.z.string().optional().describe('프로젝트 경로'),
+    }, async ({ project_path }) => {
+        const projectPath = project_path ?? (0, paths_js_1.resolveProjectPath)();
+        const relayYaml = path_1.default.join(projectPath, '.relay', 'relay.yaml');
+        if (!fs_1.default.existsSync(relayYaml)) {
+            return { content: [jsonText({ error: 'NOT_INITIALIZED', message: '.relay/relay.yaml이 없습니다. relay-publish 프롬프트를 사용하여 프로젝트를 먼저 설정하세요.' })], isError: true };
+        }
+        const token = await (0, config_js_1.getValidToken)();
+        if (!token) {
+            return { content: [jsonText({ error: 'LOGIN_REQUIRED', message: '배포하려면 로그인이 필요합니다.' })], isError: true };
+        }
+        const cfg = js_yaml_1.default.load(fs_1.default.readFileSync(relayYaml, 'utf-8'));
+        return { content: [jsonText({ status: 'ready', project_path: projectPath, name: cfg.name, slug: cfg.slug, version: cfg.version, message: '배포 준비 완료. relay-publish 프롬프트로 전체 워크플로우를 실행하세요.' })] };
+    });
+    // ═══ Prompts ═══
+    server.prompt('relay-install', '에이전트 검색 → 설치 가이드 워크플로우', {}, () => ({
+        messages: [{
+                role: 'user',
+                content: { type: 'text', text: `다음 가이드를 따라 에이전트를 설치하세요. relay MCP tool을 사용하여 각 단계를 실행합니다.
+
+사용 가능한 tool: relay_status, relay_search, relay_install, relay_list, relay_status
+
+## 워크플로우
+
+1. relay_status로 로그인 상태 확인. 미인증이면 사용자에게 터미널에서 \`npx relayax-cli login --device\` 실행을 안내.
+2. 사용자에게 어떤 에이전트를 찾는지 물어보기.
+3. relay_search로 검색.
+4. 검색 결과를 보여주고 선택하게 하기.
+5. relay_install로 설치.
+6. 설치 결과와 사용법 안내.` },
+            }],
+    }));
+    server.prompt('relay-publish', '에이전트 배포 가이드 워크플로우', {}, () => ({
+        messages: [{
+                role: 'user',
+                content: { type: 'text', text: `다음 가이드를 따라 에이전트를 배포하세요. relay MCP tool을 사용합니다.
+
+사용 가능한 tool: relay_status, relay_scan, relay_status, relay_publish
+
+## 워크플로우
+
+1. relay_status로 로그인 상태 확인. 미인증이면 터미널에서 \`npx relayax-cli login --device\` 안내.
+2. relay_scan으로 배포 가능한 스킬/에이전트/커맨드 목록 스캔.
+3. 스캔 결과를 보여주고 사용자에게 어떤 항목을 배포할지 선택하게 하기.
+4. relay_status로 프로젝트 상태 확인. .relay/relay.yaml이 없으면 프로젝트 생성 안내.
+5. relay_publish로 배포.
+6. 배포 결과를 사용자에게 보여주기.` },
+            }],
+    }));
+    server.prompt('relay-status', '환경 상태 확인', {}, () => ({
+        messages: [{
+                role: 'user',
+                content: { type: 'text', text: 'relay_status, relay_status, relay_list, relay_scan tool을 사용하여 현재 relay 환경 상태를 확인하고 사용자에게 보여주세요. 로그인 상태, 감지된 AI 도구, 프로젝트 정보, 설치된 에이전트, 배포 가능한 스킬 목록을 포함합니다.' },
+            }],
+    }));
+    server.prompt('relay-uninstall', '에이전트 제거 가이드', {}, () => ({
+        messages: [{
+                role: 'user',
+                content: { type: 'text', text: `다음 워크플로우를 따라 에이전트를 제거하세요:
+
+1. relay_list로 설치된 에이전트 목록 표시.
+2. 사용자에게 제거할 에이전트 선택하게 하기.
+3. relay_uninstall로 제거.
+4. 결과 보여주기.` },
+            }],
+    }));
+    return server;
+}
+// ─── Start ───
+async function startMcpServer() {
+    const server = createMcpServer();
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+}

package/dist/prompts/_setup-environment.md

@@ -24,7 +24,7 @@ npm install -g relayax-cli 2>/dev/null && echo "install-ok" || echo "sandbox"
 
 | 가이드 지시 | A. 터미널 | B. 샌드박스 |
 |---|---|---|
-| "relay whoami" | `relay whoami` | `npx relayax-cli whoami` |
+| "relay status" | `relay status` | `npx relayax-cli status` |
 | "relay install X" | `relay install X` | `npx relayax-cli install X` |
 | "relay publish" | `relay publish` | `npx relayax-cli publish` |
 | "relay login" | `relay login` | `npx relayax-cli login --device` |

package/dist/prompts/_setup-login.md

@@ -1,13 +1,15 @@
 ## Step 2. 로그인
 
+**중요: 로그인은 반드시 터미널(bash)에서 CLI 명령어로 수행합니다. 브라우저에서 직접 relayax.com에 접속하거나 웹 로그인 페이지를 여는 것은 올바른 방법이 아닙니다.**
+
 먼저 로그인 상태를 확인합니다. 이미 로그인되어 있으면 이 단계를 건너뛰세요.
 
-- 환경 A: `relay whoami`
-- 환경 B: `npx relayax-cli whoami`
+- 환경 A: `relay status`
+- 환경 B: `npx relayax-cli status`
 
-로그인이 필요하면 아래 방법 중 환경에 맞는 것을 사용하세요.
+로그인이 필요하면 **반드시 아래 bash 명령어를 실행**하세요.
 
-### 방법 1: 브라우저 콜백 (환경 A — 로컬 터미널)
+### 환경 A (터미널)
 
 ```bash
 relay login
@@ -18,12 +20,13 @@ relay login
 
 "✓ 로그인 완료"가 출력되면 다음 단계로 진행합니다.
 
-### 방법 2: Device Code (환경 B — 샌드박스)
+### 환경 B (샌드박스)
 
 ```bash
 npx relayax-cli login --device
 ```
 
 - 화면에 URL과 8자리 코드가 표시됩니다.
-- 표시된 URL을 브라우저에서 열고, 코드를 입력하고 로그인을 승인합니다.
+- 사용자에게 URL과 코드를 보여주세요. 사용자가 직접 브라우저에서 코드를 입력해야 합니다.
 - CLI가 자동으로 승인을 감지하고 "✓ 로그인 완료"를 출력합니다.
+- timeout이 짧으면 `--timeout 300`을 추가하세요.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "relayax-cli",
-  "version": "0.3.48",
+  "version": "0.3.49",
   "description": "RelayAX Agent Team Marketplace CLI - Install and manage agent teams",
   "main": "dist/index.js",
   "bin": {
@@ -34,6 +34,7 @@
   "homepage": "https://relayax.com",
   "dependencies": {
     "@inquirer/prompts": "^8.3.2",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "commander": "^13.1.0",
     "form-data": "^4.0.5",
     "js-yaml": "^4.1.1",