@loop_ouroboros/mcp-hub-lite 1.2.2 → 1.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (16) hide show
  1. package/CHANGELOG.md +535 -380
  2. package/dist/server/src/cli/commands/install.d.ts +25 -0
  3. package/dist/server/src/cli/commands/install.d.ts.map +1 -0
  4. package/dist/server/src/cli/commands/install.js +274 -0
  5. package/dist/server/src/cli/commands/use-guide.d.ts +11 -0
  6. package/dist/server/src/cli/commands/use-guide.d.ts.map +1 -0
  7. package/dist/server/src/cli/commands/use-guide.js +175 -0
  8. package/dist/server/src/cli/index.d.ts.map +1 -1
  9. package/dist/server/src/cli/index.js +4 -0
  10. package/dist/server/src/cli/server.d.ts +71 -0
  11. package/dist/server/src/cli/server.d.ts.map +1 -1
  12. package/dist/server/src/cli/server.js +138 -0
  13. package/dist/server/src/cli/use-guide.md +156 -0
  14. package/dist/server/src/services/gateway/request-handlers/initialize-handler.d.ts.map +1 -1
  15. package/dist/server/src/services/gateway/request-handlers/initialize-handler.js +12 -5
  16. package/package.json +1 -5
package/CHANGELOG.md CHANGED
@@ -1,435 +1,590 @@
1
1
  # Changelog
2
2
 
3
- ## 2026-04-17
3
+ All notable changes to this project will be documented in this file.
4
4
 
5
- - **Version**: Bump version to 1.2.2
6
- - **Config Fix**: Correct servers sorting in config-loader
7
- - **Logger Refactor**: Add STDERR log module for stdio transport
8
- - **Gateway Feature**: Add gatewayDebug logging control
9
- - **Frontend Feature**: Add time unit types and conversion utilities
5
+ ## [1.2.3] - 2026-04-20
10
6
 
11
- ## 2026-04-16
7
+ ### CLI
12
8
 
13
- - **Frontend Feature**: Add Startup configuration tab to Settings page
14
- - **Startup Fix**: Extract ensureServerInstances() to eliminate DRY violation
15
- - **Connection Refactor**: Split connect() into SRP-compliant private methods
16
- - **Startup Refactor**: Extract startup orchestration logic into dedicated module
9
+ - Add use-guide command for CLI usage reference
10
+ - Add install command for adding new MCP servers
11
+ - Remove redundant npm scripts
17
12
 
18
- ## 2026-04-15
13
+ ### Gateway
19
14
 
20
- - **Resource Fix**: Ensure consistent { contents: [...] } format in resource read API
21
- - **Docs**: Add community acknowledgment for LinuxDo
15
+ - Wrap initialize handler debug logs with gatewayDebug condition
22
16
 
23
- ## 2026-04-14
17
+ ### Docs
24
18
 
25
- - **Lint Fix**: Remove unnecessary escape character in CLI entry detection
26
- - **Docs**: Format README files for release
27
- - **Version**: Bump version to 1.2.1
28
- - **CLI Fix**: Fix CLI entry detection for Windows/npm symlink environments
29
- - **CLI Refactor**: Fix command count and rename mcpToolUseCommand to toolUseCommand
30
- - **Config Refactor**: Change config loading logs from info to debug level
31
- - **Core Feature**: Add normalizeToolName for cross-format tool name matching
32
- - **CLI Feature**: Add tool-use command for MCP server tool operations
33
- - **Gateway Feature**: Implement per-request transport mode to fix connection errors
19
+ - Reorganize changelog by functional areas
34
20
 
35
- ## 2026-04-13
21
+ ---
36
22
 
37
- - **Deps**: Add undici dependency for HTTP transport
38
- - **Frontend Fix**: Prevent runtime error when tool is undefined in groupedTools
39
- - **Version**: Bump version to 1.1.0
40
- - **Core Refactor**: Use composite key serverName-serverIndex instead of serverId
41
- - **Resource Feature**: Implement MCP native resource forwarding
42
- - **Docs**: Update search functionality description in CLAUDE.md
43
- - **Hub Tools Refactor**: Add non-strict mode to selectBestInstance
44
- - **Search Refactor**: Remove complex search module, simplify to string matching
45
- - **Test Refactor**: Remove evaluation tests not compliant with MCP spec
23
+ ## [1.2.2] - 2026-04-17
46
24
 
47
- ## 2026-04-12
25
+ ### Gateway
48
26
 
49
- - **Config Refactor**: Move instance selection strategy to template
50
- - **Frontend Refactor**: Improve type declarations and test type safety
51
- - **Frontend Refactor**: Compute instance counts from server.instances directly
52
- - **Gateway Feature**: Restrict call_tool from invoking system tools
53
- - **Docs**: Compress use-guide from 13 to 7 sections
54
- - **Gateway Fix**: Return 400 for missing Accept header
27
+ - Add gatewayDebug logging control
55
28
 
56
- ## 2026-04-10
29
+ ### Frontend
57
30
 
58
- - **Transport Refactor**: Use official SDK StdioClientTransport
59
- - **Stdio Transport Refactor**: Log non-JSON-RPC stdout and unify stderr log level
60
- - **Frontend Fix**: Fix tools and resources not displaying in server detail
61
- - **Frontend Fix**: Add description field to ConfigTemplateForm
62
- - **Tools Fix**: Handle nested toolArgs in updateServerDescription
31
+ - Add time unit types and conversion utilities
32
+ - Add Startup configuration tab to Settings page
63
33
 
64
- ## 2026-04-09
34
+ ### Config
65
35
 
