Local MCP execution bridge connecting Gemini Spark to local workspaces, filesystem, and development tools
VibeBridge provides 8 filesystem and command-execution tools with complete JSON schemas and descriptions. All tools have verb-noun naming (list_files, read_file, search_files, create_file, edit_file, delete_file, move_file, run_command) and descriptions ranging 80 - 200 chars. Schemas include type definitions and parameter descriptions. However, descriptions lack actionable context (when to use, prerequisites, recovery guidance). Error handling is minimal, no guidance on retryability, user-fixable vs fatal errors, or recovery paths. Output schemas are not documented. Destructive tools (delete_file, run_command) lack confirmation/dry-run patterns. Parameter constraints are present but some lack format/range details (e.g., timeout_ms has no min/max bounds). No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels.
Create a new file in the workspace with the specified content. Automatically creates parent folders if missing.
Delete a file or directory inside the workspace. Directory deletion requires recursive: true.
Safely edit a file by finding exact old_text and replacing it with new_text. Fails safely without modifying the file if old_text is not found.
List files and subdirectories within a workspace directory path. Returns name, relative path, size, and type.
Move or rename a file or directory within the workspace.
Read the text content of a file in the workspace. Supports optional line-based pagination for large files.
Destructive tools (delete_file, run_command) lack confirmation/dry-run patterns. Agents can irreversibly delete files or execute arbitrary commands without safeguards.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels declared in metadata. LLMs cannot distinguish safe reads from destructive writes without annotations.
Error handling is absent. No guidance on retryability, user-fixable errors, or recovery paths. E.g., 'file not found' should suggest search_files; 'permission denied' should guide the user.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 64 | <=2025-11-25 | v2 |
Execute a shell command inside the workspace working directory. Returns stdout, stderr, exit code, and execution duration.
Search for text or regex patterns across files in the workspace. Returns matching files, line numbers, and contents.
Output schemas are not documented. Callers cannot plan downstream tool calls or extract required fields (e.g., what does search_files return per match?).
Parameter constraints lack bounds. timeout_ms has no min/max; max_depth, max_files, max_results have no validation guidance. LLMs may pass absurd values (timeout_ms=999999999).