Code Reference Optimizer MCP Server

Instructions

Implementation Reference

• src/index.ts:198-211 (registration)

  Registration of the 'update_config' tool in the MCP server's listTools handler, including name, description, and input schema.
  { name: 'update_config', description: 'Update configuration settings with new values. Allows fine-tuning of the optimizer behavior including cache policies, token limits, analysis depth, performance thresholds, and feature toggles. Changes are applied immediately and persist for the current session.', inputSchema: { type: 'object', properties: { config: { type: 'object', description: 'Partial configuration object with updates to apply. Can include any combination of configuration sections. Changes are merged with existing settings, not replaced entirely.', }, }, required: ['config'], }, },
• src/index.ts:397-422 (handler)

  Main handler function for the 'update_config' tool. Extracts config from arguments, calls ConfigManager.updateConfig, optionally updates logger, and returns success response.
  private async handleUpdateConfig(args: any) { const { config } = args; if (!config) { throw new McpError(ErrorCode.InvalidParams, 'config is required'); } try { this.configManager.updateConfig(config); // Refresh logger configuration when logging section changes if (config.logging) { const logCfg = this.configManager.getConfig().logging; this.logger.updateConfig({ level: logCfg.level, toFile: logCfg.enableFileLogging, filePath: logCfg.logPath }); } return { content: [{ type: 'text', text: 'Configuration updated successfully', }], }; } catch (error) { this.logger.error(`update_config failed: ${error instanceof Error ? error.message : String(error)}`); throw new McpError(ErrorCode.InternalError, `Failed to update configuration: ${error instanceof Error ? error.message : String(error)}`); } }
• src/config/ConfigManager.ts:6-79 (schema)

  TypeScript interface defining the full structure of CodeReferenceOptimizerConfig, used for config validation and updates in the tool.
  export interface CodeReferenceOptimizerConfig { // Cache settings cache: { maxSize: number; ttlMs: number; evictionPolicy: CacheEvictionPolicy; enablePersistence: boolean; persistencePath?: string; }; // Context extraction settings extraction: { strategy: ContextExtractionStrategy; maxTokens: number; includeComments: boolean; includeImports: boolean; includeExports: boolean; contextLines: number; minRelevanceScore: number; }; // Import optimization settings imports: { enableOptimization: boolean; preserveSideEffects: boolean; analyzeTransitiveDeps: boolean; maxDepthLevel: number; excludePatterns: string[]; includePatterns: string[]; }; // Diff settings diff: { enableContextualDiff: boolean; contextLines: number; ignoreWhitespace: boolean; ignoreComments: boolean; enableSymbolTracking: boolean; }; // Performance settings performance: { maxFileSize: number; maxConcurrentOperations: number; enableMetrics: boolean; timeoutMs: number; }; // Language-specific settings languages: { [language: string]: { enabled: boolean; extensions: string[]; parserOptions?: any; customRules?: OptimizationConfig; }; }; // Logging settings logging: { level: LogLevel; enableFileLogging: boolean; logPath?: string; enableMetricsLogging: boolean; }; // Security settings security: { allowedPaths: string[]; blockedPaths: string[]; maxFileAccess: number; enableSandbox: boolean; }; }
• src/config/ConfigManager.ts:151-155 (helper)

  ConfigManager.updateConfig method: merges partial updates with current config, validates the new config, and notifies change listeners.
  updateConfig(updates: Partial<CodeReferenceOptimizerConfig>): void { this.config = this.mergeConfigs(this.config, updates); this.validateConfig(); this.notifyConfigChange(); }
• src/utils/Logger.ts:31-35 (helper)

  Logger.updateConfig method: updates logger settings like level, file output, and path, called when logging config changes.
  updateConfig(config: LoggerConfig) { if (config.level) this.level = config.level; if (typeof config.toFile === 'boolean') this.toFile = config.toFile; if (config.filePath !== undefined) this.filePath = config.filePath; }