consult-llm-mcp 1.0.1 → 1.0.3

package/README.md

@@ -1,7 +1,6 @@
 # Consult LLM MCP
 
-An MCP (Model Context Protocol) server that allows you to consult more powerful
-AI models with your code and questions.
+An MCP server that lets Claude Code consult stronger AI models (o3, Gemini 2.5 Pro, DeepSeek Reasoner) when you need deeper analysis on complex problems.
 
 ## Features
 
@@ -12,21 +11,13 @@ AI models with your code and questions.
 - Usage tracking with cost estimation
 - Comprehensive logging
 
-## Installation
-
-```bash
-npm install
-npm run build
-npm install -g .
-```
-
 ## Configuration
 
 - `OPENAI_API_KEY` - Your OpenAI API key (required for o3)
 - `GEMINI_API_KEY` - Your Google AI API key (required for Gemini models)
 - `DEEPSEEK_API_KEY` - Your DeepSeek API key (required for DeepSeek models)
-- `CONSULT_LLM_DEFAULT_MODEL` - Override the default model (optional, defaults
-  to 'o3')
+- `CONSULT_LLM_DEFAULT_MODEL` - Override the default model (optional)
+  - Options: `o3` (default), `gemini-2.5-pro`, `deepseek-reasoner`
 
 ## Usage with Claude Code
 
@@ -46,6 +37,8 @@ claude mcp add --scope user consult-llm -- npx -y consult-llm-mcp
 
 ### Example workflows
 
+Click to expand.
+
 <details>
 <summary>Explain the problem, and tell CC to consult a smarter LLM</summary>
 
@@ -150,6 +143,49 @@ All prompts and responses are logged to `~/.consult-llm-mcp/logs/mcp.log` with:
 - Full prompts and responses
 - Token usage and cost estimates
 
+<details>
+<summary>Example</summary>
+
+```
+[2025-06-22T20:16:04.673Z] TOOL CALL: consult_llm
+Arguments: {
+  "files": [
+    "refactor-analysis.md",
+    "src/main.ts",
+    "src/schema.ts",
+    "src/config.ts",
+    "src/llm.ts",
+    "src/llm-cost.ts"
+  ],
+  "model": "deepseek-reasoner"
+}
+================================================================================
+[2025-06-22T20:16:04.675Z] PROMPT (model: deepseek-reasoner):
+## Relevant Files
+
+### File: src/main.ts
+
+...
+
+Please provide specific suggestions for refactoring with example code structure
+where helpful.
+================================================================================
+[2025-06-22T20:19:20.632Z] RESPONSE (model: deepseek-reasoner):
+Based on the analysis, here are the key refactoring suggestions to improve
+separation of concerns and maintainability:
+
+...
+
+This refactoring maintains all existing functionality while significantly
+improving maintainability and separation of concerns. The new structure makes
+it easier to add features like new LLM providers, additional context sources,
+or alternative prompt formats.
+
+Tokens: 3440 input, 5880 output | Cost: $0.014769 (input: $0.001892, output: $0.012877)
+```
+
+</details>
+
 ## CLAUDE.md example
 
 To help Claude Code understand when and how to use this tool, you can add the

package/dist/llm.d.ts

@@ -1,5 +1,5 @@
 import OpenAI from 'openai';
 import { type SupportedChatModel as SupportedChatModelType } from './schema.js';
-export declare function getClientForModel(model: SupportedChatModelType | string): {
+export declare function getClientForModel(model: SupportedChatModelType): {
     client: OpenAI;
 };

package/dist/llm.js

@@ -4,6 +4,9 @@ const clients = {};
 export function getClientForModel(model) {
     if (model.startsWith('gpt-') || model === 'o3') {
         if (!clients.openai) {
+            if (!config.openaiApiKey) {
+                throw new Error('OPENAI_API_KEY environment variable is required for OpenAI models');
+            }
             clients.openai = new OpenAI({
                 apiKey: config.openaiApiKey,
             });
@@ -12,6 +15,9 @@ export function getClientForModel(model) {
     }
     else if (model.startsWith('gemini-')) {
         if (!clients.gemini) {
+            if (!config.geminiApiKey) {
+                throw new Error('GEMINI_API_KEY environment variable is required for Gemini models');
+            }
             clients.gemini = new OpenAI({
                 apiKey: config.geminiApiKey,
                 baseURL: 'https://generativelanguage.googleapis.com/v1beta/openai/',
@@ -21,6 +27,9 @@ export function getClientForModel(model) {
     }
     else if (model.startsWith('deepseek-')) {
         if (!clients.deepseek) {
+            if (!config.deepseekApiKey) {
+                throw new Error('DEEPSEEK_API_KEY environment variable is required for DeepSeek models');
+            }
             clients.deepseek = new OpenAI({
                 apiKey: config.deepseekApiKey,
                 baseURL: 'https://api.deepseek.com',

package/dist/logger.d.ts

@@ -2,3 +2,4 @@ export declare function logToFile(content: string): void;
 export declare function logToolCall(name: string, args: unknown): void;
 export declare function logPrompt(model: string, prompt: string): void;
 export declare function logResponse(model: string, response: string, costInfo: string): void;
+export declare function logServerStart(version: string): void;

package/dist/logger.js

@@ -28,3 +28,6 @@ export function logPrompt(model, prompt) {
 export function logResponse(model, response, costInfo) {
     logToFile(`RESPONSE (model: ${model}):\n${response}\n${costInfo}\n${'='.repeat(80)}`);
 }
+export function logServerStart(version) {
+    logToFile(`MCP SERVER STARTED - consult-llm-mcp v${version}\n${'='.repeat(80)}`);
+}

package/dist/main.js

@@ -8,10 +8,16 @@ import { processFiles } from './file.js';
 import { generateGitDiff } from './git.js';
 import { buildPrompt } from './prompt-builder.js';
 import { queryLlm } from './llm-query.js';
-import { logToolCall, logPrompt, logResponse } from './logger.js';
+import { logToolCall, logPrompt, logResponse, logServerStart, } from './logger.js';
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+const SERVER_VERSION = packageJson.version;
 const server = new Server({
     name: 'consult_llm',
-    version: '1.0.0',
+    version: SERVER_VERSION,
 }, {
     capabilities: {
         tools: {},
@@ -61,6 +67,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     throw new Error(`Unknown tool: ${request.params.name}`);
 });
 async function main() {
+    logServerStart(SERVER_VERSION);
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "consult-llm-mcp",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "MCP server for consulting powerful AI models",
   "type": "module",
   "main": "dist/main.js",