@mxf-dev/core 1.0.0 → 2.0.0

package/src/protocols/mcp/services/ExternalServerConfigs.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  *
  * @author Brad Anderson <BradA1878@pm.me>
- * @repository https://github.com/mxf-dev/mxf
+ * @repository https://github.com/BradA1878/model-exchange-framework
  * @documentation https://mxf-dev.github.io/mxf/
  */
 
@@ -26,8 +26,8 @@
  */
 
 import * as path from 'path';
-import * as os from 'os';
 import { ExternalServerConfig } from './ExternalMcpServerManager.js';
+import { getWorkspaceRoot } from '../security/McpToolPolicy.js';
 
 /**
  * Configuration for the Calculator MCP Server
@@ -72,28 +72,34 @@ export const SEQUENTIAL_THINKING_SERVER_CONFIG: ExternalServerConfig = {
 };
 
 /**
- * Configuration for the Filesystem MCP Server
- * Provides secure file operations with access controls
- * 
- * NOTE: Configured to allow access to project root directory.
- * The server receives the current working directory as an allowed path.
+ * Configuration for the Filesystem MCP Server.
+ *
+ * The allowed roots are the configured workspace directory plus a scratch
+ * directory. This used to pass `os.homedir()`, which handed every agent read
+ * access to the entire home directory — including ~/.ssh, ~/.aws, and
+ * ~/.mxf/config.json, which is where the MXF CLI stores its own credentials.
+ *
+ * The server only auto-starts when MXF_WORKSPACE_ROOT is set. There is no default:
+ * a filesystem server needs an operator to say which directory agents may touch,
+ * and the previous default answered that question with "all of them".
  */
 export const FILESYSTEM_SERVER_CONFIG: ExternalServerConfig = {
     id: 'filesystem',
     name: 'Filesystem Server',
     version: '0.6.0',
-    description: 'Secure file operations with configurable access controls',
+    description: 'File operations scoped to the configured workspace directory',
     command: 'npx',
-    // MCP filesystem server accepts multiple allowed directory paths as args.
-    // Include the user's home directory so agents can access any folder the
-    // user selects as their working directory (e.g., via the desktop folder picker).
+    // The MCP filesystem server takes its allowed directories as positional args.
     args: [
         '-y',
         '@modelcontextprotocol/server-filesystem',
-        os.homedir(),   // Allow access to user's home directory (covers any selected folder)
-        '/tmp'          // Also allow /tmp for temporary files
-    ],
-    autoStart: true, // Enable auto-start for file operations
+        // Empty when unset. getFilesystemServerConfig() below is what callers
+        // should use — it fails fast rather than spawning a server with no root.
+        getWorkspaceRoot() ?? '',
+        '/tmp/mcp-workspace'
+    ].filter(arg => arg.length > 0),
+    // Only auto-start when a workspace is configured.
+    autoStart: getWorkspaceRoot() !== undefined,
     restartOnCrash: true,
     healthCheckInterval: 30000,
     maxRestartAttempts: 3,