66
- - **Security Feature**: Mask sensitive values in config change logs
67
- - **Frontend Fix**: Improve instance status reactivity and management
68
- - **i18n Fix**: Improve noToolsFound message to reflect tool aggregation
69
- - **Frontend Fix**: Add bottom padding to prevent save button cutoff on scroll
70
- - **Gateway Refactor**: Extract version and protocol version to shared utility
71
- - **Config Refactor**: Unify instance ID generation with content hash
36
+ - Correct servers sorting in config-loader
72
37
 
73
- ## 2026-04-08
38
+ ### Startup
74
39
 
75
- - **MCP Status Fix**: Prevent automatic enabled field updates on connect/disconnect
76
- - **Chore**: Update .gitignore to ignore .full-review directory
40
+ - Extract ensureServerInstances() to eliminate DRY violation
41
+ - Extract startup orchestration logic into dedicated module
77
42
 
78
- ## 2026-04-07
43
+ ### Resources
79
44
 
80
- - **Frontend Fix**: Fix TypeScript type errors in component event handlers
45
+ - Ensure consistent { contents: [...] } format in resource read API
81
46
 
82
- ## 2026-04-04
47
+ ### Logging
83
48
 
84
- - **Test Refactor**: Simplify ServerStatusTags tests with mocks
85
- - **Config Feature**: Sort env and headers keys on config save
86
- - **Proxy Feature**: Add proxy configuration support for SSE and Streamable HTTP transports
49
+ - Add STDERR log module for stdio transport
87
50
 
88
- ## 2026-04-03
51
+ ### Connection
89
52
 
90
- - **Config Feature**: Sort env and headers keys on config save
91
- - **Config Refactor**: Optimize updateServerInstance logging
92
- - **Connection Refactor**: Improve serverId handling and protocol version support
53
+ - Split connect() into SRP-compliant private methods
93
54
 
94
- ## 2026-04-02
55
+ ### Other
95
56
 
96
- - **Docs**: Update CLAUDE.md documentation for logging and composables
97
- - **Logging Refactor**: Enhance transport logging with serverId context
98
- - **Transports Feature**: Add LineBuffer for proper stderr line buffering
99
- - **Logging Refactor**: Enhance logging module and configuration change tracking
100
- - **Docs**: Update CLAUDE.md documentation for v1.1 config refactor
57
+ - Update changelog for 2026-04-15 to 2026-04-17
58
+ - Add LinuxDo community acknowledgment
101
59
 
102
- ## 2026-04-01
60
+ ---
103
61
 
104
- - **Config Refactor**: Complete v1.1 multi-instance configuration refactoring
105
- - **Docs**: Update CLAUDE.md files to reflect session removal
106
- - **Session Refactor**: Remove session persistence mechanism and use SDK native stateless mode
107
- - **Session Refactor**: Remove session persistence mechanism
62
+ ## [1.2.0] - 2026-04-14
108
63
 
109
- ## 2026-03-31
64
+ ### Core
110
65
 
111
- - **UI Fix**: Ensure log viewer area fills available container height
112
- - **Frontend Feature**: Add instance tab routing synchronization
66
+ - Add normalizeToolName for cross-format tool name matching
113
67
 
114
- ## 2026-03-29
68
+ ### CLI
115
69
 
116
- - **i18n Fix**: Correct missing translation key in InstanceConfig component
70
+ - Add tool-use command for MCP server tool operations
71
+ - Fix CLI entry detection for Windows/npm symlink environments
72
+ - Fix command count and rename mcpToolUseCommand to toolUseCommand
117
73
 
118
- ## 2026-03-28
74
+ ### Config
119
75
 
120
- - **Hub Tools Feature**: Implement instance selection strategies
76
+ - Change config loading logs from info to debug level
121
77
 
122
- ## 2026-03-27
78
+ ### System Tools
123
79
 
124
- - **Docs**: Update CLAUDE.md files across project modules
125
- - **Session Feature**: Remove cwd and project fields from session management
126
- - **UI Fix**: Optimize instance list display in English and hide redundant Running tag
127
- - **Config Fix**: Ensure server instance indexes from config load and migration
80
+ - Rename list_tools_in_server to list_tools
128
81
 
129
- ## 2026-03-26
82
+ ### Documentation
130
83
 
131
- - **Config Feature**: Implement v1.1 instance configuration system
84
+ - Complete CLAUDE.md documentation for all submodules
85
+ - Update changelog and README for v1.2 release
132
86
 
133
- ## 2026-03-25
87
+ ### Utils
134
88
 
135
- - **Config Fix**: Support string index type for server instance operations
136
- - **Docs**: Update CLAUDE.md files to reflect recent v1.1 config changes
137
- - **Config Feature**: Enhance instance management with display name and route selection
89
+ - Add unit tests for normalizeToolName function
138
90
 
139
- ## 2026-03-24
91
+ ---
140
92
 
141
- - **Config Refactor**: Activate v1.1 config format with instance support
142
- - **Gateway Fix**: Only include tools from servers with allowedTools configured
143
- - **Hub Tools Fix**: Support both toolArgs and arguments for backward compatibility
93
+ ## [1.1.1] - 2026-04-14
144
94
 
145
- ## 2026-03-23
95
+ ### Gateway
146
96
 
147
- - **Config Refactor**: Activate v1.1 config format, remove v1.0 compatibility code
148
- - **Config Feature**: Add empty value cleaning when saving config
97
+ - Implement per-request transport mode to fix connection errors
149
98
 
150
- ## 2026-03-20
99
+ ### Frontend
151
100
 
