imcp 0.0.18 → 0.1.1

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 (96) hide show
  1. package/.roo/rules-code/rules.md +88 -0
  2. package/dist/cli/index.js +0 -0
  3. package/dist/core/metadatas/constants.d.ts +7 -0
  4. package/dist/core/metadatas/constants.js +7 -0
  5. package/dist/core/onboard/FeedOnboardService.d.ts +7 -3
  6. package/dist/core/onboard/FeedOnboardService.js +52 -5
  7. package/dist/core/onboard/OnboardProcessor.js +22 -22
  8. package/dist/services/MCPManager.js +66 -6
  9. package/dist/services/TelemetryService.d.ts +15 -0
  10. package/dist/services/TelemetryService.js +54 -0
  11. package/dist/utils/githubAuth.js +65 -0
  12. package/dist/utils/logger.d.ts +16 -0
  13. package/dist/utils/logger.js +78 -1
  14. package/dist/utils/versionUtils.d.ts +1 -0
  15. package/dist/utils/versionUtils.js +29 -0
  16. package/dist/web/public/css/serverCategoryList.css +120 -0
  17. package/dist/web/public/index.html +6 -3
  18. package/dist/web/public/js/flights/flights.js +0 -1
  19. package/dist/web/public/js/onboard/formProcessor.js +18 -11
  20. package/dist/web/public/js/onboard/publishHandler.js +30 -0
  21. package/dist/web/public/js/onboard/templates.js +5 -1
  22. package/dist/web/public/js/onboard/uiHandlers.js +266 -39
  23. package/dist/web/public/js/onboard/validationHandlers.js +71 -39
  24. package/dist/web/public/js/serverCategoryList.js +91 -7
  25. package/dist/web/public/onboard.html +2 -2
  26. package/dist/web/server.js +11 -1
  27. package/{src/web/public/js/onboard → docs}/ONBOARDING_PAGE_DESIGN.md +15 -125
  28. package/docs/Telemetry.md +136 -0
  29. package/memory-bank/activeContext.md +14 -0
  30. package/memory-bank/decisionLog.md +28 -0
  31. package/memory-bank/productContext.md +41 -0
  32. package/memory-bank/progress.md +5 -0
  33. package/memory-bank/systemPatterns.md +3 -0
  34. package/package.json +2 -1
  35. package/src/core/metadatas/constants.ts +9 -0
  36. package/src/core/onboard/FeedOnboardService.ts +59 -5
  37. package/src/core/onboard/OnboardProcessor.ts +25 -23
  38. package/src/services/MCPManager.ts +78 -8
  39. package/src/services/TelemetryService.ts +59 -0
  40. package/src/utils/githubAuth.ts +84 -1
  41. package/src/utils/logger.ts +83 -1
  42. package/src/utils/versionUtils.ts +33 -0
  43. package/src/web/public/css/serverCategoryList.css +120 -0
  44. package/src/web/public/index.html +6 -3
  45. package/src/web/public/js/onboard/formProcessor.js +18 -11
  46. package/src/web/public/js/onboard/publishHandler.js +30 -0
  47. package/src/web/public/js/onboard/templates.js +5 -1
  48. package/src/web/public/js/onboard/uiHandlers.js +266 -39
  49. package/src/web/public/js/onboard/validationHandlers.js +71 -39
  50. package/src/web/public/js/serverCategoryList.js +91 -7
  51. package/src/web/public/onboard.html +2 -2
  52. package/src/web/server.ts +11 -1
  53. package/dist/cli/commands/start.d.ts +0 -2
  54. package/dist/cli/commands/start.js +0 -32
  55. package/dist/cli/commands/sync.d.ts +0 -2
  56. package/dist/cli/commands/sync.js +0 -17
  57. package/dist/core/ConfigurationLoader.d.ts +0 -32
  58. package/dist/core/ConfigurationLoader.js +0 -236
  59. package/dist/core/ConfigurationProvider.d.ts +0 -35
  60. package/dist/core/ConfigurationProvider.js +0 -375
  61. package/dist/core/InstallationService.d.ts +0 -50
  62. package/dist/core/InstallationService.js +0 -350
  63. package/dist/core/MCPManager.d.ts +0 -28
  64. package/dist/core/MCPManager.js +0 -188
  65. package/dist/core/RequirementService.d.ts +0 -40
  66. package/dist/core/RequirementService.js +0 -110
  67. package/dist/core/ServerSchemaLoader.d.ts +0 -11
  68. package/dist/core/ServerSchemaLoader.js +0 -43
  69. package/dist/core/ServerSchemaProvider.d.ts +0 -17
  70. package/dist/core/ServerSchemaProvider.js +0 -120
  71. package/dist/core/constants.d.ts +0 -47
  72. package/dist/core/constants.js +0 -94
  73. package/dist/core/installers/BaseInstaller.d.ts +0 -74
  74. package/dist/core/installers/BaseInstaller.js +0 -253
  75. package/dist/core/installers/ClientInstaller.d.ts +0 -23
  76. package/dist/core/installers/ClientInstaller.js +0 -564
  77. package/dist/core/installers/CommandInstaller.d.ts +0 -37
  78. package/dist/core/installers/CommandInstaller.js +0 -173
  79. package/dist/core/installers/GeneralInstaller.d.ts +0 -33
  80. package/dist/core/installers/GeneralInstaller.js +0 -85
  81. package/dist/core/installers/InstallerFactory.d.ts +0 -54
  82. package/dist/core/installers/InstallerFactory.js +0 -97
  83. package/dist/core/installers/NpmInstaller.d.ts +0 -26
  84. package/dist/core/installers/NpmInstaller.js +0 -127
  85. package/dist/core/installers/PipInstaller.d.ts +0 -28
  86. package/dist/core/installers/PipInstaller.js +0 -127
  87. package/dist/core/installers/RequirementInstaller.d.ts +0 -33
  88. package/dist/core/installers/RequirementInstaller.js +0 -3
  89. package/dist/core/types.d.ts +0 -166
  90. package/dist/core/types.js +0 -16
  91. package/dist/services/InstallRequestValidator.d.ts +0 -21
  92. package/dist/services/InstallRequestValidator.js +0 -99
  93. package/dist/web/public/js/modal/installHandler.js +0 -227
  94. package/dist/web/public/js/modal/loadingUI.js +0 -74
  95. package/dist/web/public/js/modal/modalUI.js +0 -214
  96. package/dist/web/public/js/modal/version.js +0 -20
