gemini-bridge 1.0.4__py3-none-any.whl → 1.0.5__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {gemini_bridge-1.0.4.dist-info → gemini_bridge-1.0.5.dist-info}/METADATA +2 -75
- gemini_bridge-1.0.5.dist-info/RECORD +9 -0
- src/__init__.py +1 -1
- src/mcp_server.py +17 -183
- gemini_bridge-1.0.4.dist-info/RECORD +0 -9
- {gemini_bridge-1.0.4.dist-info → gemini_bridge-1.0.5.dist-info}/WHEEL +0 -0
- {gemini_bridge-1.0.4.dist-info → gemini_bridge-1.0.5.dist-info}/entry_points.txt +0 -0
- {gemini_bridge-1.0.4.dist-info → gemini_bridge-1.0.5.dist-info}/licenses/LICENSE +0 -0
- {gemini_bridge-1.0.4.dist-info → gemini_bridge-1.0.5.dist-info}/top_level.txt +0 -0
@@ -1,6 +1,6 @@
|
|
1
1
|
Metadata-Version: 2.4
|
2
2
|
Name: gemini-bridge
|
3
|
-
Version: 1.0.
|
3
|
+
Version: 1.0.5
|
4
4
|
Summary: Lightweight MCP server bridging Claude Code to Google's Gemini AI via official CLI
|
5
5
|
Author-email: Shelakh <info@shelakh.com>
|
6
6
|
License-Expression: MIT
|
@@ -537,83 +537,10 @@ gemini --version
|
|
537
537
|
- Ensure Claude Code MCP configuration is correct
|
538
538
|
- Check that the `gemini` command is in your PATH
|
539
539
|
|
540
|
-
### Timeout Issues 🔥
|
541
|
-
|
542
|
-
Gemini Bridge now includes comprehensive timeout debugging. If you're experiencing timeout issues:
|
543
|
-
|
544
|
-
**1. Use the Debug Tool**
|
545
|
-
```python
|
546
|
-
# Get detailed diagnostics about your configuration
|
547
|
-
get_debug_info()
|
548
|
-
```
|
549
|
-
|
550
|
-
This will show:
|
551
|
-
- Current timeout configuration
|
552
|
-
- Gemini CLI status and version
|
553
|
-
- Authentication status
|
554
|
-
- Environment variables
|
555
|
-
- System information
|
556
|
-
|
557
|
-
**2. Configure Appropriate Timeout**
|
558
|
-
|
559
|
-
For different operation types, recommended timeouts:
|
560
|
-
|
561
|
-
- **Default operations**: 60 seconds (default)
|
562
|
-
- **Large file analysis**: 240 seconds
|
563
|
-
- **Complex multi-file operations**: 300+ seconds
|
564
|
-
|
565
|
-
**Configuration Examples:**
|
566
|
-
|
567
|
-
```bash
|
568
|
-
# Claude Code with 4-minute timeout for large operations
|
569
|
-
claude mcp add gemini-bridge -s user --env GEMINI_BRIDGE_TIMEOUT=240 -- uvx gemini-bridge
|
570
|
-
|
571
|
-
# Environment variable (if running manually)
|
572
|
-
export GEMINI_BRIDGE_TIMEOUT=240
|
573
|
-
```
|
574
|
-
|
575
|
-
**3. Common Timeout Scenarios**
|
576
|
-
|
577
|
-
| Scenario | Recommended Timeout | Reason |
|
578
|
-
|----------|-------------------|---------|
|
579
|
-
| Single file < 10KB | 60s (default) | Fast processing |
|
580
|
-
| Multiple files or large files | 240s | More content to process |
|
581
|
-
| Complex code analysis | 300s | Deep reasoning required |
|
582
|
-
| Very large files (>100KB) | 300-600s | Processing overhead |
|
583
|
-
|
584
|
-
**4. Debugging Steps**
|
585
|
-
|
586
|
-
1. **Check your configuration**:
|
587
|
-
```bash
|
588
|
-
# Run the debug tool to see current timeout
|
589
|
-
# Look for "Actual timeout used" in the output
|
590
|
-
```
|
591
|
-
|
592
|
-
2. **Monitor logs**: The server now logs detailed timing information
|
593
|
-
|
594
|
-
3. **Test with smaller queries**: If large queries timeout, break them into smaller parts
|
595
|
-
|
596
|
-
4. **Verify Gemini CLI performance**: Test `gemini` directly with similar queries
|
597
|
-
|
598
|
-
**5. Advanced Troubleshooting**
|
599
|
-
|
600
|
-
If timeouts persist even with high timeout values:
|
601
|
-
|
602
|
-
- **Network issues**: Check your internet connection
|
603
|
-
- **Gemini CLI version**: Update with `npm install -g @google/gemini-cli@latest`
|
604
|
-
- **Authentication**: Re-authenticate with `gemini auth login`
|
605
|
-
- **System resources**: Check if your system is under high load
|
606
|
-
- **File encoding**: Ensure files are UTF-8 encoded
|
607
|
-
- **MCP client timeout**: Some clients have their own timeout settings
|
608
|
-
|
609
540
|
### Common Error Messages
|
610
541
|
- **"CLI not available"**: Gemini CLI is not installed or not in PATH
|
611
542
|
- **"Authentication required"**: Run `gemini auth login`
|
612
|
-
- **"Timeout after
|
613
|
-
- Solution: Increase `GEMINI_BRIDGE_TIMEOUT` environment variable
|
614
|
-
- For immediate testing: Use smaller files or simpler queries
|
615
|
-
- **"Large content size warning"**: Files total >100KB, may need longer timeout
|
616
|
-
- **"Very high timeout configured"**: Timeout >300s, failed operations will wait long
|
543
|
+
- **"Timeout after 60 seconds"**: Query took too long, try breaking it into smaller parts
|
617
544
|
|
618
545
|
## 🤝 Contributing
|
619
546
|
|
@@ -0,0 +1,9 @@
|
|
1
|
+
gemini_bridge-1.0.5.dist-info/licenses/LICENSE,sha256=yTz_R8ocWu64Eubxr6vdZCKRS0dB_Pi3RbjUNn4qPxQ,1063
|
2
|
+
src/__init__.py,sha256=cCvBdB-1IK7X9UQlDvCsRrY7C2DliZ0Gft4uWPi6Ra4,190
|
3
|
+
src/__main__.py,sha256=12FoIYCXYYKu2_BYX1GS_h9E9qO41Q26B8zedRIDPBs,149
|
4
|
+
src/mcp_server.py,sha256=hNjXel5iDt4mB59Rc5PJST8wVwRlrsOFzjOGtuLk8eU,7722
|
5
|
+
gemini_bridge-1.0.5.dist-info/METADATA,sha256=G2m4QUARNzgTjz2wUjSjFcv-X3eSvGTc3bwCDxHgOFk,13798
|
6
|
+
gemini_bridge-1.0.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
|
7
|
+
gemini_bridge-1.0.5.dist-info/entry_points.txt,sha256=ygWf0B23Gygq8mW_GzPx8rxIA19RR_RH4RG2I15lU3E,43
|
8
|
+
gemini_bridge-1.0.5.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
|
9
|
+
gemini_bridge-1.0.5.dist-info/RECORD,,
|
src/__init__.py
CHANGED
src/mcp_server.py
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
#!/usr/bin/env python3
|
2
2
|
"""
|
3
3
|
Gemini MCP Server - Simple CLI Bridge
|
4
|
-
Version 1.0.
|
4
|
+
Version 1.0.5
|
5
5
|
A minimal MCP server to interface with Gemini AI via the gemini CLI.
|
6
6
|
Created by @shelakh/elyin
|
7
7
|
"""
|
@@ -10,17 +10,11 @@ import logging
|
|
10
10
|
import os
|
11
11
|
import shutil
|
12
12
|
import subprocess
|
13
|
-
import sys
|
14
13
|
from typing import List, Optional
|
15
14
|
|
16
15
|
from mcp.server.fastmcp import FastMCP
|
17
16
|
|
18
|
-
|
19
|
-
logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(name)s - %(levelname)s - %(message)s')
|
20
|
-
logger = logging.getLogger(__name__)
|
21
|
-
|
22
|
-
# FastMCP instance with correct port configuration
|
23
|
-
mcp = FastMCP("gemini-assistant", port=int(os.getenv("PORT", "8080")))
|
17
|
+
mcp = FastMCP("gemini-assistant")
|
24
18
|
|
25
19
|
|
26
20
|
def _normalize_model_name(model: Optional[str]) -> str:
|
@@ -56,37 +50,19 @@ def _get_timeout() -> int:
|
|
56
50
|
Timeout value in seconds (positive integer)
|
57
51
|
"""
|
58
52
|
timeout_str = os.getenv("GEMINI_BRIDGE_TIMEOUT")
|
59
|
-
logger.debug(
|
60
|
-
"Reading timeout from environment: GEMINI_BRIDGE_TIMEOUT=%s", timeout_str
|
61
|
-
)
|
62
|
-
|
63
53
|
if not timeout_str:
|
64
|
-
logger.info("GEMINI_BRIDGE_TIMEOUT not set, using default 60 seconds")
|
65
54
|
return 60
|
66
|
-
|
55
|
+
|
67
56
|
try:
|
68
57
|
timeout = int(timeout_str)
|
58
|
+
if timeout <= 0:
|
59
|
+
logging.warning("Invalid GEMINI_BRIDGE_TIMEOUT value '%s' (must be positive). Using default 60 seconds.", timeout_str)
|
60
|
+
return 60
|
61
|
+
return timeout
|
69
62
|
except ValueError:
|
70
|
-
|
71
|
-
"Invalid GEMINI_BRIDGE_TIMEOUT value '%s' (must be integer). Using default 60 seconds.",
|
72
|
-
timeout_str,
|
73
|
-
)
|
74
|
-
return 60
|
75
|
-
|
76
|
-
if timeout <= 0:
|
77
|
-
logger.warning(
|
78
|
-
"Invalid GEMINI_BRIDGE_TIMEOUT value '%s' (must be positive). Using default 60 seconds.",
|
79
|
-
timeout_str,
|
80
|
-
)
|
63
|
+
logging.warning("Invalid GEMINI_BRIDGE_TIMEOUT value '%s' (must be integer). Using default 60 seconds.", timeout_str)
|
81
64
|
return 60
|
82
65
|
|
83
|
-
logger.info("Using configured timeout: %s seconds", timeout)
|
84
|
-
if timeout > 300:
|
85
|
-
logger.warning(
|
86
|
-
"Large timeout configured (%ss). This may cause long waits for failed operations.",
|
87
|
-
timeout,
|
88
|
-
)
|
89
|
-
return timeout
|
90
66
|
|
91
67
|
def execute_gemini_simple(query: str, directory: str = ".", model: Optional[str] = None) -> str:
|
92
68
|
"""
|
@@ -114,9 +90,6 @@ def execute_gemini_simple(query: str, directory: str = ".", model: Optional[str]
|
|
114
90
|
|
115
91
|
# Execute CLI command - simple timeout, no retries
|
116
92
|
timeout = _get_timeout()
|
117
|
-
logger.info(f"Executing Gemini CLI with timeout: {timeout}s, model: {selected_model}, directory: {directory}")
|
118
|
-
logger.debug(f"Query length: {len(query)} characters")
|
119
|
-
|
120
93
|
try:
|
121
94
|
result = subprocess.run(
|
122
95
|
cmd,
|
@@ -127,25 +100,15 @@ def execute_gemini_simple(query: str, directory: str = ".", model: Optional[str]
|
|
127
100
|
input=query
|
128
101
|
)
|
129
102
|
|
130
|
-
logger.debug(f"Gemini CLI completed with return code: {result.returncode}")
|
131
|
-
|
132
103
|
if result.returncode == 0:
|
133
|
-
|
134
|
-
logger.info(f"Gemini CLI successful, output length: {len(output)} characters")
|
135
|
-
return output
|
104
|
+
return result.stdout.strip() if result.stdout.strip() else "No output from Gemini CLI"
|
136
105
|
else:
|
137
|
-
|
138
|
-
logger.error(error_msg)
|
139
|
-
return error_msg
|
106
|
+
return f"Gemini CLI Error: {result.stderr.strip()}"
|
140
107
|
|
141
108
|
except subprocess.TimeoutExpired:
|
142
|
-
|
143
|
-
logger.error(timeout_msg)
|
144
|
-
return timeout_msg
|
109
|
+
return f"Error: Gemini CLI command timed out after {timeout} seconds"
|
145
110
|
except Exception as e:
|
146
|
-
|
147
|
-
logger.error(error_msg)
|
148
|
-
return error_msg
|
111
|
+
return f"Error executing Gemini CLI: {str(e)}"
|
149
112
|
|
150
113
|
|
151
114
|
def execute_gemini_with_files(query: str, directory: str = ".", files: Optional[List[str]] = None, model: Optional[str] = None) -> str:
|
@@ -199,14 +162,6 @@ def execute_gemini_with_files(query: str, directory: str = ".", files: Optional[
|
|
199
162
|
|
200
163
|
# Execute CLI command - simple timeout, no retries
|
201
164
|
timeout = _get_timeout()
|
202
|
-
total_content_size = len(stdin_content)
|
203
|
-
logger.info(f"Executing Gemini CLI with files, timeout: {timeout}s, model: {selected_model}, directory: {directory}")
|
204
|
-
logger.info(f"File count: {len(files)}, total content size: {total_content_size} characters")
|
205
|
-
|
206
|
-
# Warn about large content that might timeout
|
207
|
-
if total_content_size > 100000: # 100KB threshold
|
208
|
-
logger.warning(f"Large content size ({total_content_size} chars). Consider increasing timeout if you experience timeouts.")
|
209
|
-
|
210
165
|
try:
|
211
166
|
result = subprocess.run(
|
212
167
|
cmd,
|
@@ -217,25 +172,15 @@ def execute_gemini_with_files(query: str, directory: str = ".", files: Optional[
|
|
217
172
|
input=stdin_content
|
218
173
|
)
|
219
174
|
|
220
|
-
logger.debug(f"Gemini CLI completed with return code: {result.returncode}")
|
221
|
-
|
222
175
|
if result.returncode == 0:
|
223
|
-
|
224
|
-
logger.info(f"Gemini CLI successful, output length: {len(output)} characters")
|
225
|
-
return output
|
176
|
+
return result.stdout.strip() if result.stdout.strip() else "No output from Gemini CLI"
|
226
177
|
else:
|
227
|
-
|
228
|
-
logger.error(error_msg)
|
229
|
-
return error_msg
|
178
|
+
return f"Gemini CLI Error: {result.stderr.strip()}"
|
230
179
|
|
231
180
|
except subprocess.TimeoutExpired:
|
232
|
-
|
233
|
-
logger.error(timeout_msg)
|
234
|
-
return timeout_msg
|
181
|
+
return f"Error: Gemini CLI command timed out after {timeout} seconds"
|
235
182
|
except Exception as e:
|
236
|
-
|
237
|
-
logger.error(error_msg)
|
238
|
-
return error_msg
|
183
|
+
return f"Error executing Gemini CLI: {str(e)}"
|
239
184
|
|
240
185
|
|
241
186
|
@mcp.tool()
|
@@ -287,120 +232,9 @@ def consult_gemini_with_files(
|
|
287
232
|
return execute_gemini_with_files(query, directory, files, model)
|
288
233
|
|
289
234
|
|
290
|
-
@mcp.tool()
|
291
|
-
def get_debug_info() -> str:
|
292
|
-
"""
|
293
|
-
Get diagnostic information about the Gemini Bridge configuration.
|
294
|
-
|
295
|
-
Useful for troubleshooting timeout issues and verifying setup.
|
296
|
-
|
297
|
-
Returns:
|
298
|
-
Formatted debug information including timeout configuration,
|
299
|
-
environment variables, and system status
|
300
|
-
"""
|
301
|
-
debug_info = []
|
302
|
-
debug_info.append("=== Gemini Bridge Debug Information ===\n")
|
303
|
-
|
304
|
-
# Timeout configuration
|
305
|
-
timeout_env = os.getenv("GEMINI_BRIDGE_TIMEOUT")
|
306
|
-
actual_timeout = _get_timeout()
|
307
|
-
debug_info.append("Timeout Configuration:")
|
308
|
-
debug_info.append(f" GEMINI_BRIDGE_TIMEOUT env var: {timeout_env or 'not set'}")
|
309
|
-
debug_info.append(f" Actual timeout used: {actual_timeout} seconds")
|
310
|
-
|
311
|
-
if actual_timeout == 60 and not timeout_env:
|
312
|
-
debug_info.append(" ⚠️ Using default timeout. Set GEMINI_BRIDGE_TIMEOUT=240 for large operations.")
|
313
|
-
elif actual_timeout < 120:
|
314
|
-
debug_info.append(" ⚠️ Timeout may be too low for large files or complex queries.")
|
315
|
-
elif actual_timeout > 300:
|
316
|
-
debug_info.append(f" ⚠️ Very high timeout configured. Failed operations will wait {actual_timeout}s.")
|
317
|
-
else:
|
318
|
-
debug_info.append(" ✓ Timeout looks reasonable for most operations.")
|
319
|
-
|
320
|
-
debug_info.append("")
|
321
|
-
|
322
|
-
# Gemini CLI status
|
323
|
-
gemini_path = shutil.which("gemini")
|
324
|
-
debug_info.append("Gemini CLI Status:")
|
325
|
-
debug_info.append(f" CLI available: {'✓ Yes' if gemini_path else '✗ No'}")
|
326
|
-
if gemini_path:
|
327
|
-
debug_info.append(f" CLI path: {gemini_path}")
|
328
|
-
try:
|
329
|
-
# Try to get version
|
330
|
-
result = subprocess.run(
|
331
|
-
["gemini", "--version"],
|
332
|
-
capture_output=True,
|
333
|
-
text=True,
|
334
|
-
timeout=5
|
335
|
-
)
|
336
|
-
if result.returncode == 0:
|
337
|
-
version = result.stdout.strip()
|
338
|
-
debug_info.append(f" CLI version: {version}")
|
339
|
-
else:
|
340
|
-
debug_info.append(f" CLI version check failed: {result.stderr.strip()}")
|
341
|
-
except Exception as e:
|
342
|
-
debug_info.append(f" CLI version check error: {str(e)}")
|
343
|
-
else:
|
344
|
-
debug_info.append(" ✗ Install with: npm install -g @google/gemini-cli")
|
345
|
-
|
346
|
-
debug_info.append("")
|
347
|
-
# Environment details
|
348
|
-
debug_info.append("Environment:")
|
349
|
-
debug_info.append(f" Python version: {sys.version.split()[0]}")
|
350
|
-
debug_info.append(f" Current working directory: {os.getcwd()}")
|
351
|
-
debug_info.append(f" PORT: {os.getenv('PORT', '8080')}")
|
352
|
-
|
353
|
-
# Check authentication status
|
354
|
-
try:
|
355
|
-
result = subprocess.run(
|
356
|
-
["gemini", "auth", "status"],
|
357
|
-
capture_output=True,
|
358
|
-
text=True,
|
359
|
-
timeout=10,
|
360
|
-
cwd="."
|
361
|
-
)
|
362
|
-
if result.returncode == 0:
|
363
|
-
debug_info.append(" Authentication: ✓ Logged in")
|
364
|
-
else:
|
365
|
-
debug_info.append(" Authentication: ✗ Not logged in - run 'gemini auth login'")
|
366
|
-
except Exception as e:
|
367
|
-
debug_info.append(f" Authentication status check failed: {str(e)}")
|
368
|
-
|
369
|
-
debug_info.append("")
|
370
|
-
|
371
|
-
# Recent environment variables that might affect operation
|
372
|
-
relevant_env_vars = [
|
373
|
-
"GEMINI_BRIDGE_TIMEOUT", "NODE_PATH", "PATH", "HOME",
|
374
|
-
"GOOGLE_APPLICATION_CREDENTIALS", "GOOGLE_CLOUD_PROJECT"
|
375
|
-
]
|
376
|
-
|
377
|
-
debug_info.append("Relevant Environment Variables:")
|
378
|
-
for var in relevant_env_vars:
|
379
|
-
value = os.getenv(var)
|
380
|
-
if value:
|
381
|
-
# Truncate very long values
|
382
|
-
display_value = value[:100] + "..." if len(value) > 100 else value
|
383
|
-
debug_info.append(f" {var}: {display_value}")
|
384
|
-
else:
|
385
|
-
debug_info.append(f" {var}: not set")
|
386
|
-
|
387
|
-
debug_info.append("")
|
388
|
-
debug_info.append("=== End Debug Information ===")
|
389
|
-
|
390
|
-
return "\n".join(debug_info)
|
391
|
-
|
392
|
-
|
393
235
|
def main():
|
394
236
|
"""Entry point for the MCP server."""
|
395
|
-
|
396
|
-
timeout = _get_timeout() # Log timeout configuration at startup
|
397
|
-
|
398
|
-
logger.info(f"Starting Gemini Bridge MCP Server on port {port}")
|
399
|
-
logger.info(f"Configured timeout: {timeout} seconds")
|
400
|
-
logger.info(f"Gemini CLI available: {shutil.which('gemini') is not None}")
|
401
|
-
|
402
|
-
# Run the MCP server with SSE transport (port is managed by the library)
|
403
|
-
mcp.run(transport="sse")
|
237
|
+
mcp.run()
|
404
238
|
|
405
239
|
|
406
240
|
if __name__ == "__main__":
|
@@ -1,9 +0,0 @@
|
|
1
|
-
gemini_bridge-1.0.4.dist-info/licenses/LICENSE,sha256=yTz_R8ocWu64Eubxr6vdZCKRS0dB_Pi3RbjUNn4qPxQ,1063
|
2
|
-
src/__init__.py,sha256=U_gAa2Z0ljR0Mn193WDvGATLlzB_UPNkyRDPU7OLPVw,190
|
3
|
-
src/__main__.py,sha256=12FoIYCXYYKu2_BYX1GS_h9E9qO41Q26B8zedRIDPBs,149
|
4
|
-
src/mcp_server.py,sha256=jioHBNwa1zLExONL1p60a1JWht_K2y7zRPQ_nN1eF4s,14557
|
5
|
-
gemini_bridge-1.0.4.dist-info/METADATA,sha256=wUJmFg56YQDH5ZmF9L-tqCuUQIV58-PNVOj2wpfFV7Y,16223
|
6
|
-
gemini_bridge-1.0.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
|
7
|
-
gemini_bridge-1.0.4.dist-info/entry_points.txt,sha256=ygWf0B23Gygq8mW_GzPx8rxIA19RR_RH4RG2I15lU3E,43
|
8
|
-
gemini_bridge-1.0.4.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
|
9
|
-
gemini_bridge-1.0.4.dist-info/RECORD,,
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|