Super Shell MCP Server

Instructions

Implementation Reference

• src/index.ts:438-468 (handler)

  The primary handler function for the 'add_to_whitelist' tool. It validates the input arguments using Zod, converts the security level string to the appropriate enum value, calls the CommandService's addToWhitelist method, and returns a success response.
  private async handleAddToWhitelist(args: any) { const schema = z.object({ command: z.string(), securityLevel: z.enum(['safe', 'requires_approval', 'forbidden']), description: z.string().optional(), }); const { command, securityLevel, description } = schema.parse(args); // Map string security level to enum const securityLevelEnum = securityLevel === 'safe' ? CommandSecurityLevel.SAFE : securityLevel === 'requires_approval' ? CommandSecurityLevel.REQUIRES_APPROVAL : CommandSecurityLevel.FORBIDDEN; this.commandService.addToWhitelist({ command, securityLevel: securityLevelEnum, description, }); return { content: [ { type: 'text', text: `Command '${command}' added to whitelist with security level '${securityLevel}'`, }, ], }; }
• src/index.ts:178-200 (schema)

  The input schema definition for the 'add_to_whitelist' tool, registered in the ListTools handler. Defines the expected parameters, types, descriptions, and required fields for MCP tool invocation.
  { name: 'add_to_whitelist', description: 'Add a command to the whitelist', inputSchema: { type: 'object', properties: { command: { type: 'string', description: 'The command to whitelist', }, securityLevel: { type: 'string', enum: ['safe', 'requires_approval', 'forbidden'], description: 'Security level for the command', }, description: { type: 'string', description: 'Description of the command', }, }, required: ['command', 'securityLevel'], }, },
• src/index.ts:289-290 (registration)

  The switch case in the CallToolRequestSchema handler that registers and routes calls to the 'add_to_whitelist' handler function.
  case 'add_to_whitelist': return await this.handleAddToWhitelist(args);
• src/services/command-service.ts:143-145 (helper)

  The supporting method in CommandService that adds a command entry to the internal whitelist Map.
  public addToWhitelist(entry: CommandWhitelistEntry): void { this.whitelist.set(entry.command, entry); }
• src/services/command-service.ts:26-35 (schema)

  TypeScript interface defining the structure of a CommandWhitelistEntry used by the addToWhitelist method.
  export interface CommandWhitelistEntry { /** The command path or name */ command: string; /** Security level of the command */ securityLevel: CommandSecurityLevel; /** Allowed arguments (string for exact match, RegExp for pattern match) */ allowedArgs?: Array<string | RegExp>; /** Description of the command for documentation */ description?: string; }