152
- - **UI Fix**: Correct dark mode background color and refine instance UI
153
- - **UI Feature**: Add server instance management UI components
154
- - **Config Feature**: Add index and displayName to ServerInstanceConfig with reassignment API
155
- - **UI Feature**: Add tag management UI with TagManager component
156
- - **Config Feature**: Add v1.1 config schema with auto-migration support
101
+ - Prevent runtime error when tool is undefined in groupedTools
157
102
 
158
- ## 2026-03-19
103
+ ---
159
104
 
160
- - **i18n Fix**: Fix headers label and add button text in server config
161
- - **UI Feature**: Add description field support in AddServerModal
105
+ ## [1.1.0] - 2026-04-13
162
106
 
163
- ## 2026-03-17
107
+ ### Resources
164
108
 
165
- - **UI Enhancement**: Update resource detail and list views with hub tools integration
166
- - **System Tools Refactor**: Enhance system tools handling and API endpoints
167
- - **Hub Tools Refactor**: Restructure core hub tools service architecture
109
+ - Implement MCP native resource forwarding
168
110
 
169
- ## 2026-03-15
111
+ ### Gateway
170
112
 
171
- - **Lint Fix**: Add fallback for missing .eslintrc-auto-import.json
172
- - **UI Fix**: Correct serverName prop in ServerDetail for ToolCallDialog
173
- - **Hub Tools Refactor**: Simplify dynamic resources list to only server metadata
113
+ - Restrict call_tool from invoking system tools
114
+ - Return 400 for missing Accept header
115
+ - Extract version and protocol version to shared utility
116
+ - Only include tools from servers with allowedTools configured
174
117
 
175
- ## 2026-03-09
118
+ ### Security
176
119
 