@@ -169,24 +175,45 @@ export const MEMORY_SERVER_CONFIG: ExternalServerConfig = {
 };
 
 /**
- * Configuration for the MongoDB Lens MCP Server
- * Provides database schema analysis, query optimization, and MongoDB intelligence
+ * Configuration for the MongoDB Lens MCP Server.
+ *
+ * OFF by default, and it must stay that way unless you have pointed it somewhere
+ * safe.
+ *
+ * This server hands agents a query interface to whatever MONGODB_URI names. In a
+ * default MXF deployment that is the framework's own database — the one holding
+ * the users collection, personal access tokens, and agent API keys. It used to
+ * auto-start against exactly that.
+ *
+ * To enable it:
+ *   1. Create a MongoDB user with read-only access to a SEPARATE database — not
+ *      the one MXF stores its credentials in.
+ *   2. Set MONGODB_LENS_URI to that user's connection string.
+ *   3. Set autoStart, or start the server explicitly through the hybrid MCP API.
+ *
+ * MONGODB_LENS_URI is deliberately a different variable from MONGODB_URI, so that
+ * enabling this server cannot silently reuse the framework's own credentials.
  */
 export const MONGODB_LENS_SERVER_CONFIG: ExternalServerConfig = {
     id: 'mongodb-lens',
     name: 'MongoDB Lens Server',
     version: '1.0.0',
-    description: 'Database schema analysis, query optimization, aggregation pipeline building, and MongoDB intelligence',
+    description: 'Schema analysis, query optimization and aggregation building against a configured MongoDB database',
     command: 'npx',
     args: ['-y', 'mongodb-lens'],
-    autoStart: true, // ENABLED: Real package exists (furey/mongodb-lens)
+    // Opt-in only. Never point this at the database that holds MXF's users, PATs
+    // and API keys.
+    autoStart: false,
     restartOnCrash: true,
     healthCheckInterval: 30000,
     maxRestartAttempts: 3,
     startupTimeout: 15000, // MongoDB connection may take longer
     environmentVariables: {
         NODE_ENV: 'production',
-        MONGODB_URI: process.env.MONGODB_URI ?? '' // validated non-empty at spawn time by ExternalMcpServerManager
+        // Validated non-empty at spawn time by ExternalMcpServerManager, so starting
+        // this server without MONGODB_LENS_URI set fails with a clear error instead
+        // of falling back to the framework's own database.
+        MONGODB_URI: process.env.MONGODB_LENS_URI ?? ''
     }
 };
 
@@ -285,6 +312,42 @@ export const EXTERNAL_SERVER_CONFIGS: ExternalServerConfig[] = [
     // FETCH_SERVER_CONFIG,    // DISABLED: MCP protocol integration issues (replaced by internal web tools)
 ];
 
+/**
+ * The filesystem server's configuration, or a thrown error explaining why it
+ * cannot be started.
+ *
+ * Use this instead of FILESYSTEM_SERVER_CONFIG when starting the server on
+ * purpose: it refuses to hand out a filesystem server with no configured root,
+ * rather than spawning one whose allowed directories are whatever happens to be
+ * left in the args array.
+ *
+ * @throws Error when MXF_WORKSPACE_ROOT is not set
+ */
+export const getFilesystemServerConfig = (): ExternalServerConfig => {
+    const workspaceRoot = getWorkspaceRoot();
+
+    if (!workspaceRoot) {
+        throw new Error(
+            'The filesystem MCP server needs a workspace directory, but MXF_WORKSPACE_ROOT is not set. ' +
+            'Set it to the directory agents may read and write ' +
+            '(for example: MXF_WORKSPACE_ROOT=/Users/you/projects/my-app). ' +
+            'It has no default — the previous default was your home directory, which exposed ' +
+            '~/.ssh, ~/.aws and ~/.mxf/config.json to every agent.'
+        );
+    }
+
+    return {
+        ...FILESYSTEM_SERVER_CONFIG,
+        args: [
+            '-y',
+            '@modelcontextprotocol/server-filesystem',
+            workspaceRoot,
+            '/tmp/mcp-workspace'
+        ],
+        autoStart: true
+    };
+};
+
 /**
  * Get configurations for auto-start servers only
  */

package/src/protocols/mcp/services/IToolEventEmitter.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  *
  * @author Brad Anderson <BradA1878@pm.me>
- * @repository https://github.com/mxf-dev/mxf
+ * @repository https://github.com/BradA1878/model-exchange-framework
  * @documentation https://mxf-dev.github.io/mxf/
  */
 

package/src/protocols/mcp/tools/AnalyticsTools.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  *
  * @author Brad Anderson <BradA1878@pm.me>
- * @repository https://github.com/mxf-dev/mxf
+ * @repository https://github.com/BradA1878/model-exchange-framework
  * @documentation https://mxf-dev.github.io/mxf/
  */
 
