@houtini/gemini-mcp 1.4.2 → 1.4.5

package/README.md

@@ -1,6 +1,7 @@
 # Gemini MCP Server
 
 [![npm version](https://img.shields.io/npm/v/@houtini/gemini-mcp.svg?style=flat-square)](https://www.npmjs.com/package/@houtini/gemini-mcp)
+[![Known Vulnerabilities](https://snyk.io/test/github/houtini-ai/gemini-mcp/badge.svg)](https://snyk.io/test/github/houtini-ai/gemini-mcp)
 [![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue?style=flat-square)](https://registry.modelcontextprotocol.io)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=flat-square)](https://opensource.org/licenses/Apache-2.0)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
@@ -155,6 +156,55 @@ After updating the config, restart Claude Desktop. The server loads on startup.
 | `GEMINI_API_KEY` | *required* | Your Google AI Studio API key |
 | `LOG_LEVEL` | `info` | Logging detail: `debug`, `info`, `warn`, `error` |
 | `GEMINI_ALLOW_EXPERIMENTAL` | `false` | Include experimental models (set `true` to enable) |
+| `GEMINI_MCP_LOG_FILE` | `false` | Enable file logging (see Logging section below) |
+| `DEBUG_MCP` | `false` | Enable console debugging output (stderr) |
+
+### Logging Configuration
+
+By default, the server operates with minimal logging to avoid interfering with MCP stdio communication. File logging is disabled unless explicitly enabled.
+
+**Enable File Logging:**
+
+Add `GEMINI_MCP_LOG_FILE=true` to your environment configuration:
+
+```json
+{
+  "mcpServers": {
+    "gemini": {
+      "command": "npx",
+      "args": ["@houtini/gemini-mcp"],
+      "env": {
+        "GEMINI_API_KEY": "your-api-key-here",
+        "GEMINI_MCP_LOG_FILE": "true"
+      }
+    }
+  }
+}
+```
+
+When enabled, logs are written to:
+- **Unix/macOS**: `~/.gemini-mcp/logs/`
+- **Windows**: `C:\Users\[username]\.gemini-mcp\logs\`
+
+Log files:
+- `error.log` - Error level messages only
+- `combined.log` - All log levels
+- Maximum 5MB per file, 5 files retained
+
+**Debug Mode:**
+
+For development or troubleshooting, enable console output (stderr):
+
+```json
+{
+  "env": {
+    "GEMINI_API_KEY": "your-api-key-here",
+    "DEBUG_MCP": "true"
+  }
+}
+```
+
+This outputs to stderr to avoid corrupting MCP stdio communication.
 
 ## Dynamic Model Discovery
 

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAkBnC,QAAA,MAAM,MAAM,gBAWV,CAAC;AAEH,eAAe,MAAM,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AA+DnC,QAAA,MAAM,MAAM,gBAWV,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/dist/utils/logger.js

@@ -1,17 +1,51 @@
 import * as winston from 'winston';
 import { config } from '../config/index.js';
-const transports = [
-    new winston.transports.File({
-        filename: 'logs/error.log',
-        level: 'error'
-    }),
-    new winston.transports.File({
-        filename: 'logs/combined.log'
-    })
-];
-// Only add console logging if not running as MCP server (stdout must be clean)
+import * as os from 'os';
+import * as path from 'path';
+import * as fs from 'fs';
+// Determine if we should use file logging
+// Only enable file logging if explicitly requested via environment variable
+const shouldUseFileLogging = process.env.GEMINI_MCP_LOG_FILE === 'true';
+const transports = [];
+// File logging (optional, disabled by default for MCP stdio servers)
+if (shouldUseFileLogging) {
+    // Use user home directory for cross-platform compatibility
+    // ~/.gemini-mcp/logs/ on Unix-like systems
+    // C:\Users\username\.gemini-mcp\logs\ on Windows
+    const logDir = path.join(os.homedir(), '.gemini-mcp', 'logs');
+    try {
+        // Ensure log directory exists
+        fs.mkdirSync(logDir, { recursive: true, mode: 0o755 });
+        transports.push(new winston.transports.File({
+            filename: path.join(logDir, 'error.log'),
+            level: 'error',
+            maxsize: 5242880, // 5MB
+            maxFiles: 5,
+        }), new winston.transports.File({
+            filename: path.join(logDir, 'combined.log'),
+            maxsize: 5242880, // 5MB
+            maxFiles: 5,
+        }));
+    }
+    catch (error) {
+        // Fallback to console only if directory creation fails
+        process.stderr.write(`Warning: Could not create log directory at ${logDir}. File logging disabled.\n`);
+    }
+}
+// Console logging (stderr to avoid polluting stdout for MCP)
+// Only add if in development mode or DEBUG_MCP is enabled
 if (process.env.NODE_ENV === 'development' || process.env.DEBUG_MCP === 'true') {
-    transports.push(new winston.transports.Console());
+    transports.push(new winston.transports.Console({
+        stderrLevels: ['error', 'warn', 'info', 'debug'], // All levels to stderr
+    }));
+}
+// Fallback: If no transports configured, add a minimal Console transport to stderr
+// This ensures errors are visible even when file logging fails
+if (transports.length === 0) {
+    transports.push(new winston.transports.Console({
+        level: 'error',
+        stderrLevels: ['error', 'warn', 'info', 'debug'],
+    }));
 }
 const logger = winston.createLogger({
     level: config.logging.level,

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,UAAU,GAAwB;IACtC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;QAC1B,QAAQ,EAAE,gBAAgB;QAC1B,KAAK,EAAE,OAAO;KACf,CAAC;IACF,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;QAC1B,QAAQ,EAAE,mBAAmB;KAC9B,CAAC;CACH,CAAC;AAEF,+EAA+E;AAC/E,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;IAC/E,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;IAC3B,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAC5B,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EACtC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,EACzB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QAC7D,OAAO,GAAG,SAAS,KAAK,KAAK,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC3E,CAAC,CAAC,CACH;IACD,UAAU;CACX,CAAC,CAAC;AAEH,eAAe,MAAM,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@houtini/gemini-mcp",
-  "version": "1.4.2",
+  "version": "1.4.5",
   "mcpName": "io.github.houtini-ai/gemini",
   "type": "module",
   "description": "Professional Model Context Protocol server for Google Gemini AI models with enterprise-grade features",
@@ -49,7 +49,7 @@
   ],
   "author": "Houtini",
   "license": "Apache-2.0",
-  "homepage": "https://github.com/houtini-ai/gemini-mcp#readme",
+  "homepage": "https://houtini.com/gemini-mcp/",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/houtini-ai/gemini-mcp.git"
@@ -83,6 +83,8 @@
     "dist/**/*",
     "README.md",
     "LICENSE",
+    "houtini-logo.jpg",
+    "server.json",
     ".env.example",
     "claude_desktop_config_example.json"
   ],

package/server.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.houtini-ai/gemini",
+  "description": "Model Context Protocol server for Google Gemini AI with chat, research, and grounding",
+  "repository": {
+    "url": "https://github.com/houtini-ai/gemini-mcp",
+    "source": "github"
+  },
+  "version": "1.4.2",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@houtini/gemini-mcp",
+      "version": "1.4.2",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "GEMINI_API_KEY",
+          "description": "Google AI Studio API key (get from https://aistudio.google.com/apikey)",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": true
+        }
+      ]
+    }
+  ]
+}