consult-llm-mcp 1.2.0 → 1.3.0

package/README.md

@@ -32,6 +32,7 @@ This SQL query is timing out on large datasets. Can you help optimize it? Ask Ge
 - Gemini can be used via
   [Gemini CLI](https://github.com/google-gemini/gemini-cli) to take advantage of
   [free quota](https://developers.google.com/gemini-code-assist/resources/quotas#quotas-for-agent-mode-gemini-cli)
+- Web mode: Copy formatted prompts to clipboard for browser-based LLM services
 - Simple: provides just one MCP tool to not clutter the context
 
 ## Usage with Claude Code
@@ -120,6 +121,53 @@ Some real-world examples. Click to expand.
 
 </details>
 
+<details>
+<summary>Using web mode to copy prompts to clipboard for browser-based LLMs</summary>
+
+```
+> I need help implementing a -b/--background flag for my Rust CLI. Use consult LLM with web mode
+
+⏺ I'll use web mode to copy the formatted prompt to your clipboard so you can
+  paste it into any browser-based LLM service.
+
+⏺ consult-llm:consult_llm (MCP)(prompt: "What is the best approach to implement a
+                                 -b/--background flag for the \"workmux add\" command that
+                                 creates a tmux window in the background without switching to
+                                 it?\n\nThe current implementation automatically switches to
+                                 the newly created window via `tmux::select_window()` in the
+                                 `setup_environment()` function. I need to make this behavior
+                                 conditional based on a flag passed from the
+                                 CLI.\n\nConsider:\n1. Where should the background flag be
+                                 threaded through the call chain?\n2. Should I modify the
+                                 existing SetupOptions struct or add a parameter?\n3. What's
+                                 the most maintainable approach given the codebase
+                                 structure?\n4. Are there any edge cases to consider (e.g.,
+                                 should select_pane also be conditional)?", files:
+                                 ["src/cli.rs","src/workflow.rs","src/tmux.rs"], web_mode:
+                                 true)
+  ⎿  ✓ Prompt copied to clipboard!
+
+     Please paste it into your browser-based LLM service and share the response
+     here before I proceed with any implementation.
+
+     Note: File paths were included:
+       - src/cli.rs
+       - src/workflow.rs
+       - src/tmux.rs
+
+> [User pastes the response from the external LLM]
+
+⏺ Thank you! Based on the recommendations, I'll now implement the solution...
+```
+
+This is useful when:
+
+- You want to use a free browser-based LLM service instead of API credits
+- You prefer a specific LLM's web interface
+- You want to review the full prompt before submitting it
+
+</details>
+
 <details>
 <summary>Debugging Neovim plugin treesitter API breakage</summary>
 
@@ -236,6 +284,13 @@ models complex questions.
 
   - Options: `o3` (default), `gemini-2.5-pro`, `deepseek-reasoner`
 
+- **web_mode** (optional): Copy prompt to clipboard instead of querying LLM
+
+  - Default: `false`
+  - When `true`, the formatted prompt (including system prompt and file
+    contents) is copied to clipboard for manual pasting into browser-based LLM
+    services
+
 - **git_diff** (optional): Include git diff output as context
   - **files** (required): Specific files to include in diff
   - **repo_path** (optional): Path to git repository (defaults to current

package/dist/clipboard.d.ts

@@ -0,0 +1 @@
+export declare function copyToClipboard(text: string): Promise<void>;

package/dist/clipboard.js

@@ -0,0 +1,10 @@
+import clipboard from 'clipboardy';
+export async function copyToClipboard(text) {
+    try {
+        await clipboard.write(text);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown clipboard error';
+        throw new Error(`Failed to copy prompt to clipboard: ${message}`);
+    }
+}

package/dist/main.js

@@ -9,7 +9,8 @@ import { generateGitDiff } from './git.js';
 import { buildPrompt } from './prompt-builder.js';
 import { queryLlm } from './llm-query.js';
 import { logToolCall, logPrompt, logResponse, logServerStart, logConfiguration, } from './logger.js';
-import { DEFAULT_SYSTEM_PROMPT } from './system-prompt.js';
+import { DEFAULT_SYSTEM_PROMPT, getSystemPrompt } from './system-prompt.js';
+import { copyToClipboard } from './clipboard.js';
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
 import { dirname, join, resolve } from 'path';
 import { fileURLToPath } from 'url';
@@ -38,7 +39,7 @@ async function handleConsultLlm(args) {
             .join(', ');
         throw new Error(`Invalid request parameters: ${errors}`);
     }
-    const { files, prompt: userPrompt, git_diff } = parseResult.data;
+    const { files, prompt: userPrompt, git_diff, web_mode } = parseResult.data;
     const model = parseResult.data.model ?? config.defaultModel ?? 'o3';
     logToolCall('consult_llm', args);
     // Check if we're using CLI mode for Gemini
@@ -68,6 +69,27 @@ async function handleConsultLlm(args) {
         prompt = buildPrompt(userPrompt, contextFiles, gitDiffOutput);
     }
     await logPrompt(model, prompt);
+    // Handle web mode - copy prompt to clipboard instead of querying LLM
+    if (web_mode) {
+        const systemPrompt = getSystemPrompt(isCliMode);
+        const fullPrompt = `# System Prompt
+
+${systemPrompt}
+
+# User Prompt
+
+${prompt}`;
+        await copyToClipboard(fullPrompt);
+        let responseMessage = '✓ Prompt copied to clipboard!\n\n';
+        responseMessage +=
+            'Please paste it into your browser-based LLM service and share the response here before I proceed with any implementation.';
+        if (filePaths && filePaths.length > 0) {
+            responseMessage += `\n\nNote: File paths were included:\n${filePaths.map((p) => `  - ${p}`).join('\n')}`;
+        }
+        return {
+            content: [{ type: 'text', text: responseMessage }],
+        };
+    }
     // Query LLM
     const { response, costInfo } = await queryLlm(prompt, model, filePaths);
     await logResponse(model, response, costInfo);

package/dist/schema.d.ts

@@ -13,6 +13,7 @@ export declare const ConsultLlmArgs: z.ZodObject<{
         "gemini-2.5-pro": "gemini-2.5-pro";
         "deepseek-reasoner": "deepseek-reasoner";
     }>>;
+    web_mode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     git_diff: z.ZodOptional<z.ZodObject<{
         repo_path: z.ZodOptional<z.ZodString>;
         files: z.ZodArray<z.ZodString>;
@@ -42,6 +43,11 @@ export declare const toolSchema: {
                 readonly default: "o3";
                 readonly description: "LLM model to use";
             };
+            readonly web_mode: {
+                readonly type: "boolean";
+                readonly default: false;
+                readonly description: "Copy the formatted prompt to clipboard instead of querying the LLM. Use this to paste the prompt into browser-based LLM services. IMPORTANT: When true, wait for the user to provide the external LLM's response before proceeding with any implementation.";
+            };
             readonly git_diff: {
                 readonly type: "object";
                 readonly properties: {

package/dist/schema.js

@@ -8,6 +8,7 @@ export const ConsultLlmArgs = z.object({
     files: z.array(z.string()).optional(),
     prompt: z.string(),
     model: SupportedChatModel.optional(),
+    web_mode: z.boolean().optional().default(false),
     git_diff: z
         .object({
         repo_path: z.string().optional(),
@@ -43,6 +44,11 @@ IMPORTANT: Ask neutral, open-ended questions. Avoid suggesting specific solution
                 default: 'o3',
                 description: 'LLM model to use',
             },
+            web_mode: {
+                type: 'boolean',
+                default: false,
+                description: "Copy the formatted prompt to clipboard instead of querying the LLM. Use this to paste the prompt into browser-based LLM services. IMPORTANT: When true, wait for the user to provide the external LLM's response before proceeding with any implementation.",
+            },
             git_diff: {
                 type: 'object',
                 properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "consult-llm-mcp",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "MCP server for consulting powerful AI models",
   "type": "module",
   "main": "dist/main.js",
@@ -49,6 +49,7 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.13.0",
+    "clipboardy": "^5.0.0",
     "openai": "^5.6.0",
     "prettier": "^3.5.3",
     "zod": "^3.25.67"