@@ -347,7 +347,7 @@ export const analytics_task_completion: McpToolDefinition = {
                                timeRange === '7d' ? 7 * 24 * 60 * 60 * 1000 :
                                30 * 24 * 60 * 60 * 1000;
             const startTime = now - timeRangeMs;
-            const taskAnalytics = effectivenessService.getAnalytics(startTime, now, channelId);
+            const taskAnalytics = await effectivenessService.getAnalytics(startTime, now, channelId);
             
             return createToolResult(true, {
                 timeRange,

package/src/protocols/mcp/tools/CodeAnalysisTools.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  *
  * @author Brad Anderson <BradA1878@pm.me>
- * @repository https://github.com/mxf-dev/mxf
+ * @repository https://github.com/BradA1878/model-exchange-framework
  * @documentation https://mxf-dev.github.io/mxf/
  */
 
@@ -258,6 +258,11 @@ export const analyzeCodebaseTool = {
                 '-o', '-name', '*.js',
                 '-o', '-name', '*.jsx'
             ], {
+                context: {
+                    agentId: context.agentId,
+                    channelId: context.channelId,
+                    requestId: context.requestId
+                },
                 workingDirectory: workingDir,
                 captureOutput: true
             });
@@ -371,6 +376,11 @@ export const findFunctionsTool = {
                 '--no-heading',
                 `(function\\s+${args.functionName}|const\\s+${args.functionName}\\s*=|${args.functionName}\\s*:\\s*function|${args.functionName}\\s*:\\s*\\()`
             ], {
+                context: {
+                    agentId: context.agentId,
+                    channelId: context.channelId,
+                    requestId: context.requestId
+                },
                 workingDirectory: workingDir,
                 captureOutput: true
             });
@@ -494,6 +504,11 @@ export const traceDependenciesTool = {
                 '--no-heading',
                 `from\\s+['"].*${importPattern}['"]`
             ], {
+                context: {
+                    agentId: context.agentId,
+                    channelId: context.channelId,
+                    requestId: context.requestId
+                },
                 workingDirectory: workingDir,
                 captureOutput: true
             });

package/src/protocols/mcp/tools/DateTimeTools.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  *
  * @author Brad Anderson <BradA1878@pm.me>
- * @repository https://github.com/mxf-dev/mxf
+ * @repository https://github.com/BradA1878/model-exchange-framework
  * @documentation https://mxf-dev.github.io/mxf/
  */
 

package/src/protocols/mcp/tools/EffectivenessTools.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  *
  * @author Brad Anderson <BradA1878@pm.me>
- * @repository https://github.com/mxf-dev/mxf
+ * @repository https://github.com/BradA1878/model-exchange-framework
  * @documentation https://mxf-dev.github.io/mxf/
  */
 
@@ -279,7 +279,7 @@ export const task_effectiveness_complete: McpToolDefinition = {
                 });
             }
             
-            const comparison = effectivenessService.compareWithBaseline(taskId);
+            const comparison = await effectivenessService.compareWithBaseline(taskId);
             
             return createToolResult(true, {
                 message: 'Task completed and effectiveness measured',
@@ -338,7 +338,7 @@ export const task_effectiveness_analytics: McpToolDefinition = {
             };
             
             const startTime = now - ranges[timeRange as keyof typeof ranges];
-            const analytics = await effectivenessService.getEnhancedAnalytics(
+            const analytics = await effectivenessService.getAnalytics(
                 startTime, 
                 now, 
                 channelId as ChannelId,
@@ -395,7 +395,7 @@ export const task_effectiveness_compare: McpToolDefinition = {
     handler: async ({ taskId }: any) => {
         const effectivenessService = TaskEffectivenessService.getInstance();
         try {
-            const comparison = effectivenessService.compareWithBaseline(taskId);
+            const comparison = await effectivenessService.compareWithBaseline(taskId);
             if (!comparison) {
                 return createToolResult(false, {
                     error: 'Task not found or no comparison available'