cokit-cli 1.0.8 → 1.2.0

package/skills/ck-mcp-management/references/gemini-cli-integration.md

@@ -1,215 +0,0 @@
-# Gemini CLI Integration Guide
-
-## ⚠️ CRITICAL: Use Stdin Piping, NOT -p Flag
-
-The `-p` flag is **deprecated** and skips MCP server initialization, causing tools to be unavailable:
-
-```bash
-# ❌ WRONG - This skips MCP connections!
-gemini -y -m gemini-2.5-flash -p "Take a screenshot"
-
-# ✅ CORRECT - This initializes MCP servers
-echo "Take a screenshot" | gemini -y -m gemini-2.5-flash
-```
-
-**Why**: The `-p` flag runs in "quick mode" and bypasses MCP server connection initialization. Always use stdin piping (echo + pipe) to ensure MCP tools are available.
-
-## Overview
-
-Gemini CLI provides automatic MCP tool discovery and execution via natural language prompts. This is the recommended primary method for executing MCP tools.
-
-## Installation
-
-```bash
-npm install -g gemini-cli
-```
-
-Verify installation:
-```bash
-gemini --version
-```
-
-## Configuration
-
-### Symlink Setup
-
-Gemini CLI reads MCP servers from `.gemini/settings.json`. Create a symlink to `%USERPROFILE%/.claude/.mcp.json`:
-
-```bash
-# Create .gemini directory
-mkdir -p .gemini
-
-# Create symlink (Unix/Linux/macOS)
-ln -sf %USERPROFILE%/.claude/.mcp.json .gemini/settings.json
-
-# Create symlink (Windows - requires admin or developer mode)
-mklink .gemini\settings.json .claude\.mcp.json
-```
-
-### Security
-
-Add to `.gitignore`:
-```
-.gemini/settings.json
-```
-
-This prevents committing sensitive API keys and server configurations.
-
-## Usage
-
-### Basic Syntax
-
-```bash
-# IMPORTANT: Use stdin piping, NOT -p flag (deprecated, skips MCP init)
-echo "<prompt>" | gemini [flags]
-```
-
-### Essential Flags
-
-- `-y`: Skip confirmation prompts (auto-approve tool execution)
-- `-m <model>`: Model selection
-  - `gemini-2.5-flash` (fast, recommended for MCP)
-  - `gemini-2.5-flash` (balanced)
-  - `gemini-pro` (high quality)
-
-### Examples
-
-**Screenshot Capture**:
-```bash
-echo "Take a screenshot of https://www.google.com.vn" | gemini -y -m gemini-2.5-flash
-```
-
-**Memory Operations**:
-```bash
-echo "Remember that Alice is a React developer working on e-commerce projects" | gemini -y -m gemini-2.5-flash
-```
-
-**Web Research**:
-```bash
-echo "Search for latest Next.js 15 features and summarize the top 3" | gemini -y -m gemini-2.5-flash
-```
-
-**Multi-Tool Orchestration**:
-```bash
-echo "Search for Claude AI documentation, take a screenshot of the homepage, and save both to memory" | gemini -y -m gemini-2.5-flash
-```
-
-**Browser Automation**:
-```bash
-echo "Navigate to https://example.com, click the signup button, and take a screenshot" | gemini -y -m gemini-2.5-flash
-```
-
-## How It Works
-
-1. **Configuration Loading**: Reads `.gemini/settings.json` (symlinked to `%USERPROFILE%/.claude/.mcp.json`)
-2. **Server Connection**: Connects to all configured MCP servers
-3. **Tool Discovery**: Lists all available tools from servers
-4. **Prompt Analysis**: Gemini model analyzes the prompt
-5. **Tool Selection**: Automatically selects relevant tools
-6. **Execution**: Calls tools with appropriate parameters
-7. **Result Synthesis**: Combines tool outputs into coherent response
-
-## Advanced Configuration
-
-### Trusted Servers (Skip Confirmations)
-
-Edit `%USERPROFILE%/.claude/.mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "memory": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-memory"],
-      "trust": true
-    }
-  }
-}
-```
-
-With `trust: true`, the `-y` flag is unnecessary.
-
-### Tool Filtering
-
-Limit tool exposure:
-
-```json
-{
-  "mcpServers": {
-    "chrome-devtools": {
-      "command": "npx",
-      "args": ["-y", "chrome-devtools-mcp@latest"],
-      "includeTools": ["navigate_page", "screenshot"],
-      "excludeTools": ["evaluate_js"]
-    }
-  }
-}
-```
-
-### Environment Variables
-
-Use `$VAR_NAME` syntax for sensitive data:
-
-```json
-{
-  "mcpServers": {
-    "brave-search": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
-      "env": {
-        "BRAVE_API_KEY": "$BRAVE_API_KEY"
-      }
-    }
-  }
-}
-```
-
-## Troubleshooting
-
-### Check MCP Status
-
-```bash
-gemini
-> /mcp
-```
-
-Shows:
-- Connected servers
-- Available tools
-- Configuration errors
-
-### Verify Symlink
-
-```bash
-# Unix/Linux/macOS
-ls -la .gemini/settings.json
-
-# Windows
-dir .gemini\settings.json
-```
-
-Should show symlink pointing to `%USERPROFILE%/.claude/.mcp.json`.
-
-### Debug Mode
-
-```bash
-echo "Take a screenshot" | gemini --debug
-```
-
-Shows detailed MCP communication logs.
-
-## Comparison with Alternatives
-
-| Method | Speed | Flexibility | Setup | Best For |
-|--------|-------|-------------|-------|----------|
-| Gemini CLI | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ | All tasks |
-| Direct Scripts | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | Specific tools |
-| mcp-manager | ⭐ | ⭐⭐ | ⭐⭐⭐ | Fallback |
-
-**Recommendation**: Use Gemini CLI as primary method, fallback to scripts/subagent when unavailable.
-
-## Resources
-
-- [Gemini CLI Documentation](https://geminicli.com/docs)
-- [MCP Server Configuration](https://geminicli.com/docs/tools/mcp-server)
-- [Tool Reference](https://geminicli.com/docs/tools/mcp-server/#tool-interaction)

package/skills/ck-mcp-management/scripts/dist/mcp-client.js

@@ -1,183 +0,0 @@
-#!/usr/bin/env node
-/**
- * MCP Client - Core client for interacting with MCP servers
- */
-import { Client } from '@modelcontextprotocol/sdk/client/index.js';
-import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
-import { readFile } from 'fs/promises';
-import { resolve } from 'path';
-export class MCPClientManager {
-    config = null;
-    clients = new Map();
-    transports = new Map();
-    async loadConfig(configPath = '%USERPROFILE%/.claude/.mcp.json') {
-        const fullPath = resolve(process.cwd(), configPath);
-        const content = await readFile(fullPath, 'utf-8');
-        const config = JSON.parse(content);
-        this.config = config;
-        return config;
-    }
-    async connectToServer(serverName) {
-        if (!this.config?.mcpServers[serverName]) {
-            throw new Error(`Server ${serverName} not found in config`);
-        }
-        const serverConfig = this.config.mcpServers[serverName];
-        const transport = new StdioClientTransport({
-            command: serverConfig.command,
-            args: serverConfig.args,
-            env: serverConfig.env
-        });
-        const client = new Client({
-            name: `mcp-manager-${serverName}`,
-            version: '1.0.0'
-        }, { capabilities: {} });
-        await client.connect(transport);
-        this.clients.set(serverName, client);
-        this.transports.set(serverName, transport); // Track transport!
-        return client;
-    }
-    async connectAll() {
-        if (!this.config) {
-            throw new Error('Config not loaded. Call loadConfig() first.');
-        }
-        const serverNames = Object.keys(this.config.mcpServers);
-        console.log(`Connecting to ${serverNames.length} servers sequentially...`);
-        for (const serverName of serverNames) {
-            try {
-                await this.connectToServer(serverName);
-                console.log(`✓ ${serverName} connected`);
-            }
-            catch (error) {
-                console.error(`✗ ${serverName} failed:`, error);
-                // Continue with other servers
-            }
-        }
-    }
-    async getAllTools() {
-        const allTools = [];
-        for (const [serverName, client] of this.clients.entries()) {
-            try {
-                const response = await client.listTools({}, { timeout: 300000 });
-                for (const tool of response.tools) {
-                    allTools.push({
-                        serverName,
-                        name: tool.name,
-                        description: tool.description || '',
-                        inputSchema: tool.inputSchema,
-                        outputSchema: tool.outputSchema
-                    });
-                }
-            }
-            catch (error) {
-                if (error?.code === -32601) {
-                    console.warn(`${serverName} does not support listTools`);
-                }
-                else {
-                    console.error(`Error from ${serverName}:`, error);
-                }
-                // Continue with other servers!
-            }
-        }
-        return allTools;
-    }
-    async getAllPrompts() {
-        const allPrompts = [];
-        for (const [serverName, client] of this.clients.entries()) {
-            try {
-                const response = await client.listPrompts({}, { timeout: 300000 });
-                for (const prompt of response.prompts) {
-                    allPrompts.push({
-                        serverName,
-                        name: prompt.name,
-                        description: prompt.description || '',
-                        arguments: prompt.arguments
-                    });
-                }
-            }
-            catch (error) {
-                if (error?.code === -32601) {
-                    console.warn(`${serverName} does not support listPrompts`);
-                }
-                else {
-                    console.error(`Error from ${serverName}:`, error);
-                }
-                // Continue with other servers!
-            }
-        }
-        return allPrompts;
-    }
-    async getAllResources() {
-        const allResources = [];
-        for (const [serverName, client] of this.clients.entries()) {
-            try {
-                const response = await client.listResources({}, { timeout: 300000 });
-                for (const resource of response.resources) {
-                    allResources.push({
-                        serverName,
-                        uri: resource.uri,
-                        name: resource.name,
-                        description: resource.description,
-                        mimeType: resource.mimeType
-                    });
-                }
-            }
-            catch (error) {
-                if (error?.code === -32601) {
-                    console.warn(`${serverName} does not support listResources`);
-                }
-                else {
-                    console.error(`Error from ${serverName}:`, error);
-                }
-                // Continue with other servers!
-            }
-        }
-        return allResources;
-    }
-    async callTool(serverName, toolName, args) {
-        const client = this.clients.get(serverName);
-        if (!client)
-            throw new Error(`Not connected to server: ${serverName}`);
-        return await client.callTool({ name: toolName, arguments: args }, undefined, { timeout: 300000 });
-    }
-    async getPrompt(serverName, promptName, args) {
-        const client = this.clients.get(serverName);
-        if (!client)
-            throw new Error(`Not connected to server: ${serverName}`);
-        return await client.getPrompt({ name: promptName, arguments: args }, { timeout: 300000 });
-    }
-    async readResource(serverName, uri) {
-        const client = this.clients.get(serverName);
-        if (!client)
-            throw new Error(`Not connected to server: ${serverName}`);
-        return await client.readResource({ uri }, { timeout: 300000 });
-    }
-    async cleanup() {
-        // Close clients with timeout
-        const cleanupPromises = [];
-        for (const [serverName, client] of this.clients.entries()) {
-            cleanupPromises.push((async () => {
-                try {
-                    await client.close();
-                }
-                catch (error) {
-                    console.warn(`Warning closing ${serverName}:`, error);
-                }
-            })());
-        }
-        await Promise.race([
-            Promise.all(cleanupPromises),
-            new Promise((resolve) => setTimeout(resolve, 5000))
-        ]);
-        // CRITICAL: Close transports to kill subprocesses
-        for (const [serverName, transport] of this.transports.entries()) {
-            try {
-                await transport.close();
-            }
-            catch (error) {
-                console.warn(`Warning closing ${serverName} transport:`, error);
-            }
-        }
-        this.clients.clear();
-        this.transports.clear();
-    }
-}

package/skills/ck-mcp-management/scripts/mcp-client.ts

@@ -1,230 +0,0 @@
-#!/usr/bin/env node
-/**
- * MCP Client - Core client for interacting with MCP servers
- */
-
-import { Client } from '@modelcontextprotocol/sdk/client/index.js';
-import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
-import { readFile } from 'fs/promises';
-import { resolve } from 'path';
-
-interface MCPConfig {
-  mcpServers: {
-    [key: string]: {
-      command: string;
-      args: string[];
-      env?: Record<string, string>;
-    };
-  };
-}
-
-interface ToolInfo {
-  serverName: string;
-  name: string;
-  description: string;
-  inputSchema: any;
-  outputSchema?: any;
-}
-
-interface PromptInfo {
-  serverName: string;
-  name: string;
-  description: string;
-  arguments?: any[];
-}
-
-interface ResourceInfo {
-  serverName: string;
-  uri: string;
-  name: string;
-  description?: string;
-  mimeType?: string;
-}
-
-export class MCPClientManager {
-  private config: MCPConfig | null = null;
-  private clients: Map<string, Client> = new Map();
-  private transports: Map<string, StdioClientTransport> = new Map();
-
-  async loadConfig(configPath: string = '%USERPROFILE%/.claude/.mcp.json'): Promise<MCPConfig> {
-    const fullPath = resolve(process.cwd(), configPath);
-    const content = await readFile(fullPath, 'utf-8');
-    const config = JSON.parse(content) as MCPConfig;
-    this.config = config;
-    return config;
-  }
-
-  async connectToServer(serverName: string): Promise<Client> {
-    if (!this.config?.mcpServers[serverName]) {
-      throw new Error(`Server ${serverName} not found in config`);
-    }
-
-    const serverConfig = this.config.mcpServers[serverName];
-    const transport = new StdioClientTransport({
-      command: serverConfig.command,
-      args: serverConfig.args,
-      env: serverConfig.env
-    });
-
-    const client = new Client({
-      name: `mcp-manager-${serverName}`,
-      version: '1.0.0'
-    }, { capabilities: {} });
-
-    await client.connect(transport);
-    this.clients.set(serverName, client);
-    this.transports.set(serverName, transport); // Track transport!
-    return client;
-  }
-
-  async connectAll(): Promise<void> {
-    if (!this.config) {
-      throw new Error('Config not loaded. Call loadConfig() first.');
-    }
-
-    const serverNames = Object.keys(this.config.mcpServers);
-    console.log(`Connecting to ${serverNames.length} servers sequentially...`);
-
-    for (const serverName of serverNames) {
-      try {
-        await this.connectToServer(serverName);
-        console.log(`✓ ${serverName} connected`);
-      } catch (error) {
-        console.error(`✗ ${serverName} failed:`, error);
-        // Continue with other servers
-      }
-    }
-  }
-
-  async getAllTools(): Promise<ToolInfo[]> {
-    const allTools: ToolInfo[] = [];
-    for (const [serverName, client] of this.clients.entries()) {
-      try {
-        const response = await client.listTools({}, { timeout: 300000 });
-        for (const tool of response.tools) {
-          allTools.push({
-            serverName,
-            name: tool.name,
-            description: tool.description || '',
-            inputSchema: tool.inputSchema,
-            outputSchema: (tool as any).outputSchema
-          });
-        }
-      } catch (error: any) {
-        if (error?.code === -32601) {
-          console.warn(`${serverName} does not support listTools`);
-        } else {
-          console.error(`Error from ${serverName}:`, error);
-        }
-        // Continue with other servers!
-      }
-    }
-    return allTools;
-  }
-
-  async getAllPrompts(): Promise<PromptInfo[]> {
-    const allPrompts: PromptInfo[] = [];
-    for (const [serverName, client] of this.clients.entries()) {
-      try {
-        const response = await client.listPrompts({}, { timeout: 300000 });
-        for (const prompt of response.prompts) {
-          allPrompts.push({
-            serverName,
-            name: prompt.name,
-            description: prompt.description || '',
-            arguments: prompt.arguments
-          });
-        }
-      } catch (error: any) {
-        if (error?.code === -32601) {
-          console.warn(`${serverName} does not support listPrompts`);
-        } else {
-          console.error(`Error from ${serverName}:`, error);
-        }
-        // Continue with other servers!
-      }
-    }
-    return allPrompts;
-  }
-
-  async getAllResources(): Promise<ResourceInfo[]> {
-    const allResources: ResourceInfo[] = [];
-    for (const [serverName, client] of this.clients.entries()) {
-      try {
-        const response = await client.listResources({}, { timeout: 300000 });
-        for (const resource of response.resources) {
-          allResources.push({
-            serverName,
-            uri: resource.uri,
-            name: resource.name,
-            description: resource.description,
-            mimeType: resource.mimeType
-          });
-        }
-      } catch (error: any) {
-        if (error?.code === -32601) {
-          console.warn(`${serverName} does not support listResources`);
-        } else {
-          console.error(`Error from ${serverName}:`, error);
-        }
-        // Continue with other servers!
-      }
-    }
-    return allResources;
-  }
-
-  async callTool(serverName: string, toolName: string, args: any): Promise<any> {
-    const client = this.clients.get(serverName);
-    if (!client) throw new Error(`Not connected to server: ${serverName}`);
-    return await client.callTool(
-      { name: toolName, arguments: args },
-      undefined,
-      { timeout: 300000 }
-    );
-  }
-
-  async getPrompt(serverName: string, promptName: string, args?: any): Promise<any> {
-    const client = this.clients.get(serverName);
-    if (!client) throw new Error(`Not connected to server: ${serverName}`);
-    return await client.getPrompt({ name: promptName, arguments: args }, { timeout: 300000 });
-  }
-
-  async readResource(serverName: string, uri: string): Promise<any> {
-    const client = this.clients.get(serverName);
-    if (!client) throw new Error(`Not connected to server: ${serverName}`);
-    return await client.readResource({ uri }, { timeout: 300000 });
-  }
-
-  async cleanup(): Promise<void> {
-    // Close clients with timeout
-    const cleanupPromises: Promise<void>[] = [];
-    for (const [serverName, client] of this.clients.entries()) {
-      cleanupPromises.push(
-        (async () => {
-          try {
-            await client.close();
-          } catch (error) {
-            console.warn(`Warning closing ${serverName}:`, error);
-          }
-        })()
-      );
-    }
-
-    await Promise.race([
-      Promise.all(cleanupPromises),
-      new Promise<void>((resolve) => setTimeout(resolve, 5000))
-    ]);
-
-    // CRITICAL: Close transports to kill subprocesses
-    for (const [serverName, transport] of this.transports.entries()) {
-      try {
-        await transport.close();
-      } catch (error) {
-        console.warn(`Warning closing ${serverName} transport:`, error);
-      }
-    }
-
-    this.clients.clear();
-    this.transports.clear();
-  }
-}