@vodailoc/kilo-kit-mcp 1.1.0 → 1.2.0

package/skills/operations/mcp-management/references/mcp-protocol.md

@@ -1,116 +1,116 @@
-# Model Context Protocol (MCP) Reference
-
-## Protocol Overview
-
-MCP is JSON-RPC 2.0 based protocol for AI-tool integration.
-
-**Version**: 2025-03-26
-**Foundation**: JSON-RPC 2.0
-**Architecture**: Client-Host-Server
-
-## Connection Lifecycle
-
-1. **Initialize**: Client sends `initialize` request with capabilities
-2. **Response**: Server responds with its capabilities
-3. **Handshake**: Client sends `notifications/initialized`
-4. **Active**: Bidirectional messaging
-5. **Shutdown**: Close connections, cleanup
-
-## Core Capabilities
-
-### Tools (Executable Functions)
-
-Tools are functions that servers expose for execution.
-
-**List Tools**:
-```json
-{"method": "tools/list"}
-```
-
-**Call Tool**:
-```json
-{
-  "method": "tools/call",
-  "params": {
-    "name": "tool_name",
-    "arguments": {}
-  }
-}
-```
-
-### Prompts (Interaction Templates)
-
-Prompts are reusable templates for LLM interactions.
-
-**List Prompts**:
-```json
-{"method": "prompts/list"}
-```
-
-**Get Prompt**:
-```json
-{
-  "method": "prompts/get",
-  "params": {
-    "name": "prompt_name",
-    "arguments": {}
-  }
-}
-```
-
-### Resources (Data Sources)
-
-Resources expose read-only data to clients.
-
-**List Resources**:
-```json
-{"method": "resources/list"}
-```
-
-**Read Resource**:
-```json
-{
-  "method": "resources/read",
-  "params": {"uri": "resource://path"}
-}
-```
-
-## Transport Types
-
-### stdio (Local)
-
-Server runs as subprocess. Messages via stdin/stdout.
-
-```typescript
-const transport = new StdioClientTransport({
-  command: 'node',
-  args: ['server.js']
-});
-```
-
-### HTTP+SSE (Remote)
-
-POST for requests, GET for server events.
-
-```typescript
-const transport = new StreamableHTTPClientTransport({
-  url: 'http://localhost:3000/mcp'
-});
-```
-
-## Error Codes
-
-- **-32700**: Parse error
-- **-32600**: Invalid request
-- **-32601**: Method not found
-- **-32602**: Invalid params
-- **-32603**: Internal error
-- **-32002**: Resource not found (MCP-specific)
-
-## Best Practices
-
-1. **Progressive Disclosure**: Load tool definitions on-demand
-2. **Context Efficiency**: Filter data before returning
-3. **Security**: Validate inputs, sanitize outputs
-4. **Resource Management**: Cleanup connections properly
-5. **Error Handling**: Handle all error cases gracefully
+# Model Context Protocol (MCP) Reference
+
+## Protocol Overview
+
+MCP is JSON-RPC 2.0 based protocol for AI-tool integration.
+
+**Version**: 2025-03-26
+**Foundation**: JSON-RPC 2.0
+**Architecture**: Client-Host-Server
+
+## Connection Lifecycle
+
+1. **Initialize**: Client sends `initialize` request with capabilities
+2. **Response**: Server responds with its capabilities
+3. **Handshake**: Client sends `notifications/initialized`
+4. **Active**: Bidirectional messaging
+5. **Shutdown**: Close connections, cleanup
+
+## Core Capabilities
+
+### Tools (Executable Functions)
+
+Tools are functions that servers expose for execution.
+
+**List Tools**:
+```json
+{"method": "tools/list"}
+```
+
+**Call Tool**:
+```json
+{
+  "method": "tools/call",
+  "params": {
+    "name": "tool_name",
+    "arguments": {}
+  }
+}
+```
+
+### Prompts (Interaction Templates)
+
+Prompts are reusable templates for LLM interactions.
+
+**List Prompts**:
+```json
+{"method": "prompts/list"}
+```
+
+**Get Prompt**:
+```json
+{
+  "method": "prompts/get",
+  "params": {
+    "name": "prompt_name",
+    "arguments": {}
+  }
+}
+```
+
+### Resources (Data Sources)
+
+Resources expose read-only data to clients.
+
+**List Resources**:
+```json
+{"method": "resources/list"}
+```
+
+**Read Resource**:
+```json
+{
+  "method": "resources/read",
+  "params": {"uri": "resource://path"}
+}
+```
+
+## Transport Types
+
+### stdio (Local)
+
+Server runs as subprocess. Messages via stdin/stdout.
+
+```typescript
+const transport = new StdioClientTransport({
+  command: 'node',
+  args: ['server.js']
+});
+```
+
+### HTTP+SSE (Remote)
+
+POST for requests, GET for server events.
+
+```typescript
+const transport = new StreamableHTTPClientTransport({
+  url: 'http://localhost:3000/mcp'
+});
+```
+
+## Error Codes
+
+- **-32700**: Parse error
+- **-32600**: Invalid request
+- **-32601**: Method not found
+- **-32602**: Invalid params
+- **-32603**: Internal error
+- **-32002**: Resource not found (MCP-specific)
+
+## Best Practices
+
+1. **Progressive Disclosure**: Load tool definitions on-demand
+2. **Context Efficiency**: Filter data before returning
+3. **Security**: Validate inputs, sanitize outputs
+4. **Resource Management**: Cleanup connections properly
+5. **Error Handling**: Handle all error cases gracefully

