gemini-deep-research-mcp 0.1.0__tar.gz → 0.1.2__tar.gz

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.
Files changed (24) hide show
  1. gemini_deep_research_mcp-0.1.2/PKG-INFO +109 -0
  2. gemini_deep_research_mcp-0.1.2/README.md +231 -0
  3. gemini_deep_research_mcp-0.1.2/README.pypi.md +81 -0
  4. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/pyproject.toml +2 -2
  5. gemini_deep_research_mcp-0.1.2/src/gemini_deep_research_mcp.egg-info/PKG-INFO +109 -0
  6. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp.egg-info/SOURCES.txt +1 -0
  7. gemini_deep_research_mcp-0.1.0/PKG-INFO +0 -127
  8. gemini_deep_research_mcp-0.1.0/README.md +0 -99
  9. gemini_deep_research_mcp-0.1.0/src/gemini_deep_research_mcp.egg-info/PKG-INFO +0 -127
  10. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/setup.cfg +0 -0
  11. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp/__init__.py +0 -0
  12. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp/__main__.py +0 -0
  13. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp/config.py +0 -0
  14. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp/extract.py +0 -0
  15. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp/gemini.py +0 -0
  16. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp/resolve.py +0 -0
  17. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp/server.py +0 -0
  18. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp.egg-info/dependency_links.txt +0 -0
  19. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp.egg-info/entry_points.txt +0 -0
  20. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp.egg-info/requires.txt +0 -0
  21. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp.egg-info/top_level.txt +0 -0
  22. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/tests/test_extract.py +0 -0
  23. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/tests/test_server_output_format.py +0 -0
  24. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/tests/test_server_validation.py +0 -0