177
- - **Core Refactor**: Update core modules for session and client migration
178
- - **Gateway Refactor**: Clean up deprecated methods and update tool cache access
179
- - **Client Refactor**: Remove deprecated client tracking and stores
180
- - **Session Refactor**: Migrate from mcp-session-manager to session-tracker service
181
- - **Test**: Enable initialized notification test
182
- - **Style**: Improve regex formatting for caller info
183
- - **Session Feature**: Add capabilities support in session manager
184
- - **Session Refactor**: Simplify sessionId generation
185
- - **Gateway Feature**: Add initialized notification and capabilities handling
186
- - **Client Tracker Feature**: Add capabilities and project inference
187
- - **Session Feature**: Add capabilities field to session model
188
- - **UI Feature**: Add capabilities display in SessionsView
189
- - **Logger Feature**: Add caller information and environment variable controls
190
- - **Logger Fix**: Ensure JSON pretty-printing for empty capabilities messages
191
- - **API Refactor**: Make MCP communication debug logging conditional
192
- - **Feature**: Add headers support and default to streamable-http
193
- - **UI Fix**: Fix environment variable value input display
194
-
195
- ## 2026-03-06
196
-
197
- - **System Tool Fix**: Fix system tool call validation errors when requestOptions.sessionId is null
198
- - **Frontend Fix**: Change system tool serverName from 'system' to 'mcp-hub-lite' for consistency
199
- - **Zod Schema Enhancement**: Enhance sessionId schema to accept null and transform to undefined
200
- - **ToolCallDialog Improvement**: Only include requestOptions when selectedInstanceId has value
201
- - **Version Bump**: Update package.json version to 1.0.1
202
-
203
- ## 2026-03-05
204
-
205
- - **Project Initialization**: Execute full project documentation architecture initialization and update
206
- - **Root CLAUDE.md Update**: Add 2026-03-05 changelog entry, verify module structure diagram and navigation link integrity
207
- - **Module Documentation Status Check**: Confirm CLAUDE.md document status for all 20 major modules
208
- - **Coverage Report Verification**: Verify project scan coverage and scan status
209
-
210
- ## 2026-03-04
211
-
212
- - **CLI Fix**: Ensure CLI commands exit properly after execution
213
- - **CLI/Logger Fix**: Fix server startup and log ANSI color issues
214
- - **CLI Enhancement**: Enhance status command with formatted output
215
- - **UI Enhancement**: Improve settings page UI and dev mode handling
216
- - **Logging Refactor**: Improve MCP gateway logging
217
- - **Logging Refactor**: Unify dev mode detection, remove devLogFile config
218
- - **Logging Enhancement**: Enhance stdio transport with log store integration
219
-
220
- ## 2026-03-03
221
-
222
- - **Test Update**: Update tests for new log config system
223
- - **Logging Fix**: Use getMcpCommDebugSetting() in connection-manager
224
- - **Logging Refactor**: Unify logging configuration system
225
- - **Config Enhancement**: Extend config schema with new log options
226
- - **UI Enhancement**: Add new logging config options in settings
227
- - **Logging Refactor**: Extract and unify MCP notification message handling
228
- - **Logging Fix**: Improve stderr log level detection logic
229
- - **Logging Refactor**: Use MCP_COMM_DEBUG environment variable for communication logs
230
- - **Gateway Refactor**: Remove SSE connection timestamp tracking
231
- - **Session Enhancement**: Count expired sessions and use configured flush interval
232
- - **Logging Enhancement**: Filter binary image data in MCP response logs
233
- - **UI Styling**: Remove trailing semicolon in SettingsView style
234
- - **Refactor**: Improve type handling and SSE logging
235
- - **Documentation**: Update project documentation
236
- - **UI Refactor**: Implement Element Plus auto-import
237
- - **UI Fix**: Fix el-input-number width issue in SettingsView
238
-
239
- ## 2026-03-02
240
-
241
- - **Session Enhancement**: Skip expired sessions during recovery
242
- - **Telemetry Removal**: Remove OpenTelemetry and telemetry features
243
- - **Styling**: Format codebase with prettier
244
- - **SSE Enhancement**: Add connection timeout config and reconnection detection
245
- - **Logging Enhancement**: Enhance JSON pretty-printing with newline handling
246
- - **Logging Styling**: Unify LOG_MODULES format as PascalCase
247
- - **Session Refactor**: Simplify session matching logic
248
-
249
- ## 2026-03-01
250
-
251
- - **Logging Refactor**: Change log file naming to timestamp-based format
252
- - **Refactor**: Add LOG_MODULES context and update hub-manager service tests
253
- - **Session Enhancement**: Enhance sessionId extraction with header support and improved fallback logic
254
- - **Session Refactor**: Extract session manager to modular structure
255
- - **Connection Refactor**: Extract connection manager to modular structure
256
-
257
- ## 2026-02-28
258
-
259
- - **Documentation**: Update CLAUDE.md with project initialization summary
260
- - **Logging Refactor**: Rename subModule to module, add LOG_MODULES constants
261
- - **Hub-Tools Refactor**: Extract hub-tools.service.ts to modular structure
262
- - **Gateway Refactor**: Extract gateway.service.ts to modular structure
263
- - **API/MCP Refactor**: Extract gateway module to separate files
264
- - **Config Refactor**: Split config-manager to modular structure
265
- - **Logging Refactor**: Add missing subModule context to log statements
266
- - **Logging Refactor**: Split monolithic logger to modular structure
267
- - **Gateway Fix**: Add missing uri field in ReadMcpResourceTool response
268
-
269
- ## 2026-02-27
270
-
271
- - **Gateway Refactor**: Enhance SSE stream management and response logging
272
- - **Refactor**: Remove duplicate debug logging in gateway
273
- - **Refactor**: Resolve config-logger circular dependency with config getter pattern
274
- - **Logging Fix**: Use stringifyForLogging for gateway header, improve rawHeaders readability
275
-
276
- ## 2026-02-26
277
-
278
- - **Refactor**: Fix ESM imports and optimize CLI startup performance
279
- - **Frontend Enhancement**: Add type safety for JsonSchema in frontend ToolsView
280
- - **Documentation**: Update docs for config path and logging
281
- - **Enhancement**: Enhance dev server startup logging
282
- - **Refactor**: Optimize logging verbosity
283
- - **Enhancement**: Add rawHeaders operation for session header propagation
284
- - **Enhancement**: Enhance session persistence and cleanup logic
285
- - **Enhancement**: Introduce unified system tools processor and prefix tool name support
286
- - **Enhancement**: Enhance session management with consistency check and request header handling
287
- - **Refactor**: Optimize logger options extraction
288
- - **Enhancement**: Improve tool call dialog and system tools display
289
-
290
- ## 2026-02-25
291
-
292
- - **Enhancement**: Enhance documentation and system configuration
293
- - **MCP Connection Manager Refactor**: Optimize getTools/getResources logging with cache hit indicator and resource cache improvements
294
- - **Refactor**: Extract common stderr handling logic to reduce code duplication
295
- - **Enhancement**: Add server description field and resource detail improvements
296
-
297
- ## 2026-02-15
298
-
299
- - **Session Persistence Feature**: Implement session state persistence to disk with dirty tracking and batch flushing
300
- - **Graceful Shutdown Handling**: Add graceful shutdown handler for session state flushing
301
- - **Session Management API**: Add session management API endpoints (list, get, delete)
302
- - **Session Recovery Logic**: Enhance session recovery logic with clientName matching
303
- - **Settings Page Enhancement**: Add time unit selector (seconds/minutes/hours/days)
304
- - **Logging System Improvements**: Support subModule context and tools/list response simplification
305
- - **Log Directory Optimization**: Move log directory to ~/.mcp-hub-lite/logs
306
- - **Full Check Command**: Add `npm run full:check` command for simplified complete project checking
307
- - **Unit Test Coverage**: Add comprehensive unit tests for session manager
308
-
309
- ## 2026-02-14
310
-
311
- - **Session Persistence Implementation**: Implement session persistence and configuration management
312
- - **CLI Unit Tests**: Add comprehensive unit tests for CLI commands
313
- - **Session Timeout Configuration**: Add configurable session timeout for MCP gateway
314
- - **Type Safety Improvements**: Comprehensive eslint no-explicit-any fixes and type safety enhancements
315
-
316
- ## 2026-02-13
317
-
318
- - **CLI Command Tests**: Add comprehensive unit tests for CLI commands
319
- - **Session Timeout Configuration**: Add configurable session timeout for MCP gateway
320
- - **Type Safety Fixes**: Comprehensive eslint no-explicit-any fixes and type safety improvements
321
-
322
- ## 2026-02-11
323
-
324
- - **Frontend i18n Support**: Update server status tags and tool call dialog components with i18n support
325
- - **ESLint Configuration Fix**: Fix lint:log command and ESLint configuration
326
- - **Frontend Resource View**: Improve resource view with table layout
327
- - **Type System Refactor**: Establish shared type system for frontend-backend integration
328
- - **WebSocket Types**: Establish client and WebSocket type system
329
- - **Config Manager Optimization**: Prevent test pollution with lazy initialization for ConfigManager
330
- - **System Tools Optimization**: Enhance system tools type safety and naming
331
- - **MCP Resource Support**: Add MCP resource support with UI and API endpoints
332
- - **Client Tracking Enhancement**: Enhance client tracking and connection management
333
- - **Tool Call Dialog**: Improve tool call dialog with i18n and response display
334
- - **Search Functionality Optimization**: Implement comprehensive search functionality across MCP servers
335
-
336
- ## 2026-02-10
337
-
338
- - **Fix config.test.ts Intermittent Test Failure**: Resolve "should save config to file" intermittent test failure
339
- - **Root Cause Analysis**: ConfigManager singleton pattern caused test state pollution and temporary file path conflicts
340
- - **Fix Solution**:
341
- - Modify getConfigManager() to create new instances in test environment for isolation
342
- - Generate unique temporary file paths for each test with timestamp and random suffix
343
- - Enhance file cleanup logic with retry mechanism to handle Windows file system permissions
344
- - **Validation Results**: 100 sequential tests, 50 parallel tests (2 concurrency), 200 parallel tests (5 concurrency) all passed
345
- - **Documentation**: Add A3 problem analysis report and detailed technical fix report
346
-
347
- ## 2026-01-31
348
-
349
- - **Frontend UI Enhancement**: Enhance server card and interaction
350
- - **Configuration Backup Optimization**: Optimize backup system with caching and compilation phase handling
351
- - **Tool Call Dialog**: Enhance tool call dialog with i18n and response display
352
- - **System Tools Simplification**: Simplify system tools API and improve type safety
353
- - **MCP Connection Optimization**: Optimize connection management logic
354
- - **Path Alias System**: Enhance path alias system with module-specific aliases
355
- - **Server Status Tags**: Add server status tags component with i18n support
356
- - **Search Functionality Optimization**: Implement comprehensive search functionality across MCP servers
357
-
358
- ## 2026-01-30
359
-
360
- - **Config Manager Optimization**: Optimize backup logic and implement lazy initialization
361
- - **Test Coverage Optimization**: Add temporary directory to test coverage paths
362
- - **Logging System Refactor**: Extract common log method to eliminate code duplication
363
- - **Test Fix**: Fix missing logger.setLevel method and system.logging property mock configuration in runner.test.ts
364
- - **PID Formatting Optimization**: Increase PID formatting width to 8 characters
365
- - **TypeScript Fix**: Resolve TypeScript type errors in unit tests
366
- - **Server Optimization**: Optimize batch import with single save and concurrent startup
367
- - **Configuration Optimization**: Skip backup creation for default configuration
368
-
369
- ## 2026-01-27
370
-
371
- - **Server Fix**: Fix auto-start not working and sidebar display issues
372
- - **Temporary File Cleanup**: Remove temporary files
373
- - **Frontend Layout Refactor**: Update App.vue with new layout structure
374
- - **Dependency Update**: Update package dependencies and Vite configuration
375
- - **Test Updates**: Update tests for new features and services
376
- - **Server Runtime Optimization**: Optimize server runtime and CLI commands
377
- - **Service Enhancement**: Add Hub Manager and Search Core services
378
- - **API Enhancement**: Enhance MCP gateway and web API endpoints
379
- - **Frontend Features**: Add tool calls store and WebSocket utilities
380
- - **Multi-language Support**: Add multi-language support and update UI components
381
-
382
- ## 2026-01-26
383
-
384
- - **WebSocket Functionality**: Implement real-time log streaming via WebSocket
385
- - **Client Management**: Add client management functionality
386
- - **Branch Merge**: Merge branch 'feat/client-management' into 003-DEV
387
-
388
- ## 2026-01-21
389
-
390
- - **Logging Optimization**: Optimize logging for tools/list responses
391
- - **Client Management**: Add client management functionality
392
-
393
- ## 2026-02-01
394
-
395
- - **Project Summary Update**: Execute "root-level concise + module-level detailed" hybrid strategy update
396
- - **File Statistics**: Identify complete project structure and modules
397
- - **Module Coverage**: All major modules have been identified and CLAUDE.md documents created/updated
398
- - **Coverage Rate**: 100% module coverage, complete file scanning finished
399
- - **Enhance Module Structure Diagram**: Update Mermaid structure diagram, ensure all module links are correct
400
- - **Update Module Index**: Include all submodules
401
-
402
- ### 2026-01-29
403
-
404
- - **Project Index Update**: Execute complete scan, update project documentation index
405
- - **File Statistics**: Identify 94 source code files (47 backend + 27 frontend + 20 tests)
406
- - **Module Coverage**: All 16 modules have been identified and CLAUDE.md documents created
407
- - **Coverage Rate**: 100% module coverage, 100% file scanning completed
408
- - **Enhance Module Structure Diagram**: Add missing module links (including CONTRACT module)
409
- - **Update Module Index**: Include all submodules
410
-
411
- ### 2026-01-28
412
-
413
- - Update summary
414
- - Improve module structure diagram, add missing module links (including CONTRACT module)
415
- - Create detailed CLAUDE.md documents for src/server and src/pid modules
416
- - Create detailed CLAUDE.md documents for frontend/router and frontend/i18n modules
417
- - Create detailed CLAUDE.md documents for tests/contract module
418
- - Update module index, include all submodules
419
- - **Add Frontend Test Coverage**: Add unit tests for Dashboard component, ToolCard component, and Server Store
420
- - **Update Test Configuration**: Configure Vue Test Utils and JSDOM environment for frontend component testing
421
- - **Update Project Documentation**: Reflect improvements in frontend test status
422
- - **Add Server Runtime Tests**: Add complete unit test coverage for src/server/runner.ts
423
- - **Update Test Documentation**: Add server module test documentation in tests/unit/CLAUDE.md
424
-
425
- ### 2026-01-20
426
-
427
- - Optimize HubTools call logic, replace serverName parameter with serverId in all methods, directly use server unique identifier for operations, avoiding the overhead of finding servers by name
428
- - Add HubToolsService documentation
429
- - Update project architecture documentation
430
-
431
- ### 2026-01-19
432
-
433
- - Initialize project AI context documentation
434
- - Generate module structure diagram and index
435
- - Integrate architecture specifications and development processes
120
+ - Mask sensitive values in config change logs
121
+
122
+ ### Config
123
+
124
+ - Sort env and headers keys on config save
125
+ - Implement v1.1 instance configuration system
126
+ - Enhance instance management with display name and route selection
127
+ - Add empty value cleaning when saving config
128
+ - Add index and displayName to ServerInstanceConfig with reassignment API
129
+ - Add v1.1 config schema with auto-migration support
130
+ - Move instance selection strategy to template
131
+ - Complete v1.1 multi-instance configuration refactoring
132
+ - Activate v1.1 config format with instance support
133
+ - Activate v1.1 config format, remove v1.0 compatibility code
134
+ - Ensure server instance indexes from config load and migration
135
+ - Support string index type for server instance operations
136
+ - Unify instance ID generation with content hash
137
+
138
+ ### Proxy
139
+
140
+ - Add proxy configuration support for SSE and Streamable HTTP transports
141
+
142
+ ### Transport
143
+
144
+ - Add LineBuffer for proper stderr line buffering
145
+ - Use official SDK StdioClientTransport
146
+ - Log non-JSON-RPC stdout and unify stderr log level
147
+
148
+ ### Frontend
149
+
150
+ - Add instance tab routing synchronization
151
+ - Fix tools and resources not displaying in server detail
152
+ - Add description field to ConfigTemplateForm
153
+ - Improve instance status reactivity and management
154
+ - Add bottom padding to prevent save button cutoff on scroll
155
+ - Fix TypeScript type errors in component event handlers
156
+ - Ensure log viewer area fills available container height
157
+ - Optimize instance list display in English and hide redundant Running tag
158
+ - Correct dark mode background color and refine instance UI
159
+ - Improve type declarations and test type safety
160
+ - Compute instance counts from server.instances directly
161
+
162
+ ### UI Components
163
+
164
+ - Add server instance management UI components
165
+ - Add tag management UI with TagManager component
166
+ - Add description field support in AddServerModal
167
+ - Update resource detail and list views with hub tools integration
168
+
169
+ ### i18n
170
+
171
+ - Improve noToolsFound message to reflect tool aggregation
172
+ - Correct missing translation key in InstanceConfig component
173
+ - Fix headers label and add button text in server config
174
+
175
+ ### Session
176
+
177
+ - Remove cwd and project fields from session management
178
+ - Remove session persistence mechanism and use SDK native stateless mode
179
+ - Remove session persistence mechanism
180
+
181
+ ### System Tools
182
+
183
+ - Implement instance selection strategies
184
+ - Add update_server_description system tool
185
+ - Support both toolArgs and arguments for backward compatibility
186
+ - Add MCP_HUB_LITE_SERVER handling to getTool
187
+ - listServers only returns connected servers
188
+ - Restructure core hub tools service architecture
189
+ - Enhance system tools handling and API endpoints
190
+ - Add non-strict mode to selectBestInstance
191
+ - Optimize hub tools service and API
192
+ - Simplify system tools API and improve type safety
193
+
194
+ ### MCP Status
195
+
196
+ - Prevent automatic enabled field updates on connect/disconnect
197
+
198
+ ### Connection
199
+
200
+ - Improve serverId handling and protocol version support
201
+
202
+ ### Search
203
+
204
+ - Remove complex search module, simplify to string matching
205
+ - Simplify search logic using server-level caching
206
+
207
+ ### Tests
208
+
209
+ - Remove evaluation tests not compliant with MCP spec
210
+
211
+ ### Core
212
+
213
+ - Use composite key serverName-serverIndex instead of serverId
214
+
215
+ ### Documentation
216
+
217
+ - Update search functionality description
218
+ - Update CLAUDE.md documentation for logging and composables
219
+ - Update CLAUDE.md documentation for v1.1 config refactor
220
+ - Update CLAUDE.md files to reflect session removal
221
+ - Update CLAUDE.md files across project modules
222
+ - Update CLAUDE.md files to reflect recent v1.1 config changes
223
+ - Update CLAUDE.md files with format improvements and new content
224
+
225
+ ### Use Guide
226
+
227
+ - Compress use-guide from 13 to 7 sections
228
+
229
+ ### Tools
230
+
231
+ - Handle nested toolArgs in updateServerDescription
232
+ - Simplify ServerStatusTags tests with mocks
233
+ - Optimize updateServerInstance logging
234
+
235
+ ### Lint
236
+
237
+ - Add fallback for missing .eslintrc-auto-import.json
238
+
239
+ ### Status
240
+
241
+ - Show all configured servers including disabled ones in status
242
+
243
+ ---
244
+
245
+ ## [1.0.2] - 2026-03-15
246
+
247
+ ### Session
248
+
249
+ - Add capabilities support in session manager
250
+ - Add capabilities field to session model
251
+ - Simplify sessionId generation
252
+
253
+ ### Gateway
254
+
255
+ - Add initialized notification and capabilities handling
256
+ - Clean up deprecated methods and update tool cache access
257
+ - Enable initialized notification test
258
+
259
+ ### Client
260
+
261
+ - Add capabilities and project inference
262
+
263
+ ### UI
264
+
265
+ - Add capabilities display in SessionsView
266
+ - Correct serverName prop in ServerDetail for ToolCallDialog
267
+
268
+ ### System Tools
269
+
270
+ - Simplify dynamic resources list to only server metadata
271
+
272
+ ### Core
273
+
274
+ - Update core modules for session and client migration
275
+
276
+ ### Client Tracking
277
+
278
+ - Remove deprecated client tracking and stores
279
+
280
+ ### Session Migration
281
+
282
+ - Migrate from mcp-session-manager to session-tracker service
283
+
284
+ ### API
285
+
286
+ - Make MCP communication debug logging conditional
287
+
288
+ ---
289
+
290
+ ## [1.0.1] - 2026-03-15
291
+
292
+ ### UI
293
+
294
+ - Fix environment variable value input display
295
+
296
+ ### System Tools
297
+
298
+ - Resolve system tool call validation errors
299
+
300
+ ---
301
+
302
+ ## [1.0.0] - 2026-03-15
303
+
304
+ ### UI
305
+
306
+ - Improve dashboard and server status tags
307
+ - Improve settings page UI and dev mode handling
308
+ - Add new logging configuration options to settings
309
+ - Improve resources view with table layout
310
+ - Improve tool call dialog and system tools display
311
+ - Enhance server card and interaction
312
+ - Enhance tool call dialog with i18n and response display
313
+ - Add server status tags component with i18n support
314
+ - Update App.vue with new layout structure
315
+
316
+ ### CLI
317
+
318
+ - Enhance status command with formatted output
319
+ - Add comprehensive unit tests for CLI commands
320
+ - Ensure CLI commands exit properly after execution
321
+ - Fix server startup and log ANSI color issues
322
+
323
+ ### Logging
324
+
325
+ - Enhance log storage integration for stdio transports
326
+ - Filter binary image data in MCP response logs
327
+ - Enhance JSON pretty printing with newline processing
328
+ - Improve MCP gateway logging
329
+ - Unify dev mode detection and remove devLogFile config
330
+ - Unify logging configuration system
331
+ - Extract and unify MCP notification message handling
332
+ - Use MCP_COMM_DEBUG env var to control communication logs
333
+ - Change log file naming to timestamp-based format
334
+ - Add missing subModule context to log statements
335
+ - Split monolithic logger into modular structure
336
+ - Enhance SSE stream management and response logging
337
+ - Extract common log method to eliminate code duplication
338
+ - Optimize logging verbosity
339
+ - Optimize logger options extraction
340
+ - Optimize getTools/getResources logging with cache hit indicators and resource cache improvement
341
+ - Improve stderr log level detection logic
342
+ - Use getMcpCommDebugSetting() in connection-manager
343
+ - Use stringifyForLogging for gateway headers and improve rawHeaders readability
344
+ - Enhance development server logging and hot reload
345
+ - Organize file structure and enhance logging
346
+ - Optimize logging for tools/list responses
347
+ - Update documentation for config path and logging
348
+
349
+ ### Config
350
+
351
+ - Extend config schema with new logging options
352
+ - Add configurable session timeout for MCP gateway
353
+ - Simplify config-manager implementation
354
+ - Use default config on validation failure
355
+ - Prevent auto-creation of config file and add error logging
356
+ - Add immediate save option to updateConfig method
357
+ - Optimize backup system with caching and compilation phase handling
358
+ - Optimize backup logic and implement lazy initialization
359
+ - Skip backup creation for default config
360
+ - Remove delayed save mechanism
361
+ - Correct config path
362
+
363
+ ### Session
364
+
365
+ - Count expired sessions and use config flush interval
366
+ - Skip expired sessions during restore
367
+ - Enhance sessionId extraction with header support and improved fallback logic
368
+ - Enhance session persistence and cleanup logic
369
+ - Enhance session management with consistency checks and request header handling
370
+ - Implement comprehensive session persistence and management
371
+ - Implement session persistence and configuration management
372
+ - Simplify session matching logic
373
+ - Extract session manager into modular structure
374
+
375
+ ### SSE
376
+
377
+ - Add connection timeout config and reconnection detection
378
+ - Remove SSE connection timestamp tracking
379
+ - Improve type handling and SSE logging
380
+
381
+ ### Type System
382
+
383
+ - Add type safety for JsonSchema in frontend ToolsView
384
+ - Comprehensive eslint no-explicit-any fixes and type safety improvements
385
+ - Establish shared type system for frontend-backend integration
386
+
387
+ ### System Tools
388
+
389
+ - Introduce unified system tool handler and prefixed tool name support
390
+ - Implement system tools framework with centralized constants
391
+
392
+ ### Documentation
393
+
394
+ - Enhance documentation and system configuration
395
+ - Add server description field and resource detail improvements
396
+ - Update project documentation and configuration
397
+
398
+ ### Request Headers
399
+
400
+ - Add rawHeaders manipulation for session header propagation
401
+
402
+ ### Tools
403
+
404
+ - Add serverName field to tool model and implement server-level caching
405
+
406
+ ### Observability
407
+
408
+ - Enhance OpenTelemetry integration and logging system
409
+ - Add OpenTelemetry tracing support
410
+ - Simplify tracing exporters to console and OTLP only
411
+ - Remove OpenTelemetry and telemetry functionality
412
+
413
+ ### Logger
414
+
415
+ - Add subModule support to logger and update WebSocket logs
416
+ - Add LOG_MODULES context and update hub-manager service tests
417
+
418
+ ### Search
419
+
420
+ - Implement simple search service for basic tool discovery
421
+ - Enhance tool call dialog and tools view with search integration
422
+ - Implement comprehensive search functionality across MCP servers
423
+
424
+ ### WebSocket
425
+
426
+ - Add server update event listeners
427
+
428
+ ### Tool Views
429
+
430
+ - Enhance tools view with serverName-based grouping
431
+ - Enhance tool call dialog and tools view with search integration
432
+
433
+ ### Batch Operations
434
+
435
+ - Optimize batch import with single save and concurrent startup
436
+
437
+ ### Services
438
+
439
+ - Add hub manager and search core services
440
+
441
+ ### API
442
+
443
+ - Enhance MCP gateway and web API endpoints
444
+
445
+ ### Client Tracking
446
+
447
+ - Enhance client tracking and connection management
448
+
449
+ ### Frontend Store
450
+
451
+ - Add tool calls store and websocket utilities
452
+
453
+ ### Client
454
+
455
+ - Add client version display
456
+ - Add manual save button to server list
457
+ - Add client management functionality
458
+
459
+ ### i18n
460
+
461
+ - Add multi-language support and update UI components
462
+ - Add internationalization support for server management actions
463
+
464
+ ### Server Management
465
+
466
+ - Enhance system configuration management and server management functionality
467
+ - Enhance server management functionality, add timeout and auto-start configurations
468
+ - Optimize server detail page status display and uptime calculation
469
+
470
+ ### Tool Management
471
+
472
+ - Implement comprehensive tool search and management system
473
+
474
+ ### Tool Gateway
475
+
476
+ - Implement Tools Gateway and refactor navigation
477
+
478
+ ### MCP Server
479
+
480
+ - Add server auto-start configuration and refactor MCP gateway transport
481
+ - Add server version information display functionality
482
+ - Implement MCP Server log page to display complete logs
483
+ - Add server config timeout setting functionality
484
+ - Refactor MCP connection management and transport layer, add resource model support
485
+ - Fix auto-start not working and sidebar display issues
486
+
487
+ ### Resources
488
+
489
+ - Display tool and resource counts in tabs
490
+ - Add MCP resources support with UI and API endpoints
491
+
492
+ ### Transport
493
+
494
+ - Add Streamable HTTP transport support for Microsoft Learn MCP Server
495
+
496
+ ### Frontend Tools
497
+
498
+ - Add remote server support and HTTP utilities
499
+ - Save development progress with UI enhancements and new components
500
+ - Complete frontend architecture refactoring and implement new UI components
501
+ - Use shared types in frontend code
502
+ - Enhance path alias system with module-specific aliases
503
+ - Rename dashboard and header components to view suffix
504
+ - Frontend code cleanup and improvements
505
+ - Enhance type safety in gateway and hub tools services
506
+
507
+ ### Implementation Milestones
508
+
509
+ - Complete MCP Hub Lite implementation with multi-server support
510
+ - Simplify architecture and enhance CLI status command
511
+ - Enhance CLI, add i18n, update config & cleanup
512
+ - Implement pid management and stop/restart commands
513
+ - Implement cli commands (start, list, status, ui)
514
+ - Implement fault tolerance and health checks
515
+ - Implement mcp streaming gateway with stdio support
516
+ - Implement mcp connection and tool search
517
+ - Complete phase 3 server management implementation
518
+ - Complete Phase 1 & 2 (infrastructure, models, config)
519
+
520
+ ### Tests
521
+
522
+ - Resolve config manager intermittent test failure
523
+ - Prevent test pollution by implementing lazy initialization for ConfigManager
524
+ - Resolve TypeScript type errors in unit tests
525
+ - Fix runner.test.ts missing logger.setLevel method and system.logging mock config
526
+ - Update all tests to include serverName field
527
+ - Add comprehensive utility unit tests
528
+ - Add comprehensive server runner unit tests
529
+ - Add comprehensive frontend and backend test infrastructure
530
+ - Fix lint:log command and ESLint configuration
531
+ - Add evaluation test files
532
+
533
+ ### Element Plus
534
+
535
+ - Implement Element Plus auto-import
536
+
537
+ ### Imports
538
+
539
+ - Replace relative imports with path aliases
540
+
541
+ ### Vitest
542
+
543
+ - Add temp directory to test coverage paths
544
+ - Exclude frontend unit tests from main tsconfig
545
+
546
+ ### Images
547
+
548
+ - Remove unused image
549
+
550
+ ### Index
551
+
552
+ - Update project index and fix documentation typos
553
+ - Update project AI context documentation
554
+
555
+ ### Debugging
556
+
557
+ - Remove duplicate debug logs in gateway
558
+ - Fix ESM imports and optimize CLI startup performance
559
+ - Resolve config-logger circular dependency using config getter pattern
560
+
561
+ ### Bug Fixes
562
+
563
+ - Fix el-input-number width issue in SettingsView
564
+ - Add missing uri field in ReadMcpResourceTool response
565
+ - Correct serverName usage in tool call dialog
566
+ - Correct variable declaration in applyFilters
567
+ - Correct config path in SettingsView computed properties
568
+ - Ensure allowedTools is initialized as empty array for new servers
569
+ - Fix tool aggregation toggle logic in frontend
570
+ - Fix log loading issues in Dashboard and ServerDetail
571
+ - Fix two issues with server deletion functionality
572
+ - Fix CLI commands hanging after execution
573
+ - Add missing PidManager import in index.ts
574
+ - Fix missing imports in app.ts
575
+
576
+ ### Backend
577
+
578
+ - Use shared types in backend code
579
+
580
+ ### Architecture
581
+
582
+ - Establish shared type system for frontend-backend integration
583
+
584
+ ### Type Safety
585
+
586
+ - Improve system tools type safety and naming
587
+ - Optimize configuration and logging system
588
+ - Enhance test coverage and SDK helpers
589
+ - Improve configuration and telemetry
590
+ - Optimize connection management logic