package/skills/operations/mcp-management/scripts/.env.example

@@ -1,10 +1,10 @@
-# MCP Management Scripts Environment Variables
-
-# Path to MCP configuration file (optional, defaults to .claude/.mcp.json)
-MCP_CONFIG_PATH=.claude/.mcp.json
-
-# Logging level (optional, defaults to info)
-LOG_LEVEL=info
-
-# Enable debug mode (optional, defaults to false)
-DEBUG=false
+# MCP Management Scripts Environment Variables
+
+# Path to MCP configuration file (optional, defaults to .claude/.mcp.json)
+MCP_CONFIG_PATH=.claude/.mcp.json
+
+# Logging level (optional, defaults to info)
+LOG_LEVEL=info
+
+# Enable debug mode (optional, defaults to false)
+DEBUG=false

package/skills/operations/mcp-management/scripts/cli.ts

@@ -1,155 +1,155 @@
-#!/usr/bin/env node
-/**
- * MCP Management CLI - Command-line interface for MCP operations
- */
-
-import { MCPClientManager } from './mcp-client.js';
-import { writeFileSync, mkdirSync } from 'fs';
-import { dirname, join } from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-async function main() {
-  const args = process.argv.slice(2);
-  const command = args[0];
-
-  const manager = new MCPClientManager();
-
-  try {
-    // Load config
-    await manager.loadConfig();
-    console.log('✓ Config loaded');
-
-    // Connect to all servers
-    await manager.connectAll();
-    console.log('✓ Connected to all MCP servers\n');
-
-    switch (command) {
-      case 'list-tools':
-        await listTools(manager);
-        break;
-
-      case 'list-prompts':
-        await listPrompts(manager);
-        break;
-
-      case 'list-resources':
-        await listResources(manager);
-        break;
-
-      case 'call-tool':
-        await callTool(manager, args[1], args[2], args[3]);
-        break;
-
-      default:
-        printUsage();
-    }
-
-    await manager.cleanup();
-  } catch (error) {
-    console.error('Error:', error);
-    process.exit(1);
-  }
-}
-
-async function listTools(manager: MCPClientManager) {
-  const tools = await manager.getAllTools();
-  console.log(`Found ${tools.length} tools:\n`);
-
-  for (const tool of tools) {
-    console.log(`📦 ${tool.serverName} / ${tool.name}`);
-    console.log(`   ${tool.description}`);
-    if (tool.inputSchema?.properties) {
-      console.log(`   Parameters: ${Object.keys(tool.inputSchema.properties).join(', ')}`);
-    }
-    console.log('');
-  }
-
-  // Save tools to JSON file
-  const assetsDir = join(__dirname, '..', 'assets');
-  const toolsPath = join(assetsDir, 'tools.json');
-
-  try {
-    mkdirSync(assetsDir, { recursive: true });
-    writeFileSync(toolsPath, JSON.stringify(tools, null, 2));
-    console.log(`\n✓ Tools saved to ${toolsPath}`);
-  } catch (error) {
-    console.error(`\n✗ Failed to save tools: ${error}`);
-  }
-}
-
-async function listPrompts(manager: MCPClientManager) {
-  const prompts = await manager.getAllPrompts();
-  console.log(`Found ${prompts.length} prompts:\n`);
-
-  for (const prompt of prompts) {
-    console.log(`💬 ${prompt.serverName} / ${prompt.name}`);
-    console.log(`   ${prompt.description}`);
-    if (prompt.arguments && prompt.arguments.length > 0) {
-      console.log(`   Arguments: ${prompt.arguments.map((a: any) => a.name).join(', ')}`);
-    }
-    console.log('');
-  }
-}
-
-async function listResources(manager: MCPClientManager) {
-  const resources = await manager.getAllResources();
-  console.log(`Found ${resources.length} resources:\n`);
-
-  for (const resource of resources) {
-    console.log(`📄 ${resource.serverName} / ${resource.name}`);
-    console.log(`   URI: ${resource.uri}`);
-    if (resource.description) {
-      console.log(`   ${resource.description}`);
-    }
-    if (resource.mimeType) {
-      console.log(`   Type: ${resource.mimeType}`);
-    }
-    console.log('');
-  }
-}
-
-async function callTool(
-  manager: MCPClientManager,
-  serverName: string,
-  toolName: string,
-  argsJson: string
-) {
-  if (!serverName || !toolName || !argsJson) {
-    console.error('Usage: cli.ts call-tool <server> <tool> <json-args>');
-    process.exit(1);
-  }
-
-  const args = JSON.parse(argsJson);
-  console.log(`Calling ${serverName}/${toolName}...`);
-
-  const result = await manager.callTool(serverName, toolName, args);
-  console.log('\nResult:');
-  console.log(JSON.stringify(result, null, 2));
-}
-
-function printUsage() {
-  console.log(`
-MCP Management CLI
-
-Usage:
-  cli.ts <command> [options]
-
-Commands:
-  list-tools                        List all tools and save to assets/tools.json
-  list-prompts                      List all prompts from all MCP servers
-  list-resources                    List all resources from all MCP servers
-  call-tool <server> <tool> <json>  Call a specific tool
-
-Examples:
-  cli.ts list-tools
-  cli.ts call-tool memory create_entities '{"entities":[{"name":"Alice","entityType":"person"}]}'
-  cli.ts call-tool human-mcp playwright_screenshot_fullpage '{"url":"https://example.com"}'
-
-Note: Tool analysis is done by the LLM reading assets/tools.json directly.
-  `);
-}
-
-main();
+#!/usr/bin/env node
+/**
+ * MCP Management CLI - Command-line interface for MCP operations
+ */
+
+import { MCPClientManager } from './mcp-client.js';
+import { writeFileSync, mkdirSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  const manager = new MCPClientManager();
+
+  try {
+    // Load config
+    await manager.loadConfig();
+    console.log('✓ Config loaded');
+
+    // Connect to all servers
+    await manager.connectAll();
+    console.log('✓ Connected to all MCP servers\n');
+
+    switch (command) {
+      case 'list-tools':
+        await listTools(manager);
+        break;
+
+      case 'list-prompts':
+        await listPrompts(manager);
+        break;
+
+      case 'list-resources':
+        await listResources(manager);
+        break;
+
+      case 'call-tool':
+        await callTool(manager, args[1], args[2], args[3]);
+        break;
+
+      default:
+        printUsage();
+    }
+
+    await manager.cleanup();
+  } catch (error) {
+    console.error('Error:', error);
+    process.exit(1);
+  }
+}
+
+async function listTools(manager: MCPClientManager) {
+  const tools = await manager.getAllTools();
+  console.log(`Found ${tools.length} tools:\n`);
+
+  for (const tool of tools) {
+    console.log(`📦 ${tool.serverName} / ${tool.name}`);
+    console.log(`   ${tool.description}`);
+    if (tool.inputSchema?.properties) {
+      console.log(`   Parameters: ${Object.keys(tool.inputSchema.properties).join(', ')}`);
+    }
+    console.log('');
+  }
+
+  // Save tools to JSON file
+  const assetsDir = join(__dirname, '..', 'assets');
+  const toolsPath = join(assetsDir, 'tools.json');
+
+  try {
+    mkdirSync(assetsDir, { recursive: true });
+    writeFileSync(toolsPath, JSON.stringify(tools, null, 2));
+    console.log(`\n✓ Tools saved to ${toolsPath}`);
+  } catch (error) {
+    console.error(`\n✗ Failed to save tools: ${error}`);
+  }
+}
+
+async function listPrompts(manager: MCPClientManager) {
+  const prompts = await manager.getAllPrompts();
+  console.log(`Found ${prompts.length} prompts:\n`);
+
+  for (const prompt of prompts) {
+    console.log(`💬 ${prompt.serverName} / ${prompt.name}`);
+    console.log(`   ${prompt.description}`);
+    if (prompt.arguments && prompt.arguments.length > 0) {
+      console.log(`   Arguments: ${prompt.arguments.map((a: any) => a.name).join(', ')}`);
+    }
+    console.log('');
+  }
+}
+
+async function listResources(manager: MCPClientManager) {
+  const resources = await manager.getAllResources();
+  console.log(`Found ${resources.length} resources:\n`);
+
+  for (const resource of resources) {
+    console.log(`📄 ${resource.serverName} / ${resource.name}`);
+    console.log(`   URI: ${resource.uri}`);
+    if (resource.description) {
+      console.log(`   ${resource.description}`);
+    }
+    if (resource.mimeType) {
+      console.log(`   Type: ${resource.mimeType}`);
+    }
+    console.log('');
+  }
+}
+
+async function callTool(
+  manager: MCPClientManager,
+  serverName: string,
+  toolName: string,
+  argsJson: string
+) {
+  if (!serverName || !toolName || !argsJson) {
+    console.error('Usage: cli.ts call-tool <server> <tool> <json-args>');
+    process.exit(1);
+  }
+
+  const args = JSON.parse(argsJson);
+  console.log(`Calling ${serverName}/${toolName}...`);
+
+  const result = await manager.callTool(serverName, toolName, args);
+  console.log('\nResult:');
+  console.log(JSON.stringify(result, null, 2));
+}
+
+function printUsage() {
+  console.log(`
+MCP Management CLI
+
+Usage:
+  cli.ts <command> [options]
+
+Commands:
+  list-tools                        List all tools and save to assets/tools.json
+  list-prompts                      List all prompts from all MCP servers
+  list-resources                    List all resources from all MCP servers
+  call-tool <server> <tool> <json>  Call a specific tool
+
+Examples:
+  cli.ts list-tools
+  cli.ts call-tool memory create_entities '{"entities":[{"name":"Alice","entityType":"person"}]}'
+  cli.ts call-tool human-mcp playwright_screenshot_fullpage '{"url":"https://example.com"}'
+
+Note: Tool analysis is done by the LLM reading assets/tools.json directly.
+  `);
+}
+
+main();