feat: add --local option

Author: sinedied

packages/agent-cli/README.md

@@ -18,12 +18,22 @@ npm run start "place an order" -- --userId user123
 # Start a new session
 npm run start "hello" -- --new
 
+# Use local MCP server
+npm run start "show me the menu" -- --local
+
 # Combine options
-npm run start "cancel my order" -- --userId user123 --new
+npm run start "cancel my order" -- --userId user123 --new --local
 ```
 
 The CLI maintains conversation history in `~/.burger-agent-cli/burger-agent-cli.json` for context across sessions.
 
+### Options
+
+- `--userId <userId>`: Specify a user ID for operations that require user context (like placing or cancelling orders)
+- `--new`: Start a new conversation session, discarding previous history
+- `--verbose`: Show intermediate steps and tool calls during execution
+- `--local`: Force connection to localhost MCP server (http://localhost:3000/mcp) instead of using BURGER_MCP_URL environment variable
+
 ### `npm run build`
 
 To build the CLI for production to the `dist` folder.

packages/agent-cli/agent-cli.ts

@@ -40,6 +40,7 @@ interface CliArgs {
   userId?: string;
   isNew: boolean;
   verbose: boolean;
+  local: boolean;
 }
 
 interface SessionData {
@@ -51,18 +52,20 @@ function parseArgs(): CliArgs {
   const args = process.argv.slice(2);
 
   if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
-    console.log('Usage: agent-cli <question> [--userId <userId>] [--new] [--verbose]');
+    console.log('Usage: agent-cli <question> [--userId <userId>] [--new] [--verbose] [--local]');
     console.log('  question: Your question about burger orders');
     console.log('  --userId: Optional user ID (needed for some tasks)');
     console.log('  --new: Start a new session');
     console.log('  --verbose: Enable verbose mode to show intermediate steps');
+    console.log('  --local: Force connection to localhost MCP server');
     process.exit(0);
   }
 
   const questionParts: string[] = [];
   let userId: string | undefined;
   let isNew = false;
   let verbose = false;
+  let local = false;
 
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
@@ -74,6 +77,8 @@ function parseArgs(): CliArgs {
       isNew = true;
     } else if (arg === '--verbose') {
       verbose = true;
+    } else if (arg === '--local') {
+      local = true;
     } else {
       questionParts.push(arg);
     }
@@ -86,7 +91,7 @@ function parseArgs(): CliArgs {
     process.exit(1);
   }
 
-  return { question, userId, isNew, verbose };
+  return { question, userId, isNew, verbose, local };
 }
 
 async function getSessionPath(): Promise<string> {
@@ -123,9 +128,10 @@ function convertHistoryToMessages(history: SessionData['history']): BaseMessage[
 }
 
 export async function run() {
-  const { question, userId, isNew, verbose } = parseArgs();
+  const { question, userId, isNew, verbose, local } = parseArgs();
   const azureOpenAiEndpoint = process.env.AZURE_OPENAI_API_ENDPOINT;
-  const burgerMcpEndpoint = process.env.BURGER_MCP_URL ?? 'http://localhost:3000/mcp';
+  const localMcpEndpoint = 'http://localhost:3000/mcp';
+  const burgerMcpEndpoint = local ? localMcpEndpoint : (process.env.BURGER_MCP_URL ?? localMcpEndpoint);
 
   let client: Client | undefined;