imcp 0.1.5 → 0.1.6

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 (186) hide show
  1. package/.github/ISSUE_TEMPLATE/JitAccess.yml +28 -0
  2. package/.github/acl/access.yml +20 -0
  3. package/.github/compliance/inventory.yml +5 -0
  4. package/.github/policies/jit.yml +19 -0
  5. package/.github/workflows/build.yml +28 -0
  6. package/.roo/rules-code/rules.md +88 -0
  7. package/docs/ONBOARDING_PAGE_DESIGN.md +260 -0
  8. package/docs/Telemetry.md +136 -0
  9. package/memory-bank/activeContext.md +26 -0
  10. package/memory-bank/decisionLog.md +91 -0
  11. package/memory-bank/productContext.md +41 -0
  12. package/memory-bank/progress.md +35 -0
  13. package/memory-bank/systemPatterns.md +10 -0
  14. package/package.json +1 -5
  15. package/src/cli/commands/install.ts +139 -0
  16. package/src/cli/commands/list.ts +113 -0
  17. package/src/cli/commands/pull.ts +16 -0
  18. package/src/cli/commands/serve.ts +39 -0
  19. package/src/cli/commands/uninstall.ts +64 -0
  20. package/src/cli/index.ts +82 -0
  21. package/src/core/installers/clients/BaseClientInstaller.ts +341 -0
  22. package/src/core/installers/clients/ClientInstaller.ts +222 -0
  23. package/src/core/installers/clients/ClientInstallerFactory.ts +43 -0
  24. package/src/core/installers/clients/ClineInstaller.ts +35 -0
  25. package/src/core/installers/clients/ExtensionInstaller.ts +165 -0
  26. package/src/core/installers/clients/GithubCopilotInstaller.ts +79 -0
  27. package/src/core/installers/clients/MSRooCodeInstaller.ts +32 -0
  28. package/src/core/installers/index.ts +11 -0
  29. package/src/core/installers/requirements/BaseInstaller.ts +85 -0
  30. package/src/core/installers/requirements/CommandInstaller.ts +231 -0
  31. package/src/core/installers/requirements/GeneralInstaller.ts +133 -0
  32. package/src/core/installers/requirements/InstallerFactory.ts +114 -0
  33. package/src/core/installers/requirements/NpmInstaller.ts +271 -0
  34. package/src/core/installers/requirements/NugetInstaller.ts +203 -0
  35. package/src/core/installers/requirements/PipInstaller.ts +207 -0
  36. package/src/core/installers/requirements/RequirementInstaller.ts +42 -0
  37. package/src/core/loaders/ConfigurationLoader.ts +298 -0
  38. package/src/core/loaders/ConfigurationProvider.ts +462 -0
  39. package/src/core/loaders/InstallOperationManager.ts +367 -0
  40. package/src/core/loaders/ServerSchemaLoader.ts +117 -0
  41. package/src/core/loaders/ServerSchemaProvider.ts +99 -0
  42. package/src/core/loaders/SystemSettingsManager.ts +278 -0
  43. package/src/core/metadatas/constants.ts +122 -0
  44. package/src/core/metadatas/recordingConstants.ts +65 -0
  45. package/src/core/metadatas/types.ts +202 -0
  46. package/src/core/onboard/FeedOnboardService.ts +501 -0
  47. package/src/core/onboard/OnboardProcessor.ts +356 -0
  48. package/src/core/onboard/OnboardStatus.ts +60 -0
  49. package/src/core/onboard/OnboardStatusManager.ts +416 -0
  50. package/src/core/validators/FeedValidator.ts +135 -0
  51. package/src/core/validators/IServerValidator.ts +21 -0
  52. package/src/core/validators/SSEServerValidator.ts +43 -0
  53. package/src/core/validators/ServerValidatorFactory.ts +51 -0
  54. package/src/core/validators/StdioServerValidator.ts +313 -0
  55. package/src/index.ts +44 -0
  56. package/src/services/InstallationService.ts +102 -0
  57. package/src/services/MCPManager.ts +249 -0
  58. package/src/services/RequirementService.ts +627 -0
  59. package/src/services/ServerService.ts +161 -0
  60. package/src/services/TelemetryService.ts +59 -0
  61. package/src/utils/UpdateCheckTracker.ts +86 -0
  62. package/src/utils/adoUtils.ts +293 -0
  63. package/src/utils/clientUtils.ts +72 -0
  64. package/src/utils/feedUtils.ts +31 -0
  65. package/src/utils/githubAuth.ts +212 -0
  66. package/src/utils/githubUtils.ts +164 -0
  67. package/src/utils/logger.ts +195 -0
  68. package/src/utils/macroExpressionUtils.ts +104 -0
  69. package/src/utils/osUtils.ts +700 -0
  70. package/src/utils/versionUtils.ts +114 -0
  71. package/src/web/contract/serverContract.ts +74 -0
  72. package/src/web/public/css/detailsWidget.css +235 -0
  73. package/src/web/public/css/modal.css +757 -0
  74. package/src/web/public/css/notifications.css +101 -0
  75. package/src/web/public/css/onboard.css +107 -0
  76. package/src/web/public/css/serverCategoryList.css +120 -0
  77. package/src/web/public/css/serverDetails.css +139 -0
  78. package/src/web/public/index.html +359 -0
  79. package/src/web/public/js/api.js +132 -0
  80. package/src/web/public/js/detailsWidget.js +264 -0
  81. package/src/web/public/js/flights/flights.js +127 -0
  82. package/src/web/public/js/modal/index.js +52 -0
  83. package/src/web/public/js/modal/installModal.js +162 -0
  84. package/src/web/public/js/modal/installation.js +266 -0
  85. package/src/web/public/js/modal/loadingModal.js +182 -0
  86. package/src/web/public/js/modal/modalSetup.js +595 -0
  87. package/src/web/public/js/modal/modalUtils.js +37 -0
  88. package/src/web/public/js/modal/versionUtils.js +20 -0
  89. package/src/web/public/js/modal.js +42 -0
  90. package/src/web/public/js/notifications.js +137 -0
  91. package/src/web/public/js/onboard/formProcessor.js +1037 -0
  92. package/src/web/public/js/onboard/index.js +374 -0
  93. package/src/web/public/js/onboard/publishHandler.js +172 -0
  94. package/src/web/public/js/onboard/state.js +76 -0
  95. package/src/web/public/js/onboard/templates.js +342 -0
  96. package/src/web/public/js/onboard/uiHandlers.js +1076 -0
  97. package/src/web/public/js/onboard/validationHandlers.js +493 -0
  98. package/src/web/public/js/serverCategoryDetails.js +364 -0
  99. package/src/web/public/js/serverCategoryList.js +241 -0
  100. package/src/web/public/js/settings.js +314 -0
  101. package/src/web/public/modal.html +84 -0
  102. package/src/web/public/onboard.html +296 -0
  103. package/src/web/public/settings.html +135 -0
  104. package/src/web/public/styles.css +277 -0
  105. package/src/web/server.ts +478 -0
  106. package/tsconfig.json +18 -0
  107. package/wiki/Installation.md +3 -0
  108. package/wiki/Publish.md +3 -0
  109. package/dist/cli/commands/install.js.map +0 -1
  110. package/dist/cli/commands/list.js.map +0 -1
  111. package/dist/cli/commands/pull.js.map +0 -1
  112. package/dist/cli/commands/serve.js.map +0 -1
  113. package/dist/cli/commands/start.js.map +0 -1
  114. package/dist/cli/commands/sync.js.map +0 -1
  115. package/dist/cli/commands/uninstall.js.map +0 -1
  116. package/dist/cli/index.js.map +0 -1
  117. package/dist/core/ConfigurationLoader.js.map +0 -1
  118. package/dist/core/ConfigurationProvider.js.map +0 -1
  119. package/dist/core/InstallationService.js.map +0 -1
  120. package/dist/core/MCPManager.js.map +0 -1
  121. package/dist/core/RequirementService.js.map +0 -1
  122. package/dist/core/ServerSchemaLoader.js.map +0 -1
  123. package/dist/core/ServerSchemaProvider.js.map +0 -1
  124. package/dist/core/constants.js.map +0 -1
  125. package/dist/core/installers/BaseInstaller.js.map +0 -1
  126. package/dist/core/installers/ClientInstaller.js.map +0 -1
  127. package/dist/core/installers/CommandInstaller.js.map +0 -1
  128. package/dist/core/installers/GeneralInstaller.js.map +0 -1
  129. package/dist/core/installers/InstallerFactory.js.map +0 -1
  130. package/dist/core/installers/NpmInstaller.js.map +0 -1
  131. package/dist/core/installers/PipInstaller.js.map +0 -1
  132. package/dist/core/installers/RequirementInstaller.js.map +0 -1
  133. package/dist/core/installers/clients/BaseClientInstaller.js.map +0 -1
  134. package/dist/core/installers/clients/ClientInstaller.js.map +0 -1
  135. package/dist/core/installers/clients/ClientInstallerFactory.js.map +0 -1
  136. package/dist/core/installers/clients/ClineInstaller.js.map +0 -1
  137. package/dist/core/installers/clients/ExtensionInstaller.js.map +0 -1
  138. package/dist/core/installers/clients/GithubCopilotInstaller.js.map +0 -1
  139. package/dist/core/installers/clients/MSRooCodeInstaller.js.map +0 -1
  140. package/dist/core/installers/index.js.map +0 -1
  141. package/dist/core/installers/requirements/BaseInstaller.js.map +0 -1
  142. package/dist/core/installers/requirements/CommandInstaller.js.map +0 -1
  143. package/dist/core/installers/requirements/GeneralInstaller.js.map +0 -1
  144. package/dist/core/installers/requirements/InstallerFactory.js.map +0 -1
  145. package/dist/core/installers/requirements/NpmInstaller.js.map +0 -1
  146. package/dist/core/installers/requirements/NugetInstaller.js.map +0 -1
  147. package/dist/core/installers/requirements/PipInstaller.js.map +0 -1
  148. package/dist/core/installers/requirements/RequirementInstaller.js.map +0 -1
  149. package/dist/core/loaders/ConfigurationLoader.js.map +0 -1
  150. package/dist/core/loaders/ConfigurationProvider.js.map +0 -1
  151. package/dist/core/loaders/InstallOperationManager.js.map +0 -1
  152. package/dist/core/loaders/ServerSchemaLoader.js.map +0 -1
  153. package/dist/core/loaders/ServerSchemaProvider.js.map +0 -1
  154. package/dist/core/loaders/SystemSettingsManager.js.map +0 -1
  155. package/dist/core/metadatas/constants.js.map +0 -1
  156. package/dist/core/metadatas/recordingConstants.js.map +0 -1
  157. package/dist/core/metadatas/types.js.map +0 -1
  158. package/dist/core/onboard/FeedOnboardService.js.map +0 -1
  159. package/dist/core/onboard/OnboardProcessor.js.map +0 -1
  160. package/dist/core/onboard/OnboardStatus.js.map +0 -1
  161. package/dist/core/onboard/OnboardStatusManager.js.map +0 -1
  162. package/dist/core/types.js.map +0 -1
  163. package/dist/core/validators/FeedValidator.js.map +0 -1
  164. package/dist/core/validators/IServerValidator.js.map +0 -1
  165. package/dist/core/validators/SSEServerValidator.js.map +0 -1
  166. package/dist/core/validators/ServerValidatorFactory.js.map +0 -1
  167. package/dist/core/validators/StdioServerValidator.js.map +0 -1
  168. package/dist/index.js.map +0 -1
  169. package/dist/services/InstallRequestValidator.js.map +0 -1
  170. package/dist/services/InstallationService.js.map +0 -1
  171. package/dist/services/MCPManager.js.map +0 -1
  172. package/dist/services/RequirementService.js.map +0 -1
  173. package/dist/services/ServerService.js.map +0 -1
  174. package/dist/services/TelemetryService.js.map +0 -1
  175. package/dist/utils/UpdateCheckTracker.js.map +0 -1
  176. package/dist/utils/adoUtils.js.map +0 -1
  177. package/dist/utils/clientUtils.js.map +0 -1
  178. package/dist/utils/feedUtils.js.map +0 -1
  179. package/dist/utils/githubAuth.js.map +0 -1
  180. package/dist/utils/githubUtils.js.map +0 -1
  181. package/dist/utils/logger.js.map +0 -1
  182. package/dist/utils/macroExpressionUtils.js.map +0 -1
  183. package/dist/utils/osUtils.js.map +0 -1
  184. package/dist/utils/versionUtils.js.map +0 -1
  185. package/dist/web/contract/serverContract.js.map +0 -1
  186. package/dist/web/server.js.map +0 -1
