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

gemini_deep_research_mcp-0.1.2.dist-info/METADATA

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: gemini-deep-research-mcp
+Version: 0.1.2
+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
+```
+
+## One-Click Install
+
+| IDE | Install |
+|-----|---------|
+| **Cursor** | [![Install in Cursor](https://img.shields.io/badge/Install-Cursor-blue?logo=cursor)](https://cursor.com/install-mcp?name=gemini-deep-research&config=eyJjb21tYW5kIjogInV2eCIsICJhcmdzIjogWyJnZW1pbmktZGVlcC1yZXNlYXJjaC1tY3AiXSwgImVudiI6IHsiR0VNSU5JX0FQSV9LRVkiOiAieW91ci1hcGkta2V5In19) |
+| **VS Code** | [![Install in VS Code](https://img.shields.io/badge/Install-VS%20Code-007ACC?logo=visualstudiocode)](vscode:mcp/install?config=%7B%22name%22%3A%20%22gemini-deep-research%22%2C%20%22command%22%3A%20%22uvx%22%2C%20%22args%22%3A%20%5B%22gemini-deep-research-mcp%22%5D%2C%20%22env%22%3A%20%7B%22GEMINI_API_KEY%22%3A%20%22your-api-key%22%7D%7D) |
+
+> Replace `your-api-key` with your [Gemini API key](https://aistudio.google.com/apikey).
+
+## Configuration
+
+**VS Code** (`.vscode/mcp.json`):
+
+```json
+{
+  "servers": {
+    "gemini-deep-research": {
+      "command": "uvx",
+      "args": ["gemini-deep-research-mcp"],
+      "env": {
+        "GEMINI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+**Claude Desktop** (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "gemini-deep-research": {
+      "command": "uvx",
+      "args": ["gemini-deep-research-mcp"],
+      "env": {
+        "GEMINI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+## Tool
+
+### `gemini_deep_research`
+
+Performs comprehensive web research using Gemini's Deep Research Agent.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `query` | string | ✅ | Research topic or question |
+| `include_citations` | boolean | ❌ | Include source citations (default: true) |
+
+## 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.2.dist-info}/RECORD

@@ -5,8 +5,8 @@ gemini_deep_research_mcp/extract.py,sha256=lBFB2GfpHdPQXRszV6yulfSTa5cU3ApwU0Kww
 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-0.1.2.dist-info/METADATA,sha256=o991BThOrBDuvj8c7MP7ZwwXpW1qC-pvKHZcwaaEeuY,3696
+gemini_deep_research_mcp-0.1.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+gemini_deep_research_mcp-0.1.2.dist-info/entry_points.txt,sha256=nE5DP4kZ2RG5LB1Ied-hykIRmBei2GJw0wy_PijepRE,82
+gemini_deep_research_mcp-0.1.2.dist-info/top_level.txt,sha256=sk90gOv-N7MHdyHhJE6N-fLVHrtFPfme8m1opjwXoMM,25
+gemini_deep_research_mcp-0.1.2.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