gemini-deep-research-mcp 0.1.1__py3-none-any.whl → 0.1.3__py3-none-any.whl

gemini_deep_research_mcp/server.py

@@ -54,7 +54,7 @@ def _require_nonempty(value: Optional[str], *, field: str) -> str:
 _DEFAULT_TIMEOUT_SECONDS = 1200.0
 
 _DEEP_RESEARCH_DESCRIPTION = """
-Conduct comprehensive web research using Gemini's Deep Research Agent.
+Conduct comprehensive web research using a Deep Research Agent.
 
 When to use this tool:
 - Researching complex topics requiring multi-source analysis

gemini_deep_research_mcp-0.1.3.dist-info/METADATA

@@ -0,0 +1,417 @@
+Metadata-Version: 2.4
+Name: gemini-deep-research-mcp
+Version: 0.1.3
+Summary: MCP server exposing Gemini Deep Research (Interactions API) tools
+Author-email: Ayush <ayusin439@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/bharatvansh/gemini-deep-research-mcp
+Project-URL: Repository, https://github.com/bharatvansh/gemini-deep-research-mcp
+Project-URL: Issues, https://github.com/bharatvansh/gemini-deep-research-mcp/issues
+Keywords: mcp,gemini,deep-research,ai,google,model-context-protocol,research,agent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.2.0
+Requires-Dist: google-genai>=0.6.0
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: httpx>=0.27.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+
+# Gemini Deep Research MCP
+
+[![PyPI version](https://img.shields.io/pypi/v/gemini-deep-research-mcp)](https://pypi.org/project/gemini-deep-research-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+An MCP server that exposes Gemini's **Deep Research Agent** for comprehensive web research.
+
+## Quick Start
+
+```bash
+# Recommended (zero-install)
+uvx gemini-deep-research-mcp
+
+# Or install globally
+pip install gemini-deep-research-mcp
+gemini-deep-research-mcp
+```
+
+> **Requires:** [uv](https://docs.astral.sh/uv/) for uvx method
+
+## One-Click Install
+
+| IDE | Install |
+|-----|---------|
+| **Cursor** | [![Install in Cursor](https://img.shields.io/badge/Install-Cursor-blue?logo=cursor)](https://cursor.com/en/install-mcp?name=gemini-deep-research&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJnZW1pbmktZGVlcC1yZXNlYXJjaC1tY3AiXSwiZW52Ijp7IkdFTUlOSV9BUElfS0VZIjoieW91ci1hcGkta2V5In19) |
+| **VS Code** | [![Install in VS Code](https://img.shields.io/badge/Install-VS%20Code-007ACC?logo=visualstudiocode)](https://insiders.vscode.dev/redirect/mcp/install?name=gemini-deep-research&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22gemini-deep-research-mcp%22%5D%2C%22env%22%3A%7B%22GEMINI_API_KEY%22%3A%22your-api-key%22%7D%7D) |
+| **VS Code Insiders** | [![Install in VS Code Insiders](https://img.shields.io/badge/Install-VS%20Code%20Insiders-24bfa5?logo=visualstudiocode)](https://insiders.vscode.dev/redirect/mcp/install?name=gemini-deep-research&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22gemini-deep-research-mcp%22%5D%2C%22env%22%3A%7B%22GEMINI_API_KEY%22%3A%22your-api-key%22%7D%7D&quality=insiders) |
+
+> **Note:** After clicking, replace `your-api-key` with your [Gemini API key](https://aistudio.google.com/apikey). VS Code requires version 1.101+.
+
+---
+
+## Installation Methods
+
+### Using uvx (Recommended)
+
+Requires [uv](https://docs.astral.sh/uv/).
+
+```bash
+uvx gemini-deep-research-mcp
+```
+
+<details>
+<summary><strong>VS Code config</strong></summary>
+
+```json
+{
+  "servers": {
+    "gemini-deep-research": {
+      "command": "uvx",
+      "args": ["gemini-deep-research-mcp"],
+      "env": {
+        "GEMINI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Claude Desktop config</strong></summary>
+
+```json
+{
+  "mcpServers": {
+    "gemini-deep-research": {
+      "command": "uvx",
+      "args": ["gemini-deep-research-mcp"],
+      "env": {
+        "GEMINI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Windsurf config</strong></summary>
+
+Add to `~/.codeium/windsurf/mcp_config.json` (macOS/Linux) or `%USERPROFILE%\.codeium\windsurf\mcp_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "gemini-deep-research": {
+      "command": "uvx",
+      "args": ["gemini-deep-research-mcp"],
+      "env": {
+        "GEMINI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Cline config</strong></summary>
+
+```json
+{
+  "mcpServers": {
+    "gemini-deep-research": {
+      "command": "uvx",
+      "args": ["gemini-deep-research-mcp"],
+      "env": {
+        "GEMINI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Claude Code config</strong></summary>
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "gemini-deep-research": {
+      "command": "uvx",
+      "args": ["gemini-deep-research-mcp"],
+      "env": {
+        "GEMINI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Codex config</strong></summary>
+
+Add to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.gemini-deep-research]
+command = "uvx"
+args = ["gemini-deep-research-mcp"]
+
+[mcp_servers.gemini-deep-research.env]
+GEMINI_API_KEY = "your-api-key"
+```
+</details>
+
+<details>
+<summary><strong>Cursor config</strong></summary>
+
+Add to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "gemini-deep-research": {
+      "command": "uvx",
+      "args": ["gemini-deep-research-mcp"],
+      "env": {
+        "GEMINI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Antigravity config</strong></summary>
+
+Add to your Antigravity `mcp_config.json`:
+
+```json
+{
+  "gemini-deep-research": {
+    "command": "uvx",
+    "args": ["gemini-deep-research-mcp"],
+    "env": {
+      "GEMINI_API_KEY": "your-api-key"
+    }
+  }
+}
+```
+</details>
+
+---
+
+### Using pip
+
+```bash
+pip install gemini-deep-research-mcp
+```
+
+<details>
+<summary><strong>VS Code config</strong></summary>
+
+```json
+{
+  "servers": {
+    "gemini-deep-research": {
+      "command": "gemini-deep-research-mcp",
+      "env": {
+        "GEMINI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Claude Desktop config</strong></summary>
+
+```json
+{
+  "mcpServers": {
+    "gemini-deep-research": {
+      "command": "gemini-deep-research-mcp",
+      "env": {
+        "GEMINI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Windsurf config</strong></summary>
+
+Add to `~/.codeium/windsurf/mcp_config.json` (macOS/Linux) or `%USERPROFILE%\.codeium\windsurf\mcp_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "gemini-deep-research": {
+      "command": "gemini-deep-research-mcp",
+      "env": {
+        "GEMINI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Cline config</strong></summary>
+
+```json
+{
+  "mcpServers": {
+    "gemini-deep-research": {
+      "command": "gemini-deep-research-mcp",
+      "env": {
+        "GEMINI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Claude Code config</strong></summary>
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "gemini-deep-research": {
+      "command": "gemini-deep-research-mcp",
+      "env": {
+        "GEMINI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Codex config</strong></summary>
+
+Add to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.gemini-deep-research]
+command = "gemini-deep-research-mcp"
+
+[mcp_servers.gemini-deep-research.env]
+GEMINI_API_KEY = "your-api-key"
+```
+</details>
+
+<details>
+<summary><strong>Cursor config</strong></summary>
+
+Add to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "gemini-deep-research": {
+      "command": "gemini-deep-research-mcp",
+      "env": {
+        "GEMINI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Antigravity config</strong></summary>
+
+Add to your Antigravity `mcp_config.json`:
+
+```json
+{
+  "gemini-deep-research": {
+    "command": "gemini-deep-research-mcp",
+    "env": {
+      "GEMINI_API_KEY": "your-api-key"
+    }
+  }
+}
+```
+</details>
+
+---
+
+## Prerequisites
+
+<details>
+<summary><strong>Install uv (required for uvx method)</strong></summary>
+
+```bash
+# macOS/Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows (PowerShell)
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+</details>
+
+---
+
+## Tool: `gemini_deep_research`
+
+Conducts comprehensive web research using Gemini's Deep Research Agent. Blocks until research completes (typically 10-20 minutes).
+
+**When to use:**
+- Complex topics requiring multi-source analysis
+- Synthesized information from the web
+- Fact-checking and cross-referencing
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `prompt` | string | ✓ | — | Your research question or topic |
+| `include_citations` | boolean | | `true` | Include resolved source URLs |
+
+| Output | Description |
+|--------|-------------|
+| `status` | `completed`, `failed`, or `cancelled` |
+| `report_text` | Synthesized research report |
+
+## Configuration
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `GEMINI_API_KEY` | ✓ | — | Your [Gemini API key](https://aistudio.google.com/apikey) |
+| `GEMINI_DEEP_RESEARCH_AGENT` | | `deep-research-pro-preview-12-2025` | Model to use |
+
+## Links
+
+- 📦 [npm Package](https://www.npmjs.com/package/@bharatvansh/gemini-deep-research-mcp)
+- 🔧 [GitHub Repository](https://github.com/bharatvansh/gemini-deep-research-mcp)
+- 🔑 [Get Gemini API Key](https://aistudio.google.com/apikey)
+
+## License
+
+MIT

{gemini_deep_research_mcp-0.1.1.dist-info → gemini_deep_research_mcp-0.1.3.dist-info}/RECORD

@@ -4,9 +4,9 @@ gemini_deep_research_mcp/config.py,sha256=7Cbk8EnW7VhaqkVwoX4sW2jekccQRdLraM89Lo
 gemini_deep_research_mcp/extract.py,sha256=lBFB2GfpHdPQXRszV6yulfSTa5cU3ApwU0KwwGg3450,2300
 gemini_deep_research_mcp/gemini.py,sha256=-4wptf99qVcukl0vsohsQQDBwMPq-B7LzZHqjpPZSqg,1572
 gemini_deep_research_mcp/resolve.py,sha256=LmSuTGOe1-qjToKdQL6pcpNlzoMQwn43_uzX1KSQvOo,3105
-gemini_deep_research_mcp/server.py,sha256=lAolJPB-fV4oN9W0Ldq4VQYkXt86Zxd3SVInwT3QsNk,3991
-gemini_deep_research_mcp-0.1.1.dist-info/METADATA,sha256=vThBjNYnfR5iNanKFrA1ycVh5oUuQ_I4o4jFmIo7fM4,5659
-gemini_deep_research_mcp-0.1.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-gemini_deep_research_mcp-0.1.1.dist-info/entry_points.txt,sha256=nE5DP4kZ2RG5LB1Ied-hykIRmBei2GJw0wy_PijepRE,82
-gemini_deep_research_mcp-0.1.1.dist-info/top_level.txt,sha256=sk90gOv-N7MHdyHhJE6N-fLVHrtFPfme8m1opjwXoMM,25
-gemini_deep_research_mcp-0.1.1.dist-info/RECORD,,
+gemini_deep_research_mcp/server.py,sha256=scxUHsHEzsmJIUkUqV-orEeHU9MCpAYNHZx6ehCjrM0,3984
+gemini_deep_research_mcp-0.1.3.dist-info/METADATA,sha256=2pmmvQ0bhDlK-FhDtN9rf7hKAfN-RxJFBxwT9MDHUjU,9585
+gemini_deep_research_mcp-0.1.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+gemini_deep_research_mcp-0.1.3.dist-info/entry_points.txt,sha256=nE5DP4kZ2RG5LB1Ied-hykIRmBei2GJw0wy_PijepRE,82
+gemini_deep_research_mcp-0.1.3.dist-info/top_level.txt,sha256=sk90gOv-N7MHdyHhJE6N-fLVHrtFPfme8m1opjwXoMM,25
+gemini_deep_research_mcp-0.1.3.dist-info/RECORD,,

gemini_deep_research_mcp-0.1.1.dist-info/METADATA

@@ -1,236 +0,0 @@
-Metadata-Version: 2.4
-Name: gemini-deep-research-mcp
-Version: 0.1.1
-Summary: MCP server exposing Gemini Deep Research (Interactions API) tools
-Author-email: Ayush <ayusin439@gmail.com>
-License: MIT
-Project-URL: Homepage, https://github.com/bharatvansh/gemini-deep-research-mcp
-Project-URL: Repository, https://github.com/bharatvansh/gemini-deep-research-mcp
-Project-URL: Issues, https://github.com/bharatvansh/gemini-deep-research-mcp/issues
-Keywords: mcp,gemini,deep-research,ai,google,model-context-protocol,research,agent
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: mcp>=1.2.0
-Requires-Dist: google-genai>=0.6.0
-Requires-Dist: python-dotenv>=1.0.1
-Requires-Dist: httpx>=0.27.0
-Provides-Extra: dev
-Requires-Dist: pytest>=8.0.0; extra == "dev"
-
-# Gemini Deep Research MCP
-
-[![PyPI version](https://img.shields.io/pypi/v/gemini-deep-research-mcp)](https://pypi.org/project/gemini-deep-research-mcp/)
-[![npm version](https://img.shields.io/npm/v/gemini-deep-research-mcp)](https://www.npmjs.com/package/gemini-deep-research-mcp)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-An MCP server that exposes Gemini's **Deep Research Agent** for comprehensive web research.
-
-## One-Click Install
-
-### Cursor
-
-[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=gemini-deep-research&config=eyJjb21tYW5kIjogInV2eCIsICJhcmdzIjogWyJnZW1pbmktZGVlcC1yZXNlYXJjaC1tY3AiXSwgImVudiI6IHsiR0VNSU5JX0FQSV9LRVkiOiAieW91ci1hcGkta2V5In19)
-
-Click the button, then replace `your-api-key` with your [Gemini API key](https://aistudio.google.com/apikey).
-
----
-
-## Installation Methods
-
-### Using npx (Node.js)
-
-Requires [Node.js](https://nodejs.org/) 16+ and [uv](https://docs.astral.sh/uv/).
-
-```bash
-npx gemini-deep-research-mcp
-```
-
-<details>
-<summary><strong>VS Code config</strong></summary>
-
-```json
-{
-  "servers": {
-    "gemini-deep-research": {
-      "command": "npx",
-      "args": ["-y", "gemini-deep-research-mcp"],
-      "env": {
-        "GEMINI_API_KEY": "your-api-key"
-      }
-    }
-  }
-}
-```
-</details>
-
-<details>
-<summary><strong>Claude Desktop config</strong></summary>
-
-```json
-{
-  "mcpServers": {
-    "gemini-deep-research": {
-      "command": "npx",
-      "args": ["-y", "gemini-deep-research-mcp"],
-      "env": {
-        "GEMINI_API_KEY": "your-api-key"
-      }
-    }
-  }
-}
-```
-</details>
-
----
-
-### Using uvx (Python)
-
-Requires [uv](https://docs.astral.sh/uv/).
-
-```bash
-uvx gemini-deep-research-mcp
-```
-
-<details>
-<summary><strong>VS Code config</strong></summary>
-
-```json
-{
-  "servers": {
-    "gemini-deep-research": {
-      "command": "uvx",
-      "args": ["gemini-deep-research-mcp"],
-      "env": {
-        "GEMINI_API_KEY": "your-api-key"
-      }
-    }
-  }
-}
-```
-</details>
-
-<details>
-<summary><strong>Claude Desktop config</strong></summary>
-
-```json
-{
-  "mcpServers": {
-    "gemini-deep-research": {
-      "command": "uvx",
-      "args": ["gemini-deep-research-mcp"],
-      "env": {
-        "GEMINI_API_KEY": "your-api-key"
-      }
-    }
-  }
-}
-```
-</details>
-
----
-
-### Using pip
-
-```bash
-pip install gemini-deep-research-mcp
-```
-
-<details>
-<summary><strong>VS Code config</strong></summary>
-
-```json
-{
-  "servers": {
-    "gemini-deep-research": {
-      "command": "gemini-deep-research-mcp",
-      "env": {
-        "GEMINI_API_KEY": "your-api-key"
-      }
-    }
-  }
-}
-```
-</details>
-
-<details>
-<summary><strong>Claude Desktop config</strong></summary>
-
-```json
-{
-  "mcpServers": {
-    "gemini-deep-research": {
-      "command": "gemini-deep-research-mcp",
-      "env": {
-        "GEMINI_API_KEY": "your-api-key"
-      }
-    }
-  }
-}
-```
-</details>
-
----
-
-## Prerequisites
-
-<details>
-<summary><strong>Install uv (required for npx/uvx methods)</strong></summary>
-
-```bash
-# macOS/Linux
-curl -LsSf https://astral.sh/uv/install.sh | sh
-
-# Windows (PowerShell)
-powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
-```
-</details>
-
----
-
-## Tool: `gemini_deep_research`
-
-Conducts comprehensive web research using Gemini's Deep Research Agent. Blocks until research completes (typically 10-20 minutes).
-
-**When to use:**
-- Complex topics requiring multi-source analysis
-- Synthesized information from the web
-- Fact-checking and cross-referencing
-
-| Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `prompt` | string | ✓ | — | Your research question or topic |
-| `include_citations` | boolean | | `true` | Include resolved source URLs |
-
-| Output | Description |
-|--------|-------------|
-| `status` | `completed`, `failed`, or `cancelled` |
-| `report_text` | Synthesized research report |
-
-## Configuration
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `GEMINI_API_KEY` | ✓ | — | Your [Gemini API key](https://aistudio.google.com/apikey) |
-| `GEMINI_DEEP_RESEARCH_AGENT` | | `deep-research-pro-preview-12-2025` | Model to use |
-
-## Development
-
-```bash
-git clone https://github.com/bharatvansh/gemini-deep-research-mcp.git
-cd gemini-deep-research-mcp
-pip install -e .[dev]
-pytest
-```
-
-## License
-
-MIT