@@ -1,375 +0,0 @@
1
- import fs from 'fs/promises';
2
- import path from 'path';
3
- import { exec } from 'child_process';
4
- import { promisify } from 'util';
5
- import { fileURLToPath } from 'url';
6
- import { GITHUB_REPO, LOCAL_FEEDS_DIR, SETTINGS_DIR, SUPPORTED_CLIENTS } from './constants.js';
7
- import { Logger } from '../utils/logger.js';
8
- import { checkGithubAuth } from '../utils/githubAuth.js';
9
- import { ConfigurationLoader } from './ConfigurationLoader.js';
10
- const execAsync = promisify(exec);
11
- const __dirname = path.dirname(fileURLToPath(import.meta.url));
12
- export class ConfigurationProvider {
13
- static instance;
14
- configPath;
15
- configuration;
16
- configLock = Promise.resolve();
17
- tempDir;
18
- constructor() {
19
- // Initialize configuration in user's appdata/imcp directory
20
- this.configPath = path.join(SETTINGS_DIR, 'configurations.json');
21
- this.configuration = {
22
- localServerCategories: [],
23
- feeds: {},
24
- clientMCPSettings: {}
25
- };
26
- this.tempDir = path.join(LOCAL_FEEDS_DIR, '../temp');
27
- }
28
- static getInstance() {
29
- if (!ConfigurationProvider.instance) {
30
- ConfigurationProvider.instance = new ConfigurationProvider();
31
- }
32
- return ConfigurationProvider.instance;
33
- }
34
- async withLock(operation) {
35
- const current = this.configLock;
36
- let resolve;
37
- this.configLock = new Promise(r => resolve = r);
38
- try {
39
- await current;
40
- return await operation();
41
- }
42
- finally {
43
- resolve();
44
- }
45
- }
46
- async initialize(feedFile) {
47
- await this.withLock(async () => {
48
- const configDir = path.dirname(this.configPath);
49
- await fs.mkdir(configDir, { recursive: true });
50
- try {
51
- try {
52
- const config = JSON.parse(await fs.readFile(this.configPath, 'utf8'));
53
- this.configuration = config;
54
- }
55
- catch (error) {
56
- if (error.code !== 'ENOENT') {
57
- throw error;
58
- }
59
- // File doesn't exist, use default empty configuration
60
- await this.saveConfiguration();
61
- }
62
- // Always load feeds and client settings, whether file existed or not
63
- await this.loadFeedsIntoConfiguration(feedFile);
64
- await this.loadClientMCPSettings();
65
- }
66
- catch (error) {
67
- Logger.error('Error during initialization', error);
68
- throw error;
69
- }
70
- });
71
- }
72
- async saveConfiguration() {
73
- const configDir = path.dirname(this.configPath);
74
- await fs.mkdir(configDir, { recursive: true });
75
- await fs.writeFile(this.configPath, JSON.stringify(this.configuration, null, 2));
76
- }
77
- async getServerCategories() {
78
- return await this.withLock(async () => {
79
- return this.configuration.localServerCategories;
80
- });
81
- }
82
- async getServerCategory(categoryName) {
83
- return await this.withLock(async () => {
84
- return this.configuration.localServerCategories.find(s => s.name === categoryName);
85
- });
86
- }
87
- async getClientMcpSettings() {
88
- return await this.withLock(async () => {
89
- return this.configuration.clientMCPSettings;
90
- });
91
- }
92
- async getFeedConfiguration(categoryName) {
93
- return await this.withLock(async () => {
94
- return this.configuration.feeds[categoryName];
95
- });
96
- }
97
- async getServerMcpConfig(categoryName, serverName) {
98
- return await this.withLock(async () => {
99
- return this.configuration.feeds[categoryName]?.mcpServers.find(s => s.name === serverName);
100
- });
101
- }
102
- async getInstallationStatus(categoryName) {
103
- return await this.withLock(async () => {
104
- // Inline getServerCategory logic
105
- const category = this.configuration.localServerCategories.find(s => s.name === categoryName);
106
- return category?.installationStatus;
107
- });
108
- }
109
- async getServerStatus(categoryName, serverName) {
110
- return await this.withLock(async () => {
111
- // Inline getInstallationStatus logic
112
- const category = this.configuration.localServerCategories.find(s => s.name === categoryName);
113
- const status = category?.installationStatus;
114
- return status?.serversStatus[serverName];
115
- });
116
- }
117
- async getRequirementStatus(categoryName, requirementName) {
118
- return await this.withLock(async () => {
119
- // Inline getInstallationStatus logic
120
- const category = this.configuration.localServerCategories.find(s => s.name === categoryName);
121
- const status = category?.installationStatus;
122
- return status?.requirementsStatus[requirementName];
123
- });
124
- }
125
- async updateInstallationStatus(categoryName, requirementStatus, serverStatus) {
126
- return await this.withLock(async () => {
127
- // Inline getServerCategory logic
128
- const category = this.configuration.localServerCategories.find(s => s.name === categoryName);
129
- if (!category)
130
- return false;
131
- if (!category.installationStatus) {
132
- category.installationStatus = {
133
- requirementsStatus: {},
134
- serversStatus: {},
135
- lastUpdated: new Date().toISOString()
136
- };
137
- }
138
- category.installationStatus.requirementsStatus = {
139
- ...category.installationStatus.requirementsStatus,
140
- ...requirementStatus
141
- };
142
- category.installationStatus.serversStatus = {
143
- ...category.installationStatus.serversStatus,
144
- ...serverStatus
145
- };
146
- category.installationStatus.lastUpdated = new Date().toISOString();
147
- await this.saveConfiguration();
148
- return true;
149
- });
150
- }
151
- async updateRequirementStatus(categoryName, requirementName, status) {
152
- return await this.withLock(async () => {
153
- // Inline getServerCategory logic
154
- const category = this.configuration.localServerCategories.find(s => s.name === categoryName);
155
- if (!category?.installationStatus)
156
- return false;
157
- category.installationStatus.requirementsStatus[requirementName] = status;
158
- category.installationStatus.lastUpdated = new Date().toISOString();
159
- await this.saveConfiguration();
160
- return true;
161
- });
162
- }
163
- async updateRequirementOperationStatus(categoryName, requirementName, operationStatus) {
164
- return await this.withLock(async () => {
165
- // Inline getServerCategory logic
166
- const category = this.configuration.localServerCategories.find(s => s.name === categoryName);
167
- if (!category?.installationStatus?.requirementsStatus[requirementName])
168
- return false;
169
- category.installationStatus.requirementsStatus[requirementName].operationStatus = operationStatus;
170
- category.installationStatus.lastUpdated = new Date().toISOString();
171
- await this.saveConfiguration();
172
- return true;
173
- });
174
- }
175
- async updateServerStatus(categoryName, serverName, status) {
176
- return await this.withLock(async () => {
177
- // Inline getServerCategory logic
178
- const category = this.configuration.localServerCategories.find(s => s.name === categoryName);
179
- if (!category?.installationStatus)
180
- return false;
181
- category.installationStatus.serversStatus[serverName] = status;
182
- category.installationStatus.lastUpdated = new Date().toISOString();
183
- await this.saveConfiguration();
184
- return true;
185
- });
186
- }
187
- async updateServerOperationStatus(categoryName, serverName, clientName, operationStatus) {
188
- return await this.withLock(async () => {
189
- // Inline getServerCategory logic
190
- const category = this.configuration.localServerCategories.find(s => s.name === categoryName);
191
- if (!category?.installationStatus?.serversStatus[serverName])
192
- return false;
193
- category.installationStatus.serversStatus[serverName].installedStatus[clientName] = operationStatus;
194
- category.installationStatus.lastUpdated = new Date().toISOString();
195
- await this.saveConfiguration();
196
- return true;
197
- });
198
- }
199
- async isRequirementsReady(categoryName, serverName) {
200
- return await this.withLock(async () => {
201
- // Inline getServerCategory logic
202
- const category = this.configuration.localServerCategories.find(s => s.name === categoryName);
203
- if (!category?.feedConfiguration)
204
- return false;
205
- const serverConfig = category.feedConfiguration.mcpServers.find(s => s.name === serverName);
206
- if (!serverConfig?.dependencies?.requirements)
207
- return true; // No requirements means ready
208
- const requirementNames = serverConfig.dependencies.requirements.map(r => r.name);
209
- // Inline getInstallationStatus logic (using the already fetched category)
210
- const status = category?.installationStatus;
211
- if (!status?.requirementsStatus)
212
- return false;
213
- return requirementNames.every(name => {
214
- const reqStatus = status.requirementsStatus[name];
215
- return reqStatus?.installed && !reqStatus?.error;
216
- });
217
- });
218
- }
219
- async GetServerRequirementStatus(categoryName, serverName) {
220
- return await this.withLock(async () => {
221
- // Inline getServerCategory logic
222
- const category = this.configuration.localServerCategories.find(s => s.name === categoryName);
223
- if (!category?.feedConfiguration)
224
- return [];
225
- const serverConfig = category.feedConfiguration.mcpServers.find(s => s.name === serverName);
226
- if (!serverConfig?.dependencies?.requirements)
227
- return [];
228
- const requirementNames = serverConfig.dependencies.requirements.map(r => r.name);
229
- return requirementNames
230
- .map(name => category?.installationStatus?.requirementsStatus[name])
231
- .filter(x => x !== undefined);
232
- });
233
- }
234
- async isServerReady(categoryName, serverName, clients) {
235
- return await this.withLock(async () => {
236
- // Inline the logic from getServerStatus and getInstallationStatus to avoid nested lock
237
- const category = this.configuration.localServerCategories.find(s => s.name === categoryName);
238
- const installationStatus = category?.installationStatus;
239
- const serverStatus = installationStatus?.serversStatus[serverName];
240
- if (!serverStatus)
241
- return false;
242
- return clients.every(clientName => {
243
- // Add optional chaining for safety in case installedStatus is missing
244
- const clientStatus = serverStatus.installedStatus?.[clientName];
245
- return clientStatus?.status === 'completed' && !clientStatus?.error;
246
- });
247
- });
248
- }
249
- async syncFeeds() {
250
- return await this.withLock(async () => {
251
- Logger.log('Starting feed synchronization...');
252
- try {
253
- // Check GitHub authentication first
254
- await checkGithubAuth();
255
- Logger.debug({
256
- action: 'create_directories',
257
- paths: {
258
- localFeeds: LOCAL_FEEDS_DIR,
259
- tempDir: this.tempDir
260
- }
261
- });
262
- await fs.mkdir(LOCAL_FEEDS_DIR, { recursive: true });
263
- await fs.mkdir(this.tempDir, { recursive: true });
264
- // Clean up temp directory
265
- await fs.rm(this.tempDir, { recursive: true, force: true });
266
- // Download latest release
267
- Logger.debug('Downloading latest release...');
268
- const { downloadGithubRelease } = await import('../utils/githubUtils.js');
269
- const { version, downloadPath } = await downloadGithubRelease(GITHUB_REPO.repoName, 'latest', GITHUB_REPO.feedAssetsName, undefined, true, this.tempDir);
270
- Logger.debug({
271
- action: 'download_release',
272
- downloadPath,
273
- version,
274
- repoName: GITHUB_REPO.repoName,
275
- });
276
- Logger.debug('Updating local feeds...');
277
- await fs.rm(LOCAL_FEEDS_DIR, { recursive: true, force: true });
278
- const sourceFeedsDir = downloadPath;
279
- try {
280
- await fs.access(downloadPath);
281
- }
282
- catch (err) {
283
- throw new Error(`Could not find feeds directory in downloaded path: ${sourceFeedsDir}`);
284
- }
285
- await fs.cp(sourceFeedsDir, LOCAL_FEEDS_DIR, { recursive: true, force: true });
286
- Logger.log('Successfully updated local feeds');
287
- }
288
- catch (error) {
289
- Logger.error('Error during feed synchronization', error);
290
- throw new Error('Failed to sync feeds. Use --verbose for detailed error information.');
291
- }
292
- });
293
- }
294
- async loadFeedsIntoConfiguration(feedFile) {
295
- this.configuration = await ConfigurationLoader.loadFeedsIntoConfiguration(this.configuration, feedFile);
296
- await this.saveConfiguration();
297
- }
298
- async loadClientMCPSettings() {
299
- this.configuration = await ConfigurationLoader.loadClientMCPSettings(this.configuration);
300
- await this.saveConfiguration();
301
- }
302
- // Public method to reload client MCP settings
303
- async reloadClientMCPSettings() {
304
- return await this.withLock(async () => {
305
- await this.loadClientMCPSettings();
306
- });
307
- }
308
- async removeServerFromClientMCPSettings(serverName, target) {
309
- return await this.withLock(async () => {
310
- // Load utils in async context to avoid circular dependencies
311
- const { readJsonFile, writeJsonFile } = await import('../utils/clientUtils.js');
312
- // Filter clients if target is specified
313
- const clientEntries = Object.entries(SUPPORTED_CLIENTS);
314
- const targetClients = target
315
- ? clientEntries.filter(([clientName]) => clientName === target)
316
- : clientEntries;
317
- for (const [clientName, clientSettings] of targetClients) {
318
- const settingPath = process.env.CODE_INSIDERS
319
- ? clientSettings.codeInsiderSettingPath
320
- : clientSettings.codeSettingPath;
321
- try {
322
- const content = await readJsonFile(settingPath, true);
323
- let modified = false;
324
- // Handle GitHub Copilot's different structure
325
- if (clientName === 'GithubCopilot' && content.mcp?.servers?.[serverName]) {
326
- delete content.mcp.servers[serverName];
327
- modified = true;
328
- }
329
- else if (content.mcpServers?.[serverName]) {
330
- delete content.mcpServers[serverName];
331
- modified = true;
332
- }
333
- // Only write if we actually modified the content
334
- if (modified) {
335
- await writeJsonFile(settingPath, content);
336
- Logger.debug(`Removed server ${serverName} from client ${clientName} settings`);
337
- }
338
- }
339
- catch (error) {
340
- Logger.error(`Failed to remove server ${serverName} from client ${clientName} settings:`, error);
341
- }
342
- }
343
- // Also update our in-memory configuration
344
- if (this.configuration.clientMCPSettings) {
345
- if (target) {
346
- // Only update settings for the target client
347
- const clientSettings = this.configuration.clientMCPSettings[target];
348
- if (clientSettings) {
349
- if (clientSettings.mcpServers?.[serverName]) {
350
- delete clientSettings.mcpServers[serverName];
351
- }
352
- if (clientSettings.servers?.[serverName]) { // For GitHub Copilot
353
- delete clientSettings.servers[serverName];
354
- }
355
- }
356
- }
357
- else {
358
- // Update all clients if no target specified
359
- for (const clientSettings of Object.values(this.configuration.clientMCPSettings)) {
360
- if (clientSettings.mcpServers?.[serverName]) {
361
- delete clientSettings.mcpServers[serverName];
362
- }
363
- if (clientSettings.servers?.[serverName]) { // For GitHub Copilot
364
- delete clientSettings.servers[serverName];
365
- }
366
- }
367
- }
368
- await this.saveConfiguration();
369
- }
370
- });
371
- }
372
- }
373
- // Export a singleton instance
374
- export const configProvider = ConfigurationProvider.getInstance();
375
- //# sourceMappingURL=ConfigurationProvider.js.map
@@ -1,50 +0,0 @@
1
- import { ServerInstallOptions, ServerOperationResult } from './types.js';
2
- /**
3
- * Handles the actual installation process for an MCP server.
4
- */
5
- export declare class InstallationService {
6
- private activeInstallations;
7
- private installerFactory;
8
- constructor();
9
- private generateOperationId;
10
- /**
11
- * Installs a server based on the provided options and feed configuration.
12
- * @param serverName The name of the server to install.
13
- * @param options The installation options.
14
- * @returns A result object indicating success or failure.
15
- */
16
- install(categoryName: string, serverName: string, options: ServerInstallOptions): Promise<ServerOperationResult>;
17
- /**
18
- * Process requirement updates specified in serverInstallOptions
19
- * All updates are processed in parallel for maximum efficiency
20
- * @param categoryName The category name
21
- * @param serverName The server name
22
- * @param requirements The requirements to update
23
- */
24
- private processRequirementUpdates;
25
- /**
26
- * Checks and installs requirements for a server if needed
27
- * @param categoryName The category name
28
- * @param serverName The server name
29
- * @param options The installation options
30
- * @returns A failure result if requirements check fails, null if requirements are satisfied
31
- */
32
- private checkAndInstallRequirements;
33
- /**
34
- * Installs requirements in background without blocking the main thread
35
- * Requirements with the same order are installed in parallel
36
- */
37
- private installRequirementsInBackground;
38
- /**
39
- * Helper to update requirement status for failure case
40
- */
41
- private updateRequirementFailureStatus;
42
- /**
43
- * Helper to update requirement status for in-progress case
44
- */
45
- private updateRequirementProgressStatus;
46
- /**
47
- * Helper to update requirement status for completion case
48
- */
49
- private updateRequirementCompletionStatus;
50
- }