@supermodeltools/mcp-server 0.4.12 → 0.5.1

package/README.md

@@ -66,6 +66,34 @@ With the API key set globally, you can omit the `env` block from your MCP config
 }
 ```
 
+### Default Working Directory (Optional)
+
+For automated benchmarking tools (like mcpbr) or batch processing, you can specify a default working directory as a command-line argument. When provided, the `explore_codebase` tool will use this directory automatically if no explicit `directory` parameter is given.
+
+**Command-line usage:**
+
+```bash
+npx @supermodeltools/mcp-server /path/to/repository
+```
+
+or with Node.js:
+
+```bash
+node dist/index.js /path/to/repository
+```
+
+**Example with benchmarking tools:**
+
+```yaml
+mcp_server:
+  command: "npx"
+  args: ["-y", "@supermodeltools/mcp-server", "{workdir}"]
+  env:
+    SUPERMODEL_API_KEY: "${SUPERMODEL_API_KEY}"
+```
+
+This allows the agent to call `explore_codebase()` without specifying a directory parameter, automatically using the configured default workdir. You can still override it by explicitly passing a `directory` parameter in individual tool calls.
+
 ## Usage
 
 ### Cursor
@@ -185,6 +213,10 @@ Debug logs go to stderr:
 - Insufficient disk space: Free up space in your system's temp directory
 - Directory does not exist: Verify the path is correct and absolute
 
+## Benchmarking
+
+Benchmark this MCP server using [mcpbr](https://github.com/caspianmoon/mcpbr-benchmark-caching) with the provided [`mcpbr-config.yaml`](./mcpbr-config.yaml) configuration.
+
 ## Links
 
 - [API Documentation](https://docs.supermodeltools.com)

package/dist/index.js

@@ -37,7 +37,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const server_1 = require("./server");
 const logger = __importStar(require("./utils/logger"));
 async function main() {
-    const server = new server_1.Server();
+    // Parse command-line arguments to get optional default workdir
+    // Usage: node dist/index.js [workdir]
+    const args = process.argv.slice(2);
+    const defaultWorkdir = args.length > 0 ? args[0] : undefined;
+    if (defaultWorkdir) {
+        logger.debug('Default workdir:', defaultWorkdir);
+    }
+    const server = new server_1.Server(defaultWorkdir);
     await server.start();
 }
 main().catch((error) => {

package/dist/server.js

@@ -69,7 +69,9 @@ const fetchWithTimeout = (url, init) => {
 class Server {
     server;
     client;
-    constructor() {
+    defaultWorkdir;
+    constructor(defaultWorkdir) {
+        this.defaultWorkdir = defaultWorkdir;
         this.server = new mcp_js_1.McpServer({
             name: 'supermodel_api',
             version: '0.0.1',
@@ -118,6 +120,9 @@ Example:
         logger.debug('Server configuration:');
         logger.debug('Base URL:', config.basePath);
         logger.debug('API Key set:', !!process.env.SUPERMODEL_API_KEY);
+        if (this.defaultWorkdir) {
+            logger.debug('Default workdir:', this.defaultWorkdir);
+        }
         this.client = {
             graphs: new sdk_1.DefaultApi(config),
         };
@@ -132,7 +137,7 @@ Example:
         this.server.server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
             const { name, arguments: args } = request.params;
             if (name === create_supermodel_graph_1.default.tool.name) {
-                return create_supermodel_graph_1.default.handler(this.client, args);
+                return create_supermodel_graph_1.default.handler(this.client, args, this.defaultWorkdir);
             }
             throw new Error(`Unknown tool: ${name}`);
         });

package/dist/tools/create-supermodel-graph.js

@@ -194,7 +194,7 @@ Query types available: graph_status, summary, get_node, search, list_nodes, func
                 description: 'Raw jq filter for escape hatch queries or legacy mode (when query param not specified)',
             },
         },
-        required: ['directory'],
+        required: [],
     },
 };
 /**
@@ -233,16 +233,28 @@ function generateIdempotencyKey(directory) {
     }
     return `${repoName}-${pathHash}:supermodel:${hash}${statusHash}`;
 }
-const handler = async (client, args) => {
+const handler = async (client, args, defaultWorkdir) => {
     if (!args) {
-        logger.error('No arguments provided to handler');
-        return (0, types_1.asErrorResult)('Missing required arguments. Provide a "directory" parameter.');
+        args = {};
     }
-    const { jq_filter, directory, query, targetId, searchText, namePattern, filePathPrefix, labels, depth, relationshipTypes, limit, includeRaw, } = args;
-    // Validate directory
+    const { jq_filter, directory: providedDirectory, query, targetId, searchText, namePattern, filePathPrefix, labels, depth, relationshipTypes, limit, includeRaw, } = args;
+    // Use provided directory or fall back to default workdir
+    const directory = providedDirectory || defaultWorkdir;
+    // Validate directory - check if explicitly invalid first
+    if (providedDirectory !== undefined && typeof providedDirectory !== 'string') {
+        logger.error('Invalid directory parameter:', providedDirectory);
+        return (0, types_1.asErrorResult)('Invalid "directory" parameter. Provide a valid directory path as a string.');
+    }
+    // Check if we have any directory at all
     if (!directory || typeof directory !== 'string') {
         logger.error('Invalid directory parameter:', directory);
-        return (0, types_1.asErrorResult)('Invalid "directory" parameter. Provide a valid directory path as a string.');
+        return (0, types_1.asErrorResult)('No "directory" parameter provided and no default workdir configured. Please provide a directory path or start the server with a workdir argument.');
+    }
+    if (providedDirectory) {
+        logger.debug('Using provided directory:', directory);
+    }
+    else {
+        logger.debug('Using default workdir:', directory);
     }
     // Generate idempotency key for API request
     const idempotencyKey = generateIdempotencyKey(directory);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supermodeltools/mcp-server",
-  "version": "0.4.12",
+  "version": "0.5.1",
   "description": "MCP server for Supermodel API - code graph generation for AI agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",