gemini_deep_research_mcp-0.1.2/PKG-INFO ADDED
@@ -0,0 +1,109 @@
1
+ Metadata-Version: 2.4
2
+ Name: gemini-deep-research-mcp
3
+ Version: 0.1.2
4
+ Summary: MCP server exposing Gemini Deep Research (Interactions API) tools
5
+ Author-email: Ayush <ayusin439@gmail.com>
6
+ License: MIT
7
+ Project-URL: Homepage, https://github.com/bharatvansh/gemini-deep-research-mcp
8
+ Project-URL: Repository, https://github.com/bharatvansh/gemini-deep-research-mcp
9
+ Project-URL: Issues, https://github.com/bharatvansh/gemini-deep-research-mcp/issues
10
+ Keywords: mcp,gemini,deep-research,ai,google,model-context-protocol,research,agent
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Intended Audience :: Developers
13
+ Classifier: License :: OSI Approved :: MIT License
14
+ Classifier: Operating System :: OS Independent
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Programming Language :: Python :: 3.10
17
+ Classifier: Programming Language :: Python :: 3.11
18
+ Classifier: Programming Language :: Python :: 3.12
19
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
20
+ Requires-Python: >=3.10
21
+ Description-Content-Type: text/markdown
22
+ Requires-Dist: mcp>=1.2.0
23
+ Requires-Dist: google-genai>=0.6.0
24
+ Requires-Dist: python-dotenv>=1.0.1
25
+ Requires-Dist: httpx>=0.27.0
26
+ Provides-Extra: dev
27
+ Requires-Dist: pytest>=8.0.0; extra == "dev"
28
+
29
+ # Gemini Deep Research MCP
30
+
31
+ [![PyPI version](https://img.shields.io/pypi/v/gemini-deep-research-mcp)](https://pypi.org/project/gemini-deep-research-mcp/)
32
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
33
+
34
+ An MCP server that exposes Gemini's **Deep Research Agent** for comprehensive web research.
35
+
36
+ ## Quick Start
37
+
38
+ ```bash
39
+ # Recommended (zero-install)
40
+ uvx gemini-deep-research-mcp
41
+
42
+ # Or install globally
43
+ pip install gemini-deep-research-mcp
44
+ gemini-deep-research-mcp
45
+ ```
46
+
47
+ ## One-Click Install
48
+
49
+ | IDE | Install |
50
+ |-----|---------|
51
+ | **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) |
52
+ | **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) |
53
+
54
+ > Replace `your-api-key` with your [Gemini API key](https://aistudio.google.com/apikey).
55
+
56
+ ## Configuration
57
+
58
+ **VS Code** (`.vscode/mcp.json`):
59
+
60
+ ```json
61
+ {
62
+ "servers": {
63
+ "gemini-deep-research": {
64
+ "command": "uvx",
65
+ "args": ["gemini-deep-research-mcp"],
66
+ "env": {
67
+ "GEMINI_API_KEY": "your-api-key"
68
+ }
69
+ }
70
+ }
71
+ }
72
+ ```
73
+
74
+ **Claude Desktop** (`claude_desktop_config.json`):
75
+
76
+ ```json
77
+ {
78
+ "mcpServers": {
79
+ "gemini-deep-research": {
80
+ "command": "uvx",
81
+ "args": ["gemini-deep-research-mcp"],
82
+ "env": {
83
+ "GEMINI_API_KEY": "your-api-key"
84
+ }
85
+ }
86
+ }
87
+ }
88
+ ```
89
+
90
+ ## Tool
91
+
92
+ ### `gemini_deep_research`
93
+
94
+ Performs comprehensive web research using Gemini's Deep Research Agent.
95
+
96
+ | Parameter | Type | Required | Description |
97
+ |-----------|------|----------|-------------|
98
+ | `query` | string | ✅ | Research topic or question |
99
+ | `include_citations` | boolean | ❌ | Include source citations (default: true) |
100
+
101
+ ## Links
102
+
103
+ - 📦 [npm Package](https://www.npmjs.com/package/@bharatvansh/gemini-deep-research-mcp)
104
+ - 🔧 [GitHub Repository](https://github.com/bharatvansh/gemini-deep-research-mcp)
105
+ - 🔑 [Get Gemini API Key](https://aistudio.google.com/apikey)
106
+
107
+ ## License
108
+
109
+ MIT
gemini_deep_research_mcp-0.1.2/README.md ADDED
@@ -0,0 +1,231 @@
1
+ # Gemini Deep Research MCP
2
+
3
+ [![PyPI version](https://img.shields.io/pypi/v/gemini-deep-research-mcp)](https://pypi.org/project/gemini-deep-research-mcp/)
4
+ [![npm version](https://img.shields.io/npm/v/@bharatvansh/gemini-deep-research-mcp)](https://www.npmjs.com/package/@bharatvansh/gemini-deep-research-mcp)
5
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6
+
7
+ An MCP server that exposes Gemini's **Deep Research Agent** for comprehensive web research.
8
+
9
+ ## One-Click Install
10
+
11
+ | IDE | Install |
12
+ |-----|---------|
13
+ | **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) |
14
+ | **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) |
15
+ | **VS Code Insiders** | [![Install in VS Code Insiders](https://img.shields.io/badge/Install-VS%20Code%20Insiders-24bfa5?logo=visualstudiocode)](vscode-insiders: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) |
16
+ | **Antigravity** | [See manual install](#antigravity) |
17
+
18
+ > **Note:** After clicking, replace `your-api-key` with your [Gemini API key](https://aistudio.google.com/apikey). VS Code requires version 1.101+.
19
+
20
+ ---
21
+
22
+ ## Installation Methods
23
+
24
+ ### Using npx (Node.js)
25
+
26
+ Requires [Node.js](https://nodejs.org/) 16+ and [uv](https://docs.astral.sh/uv/).
27
+
28
+ ```bash
29
+ npx @bharatvansh/gemini-deep-research-mcp
30
+ ```
31
+
32
+ <details>
33
+ <summary><strong>VS Code config</strong></summary>
34
+
35
+ ```json
36
+ {
37
+ "servers": {
38
+ "gemini-deep-research": {
39
+ "command": "npx",
40
+ "args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
41
+ "env": {
42
+ "GEMINI_API_KEY": "your-api-key"
43
+ }
44
+ }
45
+ }
46
+ }
47
+ ```
48
+ </details>
49
+
50
+ <details>
51
+ <summary><strong>Claude Desktop config</strong></summary>
52
+
53
+ ```json
54
+ {
55
+ "mcpServers": {
56
+ "gemini-deep-research": {
57
+ "command": "npx",
58
+ "args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
59
+ "env": {
60
+ "GEMINI_API_KEY": "your-api-key"
61
+ }
62
+ }
63
+ }
64
+ }
65
+ ```
66
+ </details>
67
+
68
+ ---
69
+
70
+ ### Using uvx (Python)
71
+
72
+ Requires [uv](https://docs.astral.sh/uv/).
73
+
74
+ ```bash
75
+ uvx gemini-deep-research-mcp
76
+ ```
77
+
78
+ <details>
79
+ <summary><strong>VS Code config</strong></summary>
80
+
81
+ ```json
82
+ {
83
+ "servers": {
84
+ "gemini-deep-research": {
85
+ "command": "uvx",
86
+ "args": ["gemini-deep-research-mcp"],
87
+ "env": {
88
+ "GEMINI_API_KEY": "your-api-key"
89
+ }
90
+ }
91
+ }
92
+ }
93
+ ```
94
+ </details>
95
+
96
+ <details>
97
+ <summary><strong>Claude Desktop config</strong></summary>
98
+
99
+ ```json
100
+ {
101
+ "mcpServers": {
102
+ "gemini-deep-research": {
103
+ "command": "uvx",
104
+ "args": ["gemini-deep-research-mcp"],
105
+ "env": {
106
+ "GEMINI_API_KEY": "your-api-key"
107
+ }
108
+ }
109
+ }
110
+ }
111
+ ```
112
+ </details>
113
+
114
+ ---
115
+
116
+ ### Using pip
117
+
118
+ ```bash
119
+ pip install gemini-deep-research-mcp
120
+ ```
121
+
122
+ <details>
123
+ <summary><strong>VS Code config</strong></summary>
124
+
125
+ ```json
126
+ {
127
+ "servers": {
128
+ "gemini-deep-research": {
129
+ "command": "gemini-deep-research-mcp",
130
+ "env": {
131
+ "GEMINI_API_KEY": "your-api-key"
132
+ }
133
+ }
134
+ }
135
+ }
136
+ ```
137
+ </details>
138
+
139
+ <details>
140
+ <summary><strong>Claude Desktop config</strong></summary>
141
+
142
+ ```json
143
+ {
144
+ "mcpServers": {
145
+ "gemini-deep-research": {
146
+ "command": "gemini-deep-research-mcp",
147
+ "env": {
148
+ "GEMINI_API_KEY": "your-api-key"
149
+ }
150
+ }
151
+ }
152
+ }
153
+ ```
154
+ </details>
155
+
156
+ ---
157
+
158
+ ### Antigravity
159
+
160
+ 1. Open the **Agent side panel** → click **...** → **MCP Store**
161
+ 2. Search for your MCP server or click **Add Custom Server**
162
+ 3. Add this configuration to your `mcp_config.json`:
163
+
164
+ ```json
165
+ {
166
+ "gemini-deep-research": {
167
+ "command": "uvx",
168
+ "args": ["gemini-deep-research-mcp"],
169
+ "env": {
170
+ "GEMINI_API_KEY": "your-api-key"
171
+ }
172
+ }
173
+ }
174
+ ```
175
+
176
+ ---
177
+
178
+ ## Prerequisites
179
+
180
+ <details>
181
+ <summary><strong>Install uv (required for npx/uvx methods)</strong></summary>
182
+
183
+ ```bash
184
+ # macOS/Linux
185
+ curl -LsSf https://astral.sh/uv/install.sh | sh
186
+
187
+ # Windows (PowerShell)
188
+ powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
189
+ ```
190
+ </details>
191
+
192
+ ---
193
+
194
+ ## Tool: `gemini_deep_research`
195
+
196
+ Conducts comprehensive web research using Gemini's Deep Research Agent. Blocks until research completes (typically 10-20 minutes).
197
+
198
+ **When to use:**
199
+ - Complex topics requiring multi-source analysis
200
+ - Synthesized information from the web
201
+ - Fact-checking and cross-referencing
202
+
203
+ | Parameter | Type | Required | Default | Description |
204
+ |-----------|------|----------|---------|-------------|
205
+ | `prompt` | string | ✓ | — | Your research question or topic |
206
+ | `include_citations` | boolean | | `true` | Include resolved source URLs |
207
+
208
+ | Output | Description |
209
+ |--------|-------------|
210
+ | `status` | `completed`, `failed`, or `cancelled` |
211
+ | `report_text` | Synthesized research report |
212
+
213
+ ## Configuration
214
+
215
+ | Variable | Required | Default | Description |
216
+ |----------|----------|---------|-------------|
217
+ | `GEMINI_API_KEY` | ✓ | — | Your [Gemini API key](https://aistudio.google.com/apikey) |
218
+ | `GEMINI_DEEP_RESEARCH_AGENT` | | `deep-research-pro-preview-12-2025` | Model to use |
219
+
220
+ ## Development
221
+
222
+ ```bash
223
+ git clone https://github.com/bharatvansh/gemini-deep-research-mcp.git
224
+ cd gemini-deep-research-mcp
225
+ pip install -e .[dev]
226
+ pytest
227
+ ```
228
+
229
+ ## License
230
+
231
+ MIT
gemini_deep_research_mcp-0.1.2/README.pypi.md ADDED
@@ -0,0 +1,81 @@
1
+ # Gemini Deep Research MCP
2
+
3
+ [![PyPI version](https://img.shields.io/pypi/v/gemini-deep-research-mcp)](https://pypi.org/project/gemini-deep-research-mcp/)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
+
6
+ An MCP server that exposes Gemini's **Deep Research Agent** for comprehensive web research.
7
+
8
+ ## Quick Start
9
+
10
+ ```bash
11
+ # Recommended (zero-install)
12
+ uvx gemini-deep-research-mcp
13
+
14
+ # Or install globally
15
+ pip install gemini-deep-research-mcp
16
+ gemini-deep-research-mcp
17
+ ```
18
+
19
+ ## One-Click Install
20
+
21
+ | IDE | Install |
22
+ |-----|---------|
23
+ | **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) |
24
+ | **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) |
25
+
26
+ > Replace `your-api-key` with your [Gemini API key](https://aistudio.google.com/apikey).
27
+
28
+ ## Configuration
29
+
30
+ **VS Code** (`.vscode/mcp.json`):
31
+
32
+ ```json
33
+ {
34
+ "servers": {
35
+ "gemini-deep-research": {
36
+ "command": "uvx",
37
+ "args": ["gemini-deep-research-mcp"],
38
+ "env": {
39
+ "GEMINI_API_KEY": "your-api-key"
40
+ }
41
+ }
42
+ }
43
+ }
44
+ ```
45
+
46
+ **Claude Desktop** (`claude_desktop_config.json`):
47
+
48
+ ```json
49
+ {
50
+ "mcpServers": {
51
+ "gemini-deep-research": {
52
+ "command": "uvx",
53
+ "args": ["gemini-deep-research-mcp"],
54
+ "env": {
55
+ "GEMINI_API_KEY": "your-api-key"
56
+ }
57
+ }
58
+ }
59
+ }
60
+ ```
61
+
62
+ ## Tool
63
+
64
+ ### `gemini_deep_research`
65
+
66
+ Performs comprehensive web research using Gemini's Deep Research Agent.
67
+
68
+ | Parameter | Type | Required | Description |
69
+ |-----------|------|----------|-------------|
70
+ | `query` | string | ✅ | Research topic or question |
71
+ | `include_citations` | boolean | ❌ | Include source citations (default: true) |
72
+
73
+ ## Links
74
+
75
+ - 📦 [npm Package](https://www.npmjs.com/package/@bharatvansh/gemini-deep-research-mcp)
76
+ - 🔧 [GitHub Repository](https://github.com/bharatvansh/gemini-deep-research-mcp)
77
+ - 🔑 [Get Gemini API Key](https://aistudio.google.com/apikey)
78
+
79
+ ## License
80
+
81
+ MIT
{gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/pyproject.toml RENAMED
@@ -4,9 +4,9 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "gemini-deep-research-mcp"
7
- version = "0.1.0"
7
+ version = "0.1.2"
8
8
  description = "MCP server exposing Gemini Deep Research (Interactions API) tools"
9
- readme = "README.md"
9
+ readme = "README.pypi.md"
10
10
  requires-python = ">=3.10"
11
11
  license = { text = "MIT" }
12
12
  authors = [{ name = "Ayush", email = "ayusin439@gmail.com" }]
gemini_deep_research_mcp-0.1.2/src/gemini_deep_research_mcp.egg-info/PKG-INFO ADDED
@@ -0,0 +1,109 @@
1
+ Metadata-Version: 2.4
2
+ Name: gemini-deep-research-mcp
3
+ Version: 0.1.2
4
+ Summary: MCP server exposing Gemini Deep Research (Interactions API) tools
5
+ Author-email: Ayush <ayusin439@gmail.com>
6
+ License: MIT
7
+ Project-URL: Homepage, https://github.com/bharatvansh/gemini-deep-research-mcp
8
+ Project-URL: Repository, https://github.com/bharatvansh/gemini-deep-research-mcp
9
+ Project-URL: Issues, https://github.com/bharatvansh/gemini-deep-research-mcp/issues
10
+ Keywords: mcp,gemini,deep-research,ai,google,model-context-protocol,research,agent
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Intended Audience :: Developers
13
+ Classifier: License :: OSI Approved :: MIT License
14
+ Classifier: Operating System :: OS Independent
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Programming Language :: Python :: 3.10
17
+ Classifier: Programming Language :: Python :: 3.11
18
+ Classifier: Programming Language :: Python :: 3.12
19
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
20
+ Requires-Python: >=3.10
21
+ Description-Content-Type: text/markdown
22
+ Requires-Dist: mcp>=1.2.0
23
+ Requires-Dist: google-genai>=0.6.0
24
+ Requires-Dist: python-dotenv>=1.0.1
25
+ Requires-Dist: httpx>=0.27.0
26
+ Provides-Extra: dev
27
+ Requires-Dist: pytest>=8.0.0; extra == "dev"
28
+
29
+ # Gemini Deep Research MCP
30
+
31
+ [![PyPI version](https://img.shields.io/pypi/v/gemini-deep-research-mcp)](https://pypi.org/project/gemini-deep-research-mcp/)
32
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
33
+
34
+ An MCP server that exposes Gemini's **Deep Research Agent** for comprehensive web research.
35
+
36
+ ## Quick Start
37
+
38
+ ```bash
39
+ # Recommended (zero-install)
40
+ uvx gemini-deep-research-mcp
41
+
42
+ # Or install globally
43
+ pip install gemini-deep-research-mcp
44
+ gemini-deep-research-mcp
45
+ ```
46
+
47
+ ## One-Click Install
48
+
49
+ | IDE | Install |
50
+ |-----|---------|
51
+ | **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) |
52
+ | **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) |
53
+
54
+ > Replace `your-api-key` with your [Gemini API key](https://aistudio.google.com/apikey).
55
+
56
+ ## Configuration
57
+
58
+ **VS Code** (`.vscode/mcp.json`):
59
+
60
+ ```json
61
+ {
62
+ "servers": {
63
+ "gemini-deep-research": {
64
+ "command": "uvx",
65
+ "args": ["gemini-deep-research-mcp"],
66
+ "env": {
67
+ "GEMINI_API_KEY": "your-api-key"
68
+ }
69
+ }
70
+ }
71
+ }
72
+ ```
73
+
74
+ **Claude Desktop** (`claude_desktop_config.json`):
75
+
76
+ ```json
77
+ {
78
+ "mcpServers": {
79
+ "gemini-deep-research": {
80
+ "command": "uvx",
81
+ "args": ["gemini-deep-research-mcp"],
82
+ "env": {
83
+ "GEMINI_API_KEY": "your-api-key"
84
+ }
85
+ }
86
+ }
87
+ }
88
+ ```
89
+
90
+ ## Tool
91
+
92
+ ### `gemini_deep_research`
93
+
94
+ Performs comprehensive web research using Gemini's Deep Research Agent.
95
+
96
+ | Parameter | Type | Required | Description |
97
+ |-----------|------|----------|-------------|
98
+ | `query` | string | ✅ | Research topic or question |
99
+ | `include_citations` | boolean | ❌ | Include source citations (default: true) |
100
+
101
+ ## Links
102
+
103
+ - 📦 [npm Package](https://www.npmjs.com/package/@bharatvansh/gemini-deep-research-mcp)
104
+ - 🔧 [GitHub Repository](https://github.com/bharatvansh/gemini-deep-research-mcp)
105
+ - 🔑 [Get Gemini API Key](https://aistudio.google.com/apikey)
106
+
107
+ ## License
108
+
109
+ MIT
{gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp.egg-info/SOURCES.txt RENAMED
@@ -1,4 +1,5 @@
1
1
  README.md
2
+ README.pypi.md
2
3
  pyproject.toml
3
4
  src/gemini_deep_research_mcp/__init__.py
4
5
  src/gemini_deep_research_mcp/__main__.py
gemini_deep_research_mcp-0.1.0/PKG-INFO DELETED
@@ -1,127 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: gemini-deep-research-mcp
3
- Version: 0.1.0
4
- Summary: MCP server exposing Gemini Deep Research (Interactions API) tools
5
- Author-email: Ayush <ayusin439@gmail.com>
6
- License: MIT
7
- Project-URL: Homepage, https://github.com/bharatvansh/gemini-deep-research-mcp
8
- Project-URL: Repository, https://github.com/bharatvansh/gemini-deep-research-mcp
9
- Project-URL: Issues, https://github.com/bharatvansh/gemini-deep-research-mcp/issues
10
- Keywords: mcp,gemini,deep-research,ai,google,model-context-protocol,research,agent
11
- Classifier: Development Status :: 4 - Beta
12
- Classifier: Intended Audience :: Developers
13
- Classifier: License :: OSI Approved :: MIT License
14
- Classifier: Operating System :: OS Independent
15
- Classifier: Programming Language :: Python :: 3
16
- Classifier: Programming Language :: Python :: 3.10
17
- Classifier: Programming Language :: Python :: 3.11
18
- Classifier: Programming Language :: Python :: 3.12
19
- Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
20
- Requires-Python: >=3.10
21
- Description-Content-Type: text/markdown
22
- Requires-Dist: mcp>=1.2.0
23
- Requires-Dist: google-genai>=0.6.0
24
- Requires-Dist: python-dotenv>=1.0.1
25
- Requires-Dist: httpx>=0.27.0
26
- Provides-Extra: dev
27
- Requires-Dist: pytest>=8.0.0; extra == "dev"
28
-
29
- # Gemini Deep Research MCP
30
-
31
- An MCP server that exposes Gemini's **Deep Research Agent** for comprehensive web research.
32
-
33
- ## Quick Start
34
-
35
- ```bash
36
- pip install gemini-deep-research-mcp
37
- ```
38
-
39
- Set your API key:
40
- ```bash
41
- export GEMINI_API_KEY="your-api-key" # macOS/Linux
42
- set GEMINI_API_KEY=your-api-key # Windows CMD
43
- $env:GEMINI_API_KEY="your-api-key" # Windows PowerShell
44
- ```
45
-
46
- ## MCP Client Setup
47
-
48
- ### VS Code (Copilot)
49
-
50
- Add to your VS Code settings or `.vscode/mcp.json`:
51
-
52
- ```json
53
- {
54
- "mcp": {
55
- "servers": {
56
- "gemini-deep-research": {
57
- "command": "gemini-deep-research-mcp",
58
- "env": {
59
- "GEMINI_API_KEY": "your-api-key"
60
- }
61
- }
62
- }
63
- }
64
- }
65
- ```
66
-
67
- ### Claude Desktop
68
-
69
- Add to `claude_desktop_config.json`:
70
-
71
- ```json
72
- {
73
- "mcpServers": {
74
- "gemini-deep-research": {
75
- "command": "gemini-deep-research-mcp",
76
- "env": {
77
- "GEMINI_API_KEY": "your-api-key"
78
- }
79
- }
80
- }
81
- }
82
- ```
83
-
84
- > **Windows**: If `gemini-deep-research-mcp` isn't in PATH, use full path: `C:\\Users\\YOU\\...\\python.exe` with args `["-m", "gemini_deep_research_mcp"]`
85
-
86
- ## Tool: `gemini_deep_research`
87
-
88
- Conducts comprehensive web research using Gemini's Deep Research Agent. Blocks until research completes (typically 10-20 minutes).
89
-
90
- **When to use:**
91
- - Complex topics requiring multi-source analysis
92
- - Synthesized information from the web
93
- - Fact-checking and cross-referencing
94
-
95
- **Parameters:**
96
-
97
- | Parameter | Type | Required | Default | Description |
98
- |-----------|------|----------|---------|-------------|
99
- | `prompt` | string | ✓ | — | Your research question or topic |
100
- | `include_citations` | boolean | | `true` | Include resolved source URLs |
101
-
102
- **Output:**
103
-
104
- | Field | Description |
105
- |-------|-------------|
106
- | `status` | `completed`, `failed`, or `cancelled` |
107
- | `report_text` | Synthesized research report |
108
-
109
- ## Configuration
110
-
111
- | Variable | Required | Default | Description |
112
- |----------|----------|---------|-------------|
113
- | `GEMINI_API_KEY` | ✓ | — | Your Gemini API key |
114
- | `GEMINI_DEEP_RESEARCH_AGENT` | | `deep-research-pro-preview-12-2025` | Model to use |
115
-
116
- ## Development
117
-
118
- ```bash
119
- git clone https://github.com/bharatvansh/gemini-deep-research-mcp.git
120
- cd gemini-deep-research-mcp
121
- pip install -e .[dev]
122
- pytest
123
- ```
124
-
125
- ## License
126
-
127
- MIT
gemini_deep_research_mcp-0.1.0/README.md DELETED
@@ -1,99 +0,0 @@
1
- # Gemini Deep Research MCP
2
-
3
- An MCP server that exposes Gemini's **Deep Research Agent** for comprehensive web research.
4
-
5
- ## Quick Start
6
-
7
- ```bash
8
- pip install gemini-deep-research-mcp
9
- ```
10
-
11
- Set your API key:
12
- ```bash
13
- export GEMINI_API_KEY="your-api-key" # macOS/Linux
14
- set GEMINI_API_KEY=your-api-key # Windows CMD
15
- $env:GEMINI_API_KEY="your-api-key" # Windows PowerShell
16
- ```
17
-
18
- ## MCP Client Setup
19
-
20
- ### VS Code (Copilot)
21
-
22
- Add to your VS Code settings or `.vscode/mcp.json`:
23
-
24
- ```json
25
- {
26
- "mcp": {
27
- "servers": {
28
- "gemini-deep-research": {
29
- "command": "gemini-deep-research-mcp",
30
- "env": {
31
- "GEMINI_API_KEY": "your-api-key"
32
- }
33
- }
34
- }
35
- }
36
- }
37
- ```
38
-
39
- ### Claude Desktop
40
-
41
- Add to `claude_desktop_config.json`:
42
-
43
- ```json
44
- {
45
- "mcpServers": {
46
- "gemini-deep-research": {
47
- "command": "gemini-deep-research-mcp",
48
- "env": {
49
- "GEMINI_API_KEY": "your-api-key"
50
- }
51
- }
52
- }
53
- }
54
- ```
55
-
56
- > **Windows**: If `gemini-deep-research-mcp` isn't in PATH, use full path: `C:\\Users\\YOU\\...\\python.exe` with args `["-m", "gemini_deep_research_mcp"]`
57
-
58
- ## Tool: `gemini_deep_research`
59
-
60
- Conducts comprehensive web research using Gemini's Deep Research Agent. Blocks until research completes (typically 10-20 minutes).
61
-
62
- **When to use:**
63
- - Complex topics requiring multi-source analysis
64
- - Synthesized information from the web
65
- - Fact-checking and cross-referencing
66
-
67
- **Parameters:**
68
-
69
- | Parameter | Type | Required | Default | Description |
70
- |-----------|------|----------|---------|-------------|
71
- | `prompt` | string | ✓ | — | Your research question or topic |
72
- | `include_citations` | boolean | | `true` | Include resolved source URLs |
73
-
74
- **Output:**
75
-
76
- | Field | Description |
77
- |-------|-------------|
78
- | `status` | `completed`, `failed`, or `cancelled` |
79
- | `report_text` | Synthesized research report |
80
-
81
- ## Configuration
82
-
83
- | Variable | Required | Default | Description |
84
- |----------|----------|---------|-------------|
85
- | `GEMINI_API_KEY` | ✓ | — | Your Gemini API key |
86
- | `GEMINI_DEEP_RESEARCH_AGENT` | | `deep-research-pro-preview-12-2025` | Model to use |
87
-
88
- ## Development
89
-
90
- ```bash
91
- git clone https://github.com/bharatvansh/gemini-deep-research-mcp.git
92
- cd gemini-deep-research-mcp
93
- pip install -e .[dev]
94
- pytest
95
- ```
96
-
97
- ## License
98
-
99
- MIT
gemini_deep_research_mcp-0.1.0/src/gemini_deep_research_mcp.egg-info/PKG-INFO DELETED
@@ -1,127 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: gemini-deep-research-mcp
3
- Version: 0.1.0
4
- Summary: MCP server exposing Gemini Deep Research (Interactions API) tools
5
- Author-email: Ayush <ayusin439@gmail.com>
6
- License: MIT
7
- Project-URL: Homepage, https://github.com/bharatvansh/gemini-deep-research-mcp
8
- Project-URL: Repository, https://github.com/bharatvansh/gemini-deep-research-mcp
9
- Project-URL: Issues, https://github.com/bharatvansh/gemini-deep-research-mcp/issues
10
- Keywords: mcp,gemini,deep-research,ai,google,model-context-protocol,research,agent
11
- Classifier: Development Status :: 4 - Beta
12
- Classifier: Intended Audience :: Developers
13
- Classifier: License :: OSI Approved :: MIT License
14
- Classifier: Operating System :: OS Independent
15
- Classifier: Programming Language :: Python :: 3
16
- Classifier: Programming Language :: Python :: 3.10
17
- Classifier: Programming Language :: Python :: 3.11
18
- Classifier: Programming Language :: Python :: 3.12
19
- Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
20
- Requires-Python: >=3.10
21
- Description-Content-Type: text/markdown
22
- Requires-Dist: mcp>=1.2.0
23
- Requires-Dist: google-genai>=0.6.0
24
- Requires-Dist: python-dotenv>=1.0.1
25
- Requires-Dist: httpx>=0.27.0
26
- Provides-Extra: dev
27
- Requires-Dist: pytest>=8.0.0; extra == "dev"
28
-
29
- # Gemini Deep Research MCP
30
-
31
- An MCP server that exposes Gemini's **Deep Research Agent** for comprehensive web research.
32
-
33
- ## Quick Start
34
-
35
- ```bash
36
- pip install gemini-deep-research-mcp
37
- ```
38
-
39
- Set your API key:
40
- ```bash
41
- export GEMINI_API_KEY="your-api-key" # macOS/Linux
42
- set GEMINI_API_KEY=your-api-key # Windows CMD
43
- $env:GEMINI_API_KEY="your-api-key" # Windows PowerShell
44
- ```
45
-
46
- ## MCP Client Setup
47
-
48
- ### VS Code (Copilot)
49
-
50
- Add to your VS Code settings or `.vscode/mcp.json`:
51
-
52
- ```json
53
- {
54
- "mcp": {
55
- "servers": {
56
- "gemini-deep-research": {
57
- "command": "gemini-deep-research-mcp",
58
- "env": {
59
- "GEMINI_API_KEY": "your-api-key"
60
- }
61
- }
62
- }
63
- }
64
- }
65
- ```
66
-
67
- ### Claude Desktop
68
-
69
- Add to `claude_desktop_config.json`:
70
-
71
- ```json
72
- {
73
- "mcpServers": {
74
- "gemini-deep-research": {
75
- "command": "gemini-deep-research-mcp",
76
- "env": {
77
- "GEMINI_API_KEY": "your-api-key"
78
- }
79
- }
80
- }
81
- }
82
- ```
83
-
84
- > **Windows**: If `gemini-deep-research-mcp` isn't in PATH, use full path: `C:\\Users\\YOU\\...\\python.exe` with args `["-m", "gemini_deep_research_mcp"]`
85
-
86
- ## Tool: `gemini_deep_research`
87
-
88
- Conducts comprehensive web research using Gemini's Deep Research Agent. Blocks until research completes (typically 10-20 minutes).
89
-
90
- **When to use:**
91
- - Complex topics requiring multi-source analysis
92
- - Synthesized information from the web
93
- - Fact-checking and cross-referencing
94
-
95
- **Parameters:**
96
-
97
- | Parameter | Type | Required | Default | Description |
98
- |-----------|------|----------|---------|-------------|
99
- | `prompt` | string | ✓ | — | Your research question or topic |
100
- | `include_citations` | boolean | | `true` | Include resolved source URLs |
101
-
102
- **Output:**
103
-
104
- | Field | Description |
105
- |-------|-------------|
106
- | `status` | `completed`, `failed`, or `cancelled` |
107
- | `report_text` | Synthesized research report |
108
-
109
- ## Configuration
110
-
111
- | Variable | Required | Default | Description |
112
- |----------|----------|---------|-------------|
113
- | `GEMINI_API_KEY` | ✓ | — | Your Gemini API key |
114
- | `GEMINI_DEEP_RESEARCH_AGENT` | | `deep-research-pro-preview-12-2025` | Model to use |
115
-
116
- ## Development
117
-
118
- ```bash
119
- git clone https://github.com/bharatvansh/gemini-deep-research-mcp.git
120
- cd gemini-deep-research-mcp
121
- pip install -e .[dev]
122
- pytest
123
- ```
124
-
125
- ## License
126
-
127
- MIT