@@ -0,0 +1,298 @@
1
+ import fs from 'fs/promises';
2
+ import path from 'path';
3
+ import { LOCAL_FEEDS_DIR, SUPPORTED_CLIENTS } from '../metadatas/constants.js';
4
+ import { Logger } from '../../utils/logger.js';
5
+ import { readJsonFile } from '../../utils/clientUtils.js';
6
+ import {
7
+ MCPConfiguration,
8
+ MCPServerCategory,
9
+ MCPServerStatus,
10
+ OperationStatus,
11
+ FeedConfiguration,
12
+ RequirementStatus,
13
+ InstallationStatus
14
+ } from '../metadatas/types.js';
15
+
16
+ export class ConfigurationLoader {
17
+ /**
18
+ * Updates the installed status for a server and client combination
19
+ */
20
+ private static updateServerInstalledStatus(
21
+ serverStatus: MCPServerStatus,
22
+ clientName: string,
23
+ operationStatus: OperationStatus
24
+ ): void {
25
+ if (!serverStatus.installedStatus) {
26
+ serverStatus.installedStatus = {};
27
+ }
28
+ serverStatus.installedStatus[clientName] = operationStatus;
29
+ }
30
+
31
+ /**
32
+ * Removes a client's status from a server
33
+ */
34
+ private static removeClientStatus(
35
+ serverStatus: MCPServerStatus,
36
+ clientName: string
37
+ ): void {
38
+ if (serverStatus.installedStatus && serverStatus.installedStatus[clientName]) {
39
+ delete serverStatus.installedStatus[clientName];
40
+ }
41
+ }
42
+
43
+ /**
44
+ * Synchronizes server categories with client MCP settings.
45
+ * Uses clientMCPSettings as source of truth for installation status.
46
+ */
47
+ static syncServerCategoriesWithClientSettings(configuration: MCPConfiguration): MCPConfiguration {
48
+ if (!configuration.clientMCPSettings) {
49
+ return configuration;
50
+ }
51
+
52
+ configuration.localServerCategories = configuration.localServerCategories.map(category => {
53
+ if (!category.installationStatus?.serversStatus) {
54
+ return category;
55
+ }
56
+
57
+ const updatedServerStatus = { ...category.installationStatus.serversStatus };
58
+ const clientSettings = configuration.clientMCPSettings as Record<string, Record<string, any>>;
59
+
60
+ for (const [clientName, settings] of Object.entries(clientSettings)) {
61
+ const clientServers = clientName === 'GithubCopilot'
62
+ ? settings.servers || {}
63
+ : settings.mcpServers || {};
64
+
65
+ Object.keys(updatedServerStatus).forEach(serverName => {
66
+ if (clientServers[serverName]) {
67
+ if (!updatedServerStatus[serverName].installedStatus[clientName]) {
68
+ const operationStatus: OperationStatus = {
69
+ status: 'completed',
70
+ type: 'install',
71
+ target: 'server',
72
+ message: `Server ${serverName} is configured for client ${clientName}`
73
+ };
74
+ ConfigurationLoader.updateServerInstalledStatus(updatedServerStatus[serverName], clientName, operationStatus);
75
+ }
76
+ } else {
77
+ ConfigurationLoader.removeClientStatus(updatedServerStatus[serverName], clientName);
78
+ }
79
+ });
80
+ }
81
+
82
+ return {
83
+ ...category,
84
+ installationStatus: {
85
+ ...category.installationStatus,
86
+ serversStatus: updatedServerStatus,
87
+ lastUpdated: new Date().toISOString()
88
+ }
89
+ };
90
+ });
91
+
92
+ return configuration;
93
+ }
94
+
95
+ /**
96
+ * Initializes installation status for a feed configuration
97
+ */
98
+ private static initializeInstallationStatus(feedConfig?: FeedConfiguration): InstallationStatus {
99
+ const requirementsStatus: Record<string, RequirementStatus> = {};
100
+ const serversStatus: Record<string, MCPServerStatus> = {};
101
+
102
+ if (feedConfig) {
103
+ if (feedConfig.requirements) {
104
+ for (const req of feedConfig.requirements) {
105
+ requirementsStatus[req.name] = {
106
+ name: req.name,
107
+ type: req.type,
108
+ installed: false,
109
+ version: req.version,
110
+ error: undefined
111
+ };
112
+ }
113
+ }
114
+ if (feedConfig.mcpServers) {
115
+ for (const mcp of feedConfig.mcpServers) {
116
+ serversStatus[mcp.name] = {
117
+ name: mcp.name,
118
+ error: undefined,
119
+ installedStatus: {}
120
+ };
121
+ }
122
+ }
123
+ }
124
+
125
+ return {
126
+ requirementsStatus,
127
+ serversStatus,
128
+ lastUpdated: new Date().toISOString()
129
+ };
130
+ }
131
+
132
+ /**
133
+ * Synchronizes server categories with feeds
134
+ */
135
+ private static async syncServerCategoriesWithFeeds(configuration: MCPConfiguration): Promise<MCPConfiguration> {
136
+ // Filter out categories that don't have corresponding feeds and update existing ones
137
+ configuration.localServerCategories = configuration.localServerCategories
138
+ .filter(server => configuration.feeds[server.name])
139
+ .map(server => {
140
+ server.feedConfiguration = configuration.feeds[server.name];
141
+
142
+ if (
143
+ !server.installationStatus ||
144
+ !server.installationStatus.requirementsStatus ||
145
+ Object.keys(server.installationStatus.requirementsStatus).length === 0 ||
146
+ !server.installationStatus.serversStatus ||
147
+ Object.keys(server.installationStatus.serversStatus).length < Object.keys(server.feedConfiguration?.mcpServers || []).length
148
+ ) {
149
+ server.installationStatus = ConfigurationLoader.initializeInstallationStatus(server.feedConfiguration);
150
+ }
151
+
152
+ return server;
153
+ });
154
+
155
+ // Add new categories for feeds that don't have a corresponding category
156
+ const existingServerNames = new Set(configuration.localServerCategories.map(category => category.name));
157
+
158
+ for (const [feedName, feedConfig] of Object.entries(configuration.feeds)) {
159
+ if (!existingServerNames.has(feedName)) {
160
+ const newServerCategory: MCPServerCategory = {
161
+ name: feedName,
162
+ displayName: feedConfig.displayName || feedName,
163
+ type: 'local',
164
+ description: feedConfig.description || `Local MCP server category: ${feedName}`,
165
+ installationStatus: ConfigurationLoader.initializeInstallationStatus(feedConfig),
166
+ feedConfiguration: feedConfig
167
+ };
168
+
169
+ configuration.localServerCategories.push(newServerCategory);
170
+ console.log(`Created new local server entry for feed: ${feedName}`);
171
+ }
172
+ }
173
+
174
+ return configuration;
175
+ }
176
+
177
+ /**
178
+ * Loads feed configurations into the MCP configuration
179
+ */
180
+ static async loadFeedsIntoConfiguration(configuration: MCPConfiguration, feedFile?: string, settings?: { prLink?:string, adhocServers?: string[] }): Promise<MCPConfiguration> {
181
+ try {
182
+ await fs.mkdir(LOCAL_FEEDS_DIR, { recursive: true });
183
+ const feeds: Record<string, FeedConfiguration> = {};
184
+
185
+ // Load provided feed file if specified
186
+ if (feedFile) {
187
+ try {
188
+ const content = await fs.readFile(feedFile, 'utf8');
189
+ let config = JSON.parse(content) as FeedConfiguration;
190
+ if (config && config.name) {
191
+ // Update systemTags if feedFile is provided
192
+ if (!config.systemTags) {
193
+ config.systemTags = {};
194
+ }
195
+ config.systemTags['adhoc'] = 'true';
196
+
197
+ // Update PullRequest if prLink is provided in settings
198
+ if (settings?.prLink) {
199
+ config.PullRequest = settings.prLink;
200
+ }
201
+
202
+ // Update mcpServers systemTags if adhocServers are provided in settings
203
+ if (settings?.adhocServers && settings.adhocServers.length > 0 && config.mcpServers) {
204
+ config.mcpServers = config.mcpServers.map(server => {
205
+ if (settings.adhocServers!.includes(server.name)) {
206
+ if (!server.systemTags) {
207
+ server.systemTags = {};
208
+ }
209
+ server.systemTags['adhoc'] = 'true';
210
+ }
211
+ return server;
212
+ });
213
+ }
214
+
215
+ feeds[config.name] = config;
216
+ console.log(`Loaded and processed feed configuration from provided file: ${feedFile}`);
217
+ }
218
+ } catch (error) {
219
+ console.log(`Error loading feed configuration from provided file ${feedFile}:`, error);
220
+ }
221
+ }
222
+
223
+ // Load feeds from LOCAL_FEEDS_DIR
224
+ const files = await fs.readdir(LOCAL_FEEDS_DIR);
225
+ const jsonFiles = files.filter(file => file.endsWith('.json'));
226
+
227
+ if (jsonFiles.length === 0 && !feedFile) {
228
+ console.log(`No feed configuration files found in ${LOCAL_FEEDS_DIR}`);
229
+ return configuration;
230
+ }
231
+
232
+ for (const file of jsonFiles) {
233
+ try {
234
+ const filePath = path.join(LOCAL_FEEDS_DIR, file);
235
+ const content = await fs.readFile(filePath, 'utf8');
236
+ const config = JSON.parse(content) as FeedConfiguration;
237
+ if (config && config.name) {
238
+ // If feed exists from provided file, skip the local one
239
+ if (!feeds[config.name]) {
240
+ feeds[config.name] = config;
241
+ } else {
242
+ console.log(`Skipping local feed ${config.name} as it was provided via --feed-file`);
243
+ }
244
+ }
245
+ } catch (error) {
246
+ console.warn(`Error loading feed configuration from ${file}:`, error);
247
+ }
248
+ }
249
+
250
+ configuration.feeds = feeds;
251
+ return await ConfigurationLoader.syncServerCategoriesWithFeeds(configuration);
252
+ } catch (error) {
253
+ console.error("Error loading feed configurations:", error);
254
+ throw error;
255
+ }
256
+ }
257
+
258
+ /**
259
+ * Loads MCP client settings into the configuration
260
+ */
261
+ static async loadClientMCPSettings(configuration: MCPConfiguration): Promise<MCPConfiguration> {
262
+ try {
263
+ Logger.debug('Starting to load MCP client settings...');
264
+ const settings: Record<string, Record<string, any>> = {};
265
+
266
+ for (const [clientName, clientSettings] of Object.entries(SUPPORTED_CLIENTS)) {
267
+ const settingPath = process.env.CODE_INSIDERS
268
+ ? clientSettings.codeInsiderSettingPath
269
+ : clientSettings.codeSettingPath;
270
+ try {
271
+ let content = await readJsonFile(settingPath, true);
272
+
273
+ if (clientName === 'GithubCopilot') {
274
+ if (!content.mcp) {
275
+ content = {
276
+ servers: {},
277
+ inputs: []
278
+ };
279
+ } else {
280
+ content = content.mcp;
281
+ }
282
+ }
283
+ settings[clientName] = content;
284
+ Logger.debug(`Successfully loaded MCP settings for ${clientName}`);
285
+ } catch (error) {
286
+ Logger.debug(`Warning: Could not load MCP settings for client ${clientName}: ${error instanceof Error ? error.message : String(error)}`);
287
+ settings[clientName] = {};
288
+ }
289
+ }
290
+
291
+ configuration.clientMCPSettings = settings;
292
+ return ConfigurationLoader.syncServerCategoriesWithClientSettings(configuration);
293
+ } catch (error) {
294
+ Logger.error('Error loading client MCP settings:', error);
295
+ throw error;
296
+ }
297
+ }
298
+ }