gemini-deep-research-mcp 0.1.0__tar.gz → 0.1.1__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 (23) hide show
  1. gemini_deep_research_mcp-0.1.1/PKG-INFO +236 -0
  2. gemini_deep_research_mcp-0.1.1/README.md +208 -0
  3. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.1}/pyproject.toml +1 -1
  4. gemini_deep_research_mcp-0.1.1/src/gemini_deep_research_mcp.egg-info/PKG-INFO +236 -0
  5. gemini_deep_research_mcp-0.1.0/PKG-INFO +0 -127
  6. gemini_deep_research_mcp-0.1.0/README.md +0 -99
  7. gemini_deep_research_mcp-0.1.0/src/gemini_deep_research_mcp.egg-info/PKG-INFO +0 -127
  8. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.1}/setup.cfg +0 -0
  9. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.1}/src/gemini_deep_research_mcp/__init__.py +0 -0
  10. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.1}/src/gemini_deep_research_mcp/__main__.py +0 -0
  11. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.1}/src/gemini_deep_research_mcp/config.py +0 -0
  12. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.1}/src/gemini_deep_research_mcp/extract.py +0 -0
  13. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.1}/src/gemini_deep_research_mcp/gemini.py +0 -0
  14. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.1}/src/gemini_deep_research_mcp/resolve.py +0 -0
  15. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.1}/src/gemini_deep_research_mcp/server.py +0 -0
  16. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.1}/src/gemini_deep_research_mcp.egg-info/SOURCES.txt +0 -0
  17. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.1}/src/gemini_deep_research_mcp.egg-info/dependency_links.txt +0 -0
  18. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.1}/src/gemini_deep_research_mcp.egg-info/entry_points.txt +0 -0
  19. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.1}/src/gemini_deep_research_mcp.egg-info/requires.txt +0 -0
  20. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.1}/src/gemini_deep_research_mcp.egg-info/top_level.txt +0 -0
  21. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.1}/tests/test_extract.py +0 -0
  22. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.1}/tests/test_server_output_format.py +0 -0
  23. {gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.1}/tests/test_server_validation.py +0 -0
gemini_deep_research_mcp-0.1.1/PKG-INFO ADDED
@@ -0,0 +1,236 @@
1
+ Metadata-Version: 2.4
2
+ Name: gemini-deep-research-mcp
3
+ Version: 0.1.1
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
+ [![npm version](https://img.shields.io/npm/v/gemini-deep-research-mcp)](https://www.npmjs.com/package/gemini-deep-research-mcp)
33
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
34
+
35
+ An MCP server that exposes Gemini's **Deep Research Agent** for comprehensive web research.
36
+
37
+ ## One-Click Install
38
+
39
+ ### Cursor
40
+
41
+ [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=gemini-deep-research&config=eyJjb21tYW5kIjogInV2eCIsICJhcmdzIjogWyJnZW1pbmktZGVlcC1yZXNlYXJjaC1tY3AiXSwgImVudiI6IHsiR0VNSU5JX0FQSV9LRVkiOiAieW91ci1hcGkta2V5In19)
42
+
43
+ Click the button, then replace `your-api-key` with your [Gemini API key](https://aistudio.google.com/apikey).
44
+
45
+ ---
46
+
47
+ ## Installation Methods
48
+
49
+ ### Using npx (Node.js)
50
+
51
+ Requires [Node.js](https://nodejs.org/) 16+ and [uv](https://docs.astral.sh/uv/).
52
+
53
+ ```bash
54
+ npx gemini-deep-research-mcp
55
+ ```
56
+
57
+ <details>
58
+ <summary><strong>VS Code config</strong></summary>
59
+
60
+ ```json
61
+ {
62
+ "servers": {
63
+ "gemini-deep-research": {
64
+ "command": "npx",
65
+ "args": ["-y", "gemini-deep-research-mcp"],
66
+ "env": {
67
+ "GEMINI_API_KEY": "your-api-key"
68
+ }
69
+ }
70
+ }
71
+ }
72
+ ```
73
+ </details>
74
+
75
+ <details>
76
+ <summary><strong>Claude Desktop config</strong></summary>
77
+
78
+ ```json
79
+ {
80
+ "mcpServers": {
81
+ "gemini-deep-research": {
82
+ "command": "npx",
83
+ "args": ["-y", "gemini-deep-research-mcp"],
84
+ "env": {
85
+ "GEMINI_API_KEY": "your-api-key"
86
+ }
87
+ }
88
+ }
89
+ }
90
+ ```
91
+ </details>
92
+
93
+ ---
94
+
95
+ ### Using uvx (Python)
96
+
97
+ Requires [uv](https://docs.astral.sh/uv/).
98
+
99
+ ```bash
100
+ uvx gemini-deep-research-mcp
101
+ ```
102
+
103
+ <details>
104
+ <summary><strong>VS Code config</strong></summary>
105
+
106
+ ```json
107
+ {
108
+ "servers": {
109
+ "gemini-deep-research": {
110
+ "command": "uvx",
111
+ "args": ["gemini-deep-research-mcp"],
112
+ "env": {
113
+ "GEMINI_API_KEY": "your-api-key"
114
+ }
115
+ }
116
+ }
117
+ }
118
+ ```
119
+ </details>
120
+
121
+ <details>
122
+ <summary><strong>Claude Desktop config</strong></summary>
123
+
124
+ ```json
125
+ {
126
+ "mcpServers": {
127
+ "gemini-deep-research": {
128
+ "command": "uvx",
129
+ "args": ["gemini-deep-research-mcp"],
130
+ "env": {
131
+ "GEMINI_API_KEY": "your-api-key"
132
+ }
133
+ }
134
+ }
135
+ }
136
+ ```
137
+ </details>
138
+
139
+ ---
140
+
141
+ ### Using pip
142
+
143
+ ```bash
144
+ pip install gemini-deep-research-mcp
145
+ ```
146
+
147
+ <details>
148
+ <summary><strong>VS Code config</strong></summary>
149
+
150
+ ```json
151
+ {
152
+ "servers": {
153
+ "gemini-deep-research": {
154
+ "command": "gemini-deep-research-mcp",
155
+ "env": {
156
+ "GEMINI_API_KEY": "your-api-key"
157
+ }
158
+ }
159
+ }
160
+ }
161
+ ```
162
+ </details>
163
+
164
+ <details>
165
+ <summary><strong>Claude Desktop config</strong></summary>
166
+
167
+ ```json
168
+ {
169
+ "mcpServers": {
170
+ "gemini-deep-research": {
171
+ "command": "gemini-deep-research-mcp",
172
+ "env": {
173
+ "GEMINI_API_KEY": "your-api-key"
174
+ }
175
+ }
176
+ }
177
+ }
178
+ ```
179
+ </details>
180
+
181
+ ---
182
+
183
+ ## Prerequisites
184
+
185
+ <details>
186
+ <summary><strong>Install uv (required for npx/uvx methods)</strong></summary>
187
+
188
+ ```bash
189
+ # macOS/Linux
190
+ curl -LsSf https://astral.sh/uv/install.sh | sh
191
+
192
+ # Windows (PowerShell)
193
+ powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
194
+ ```
195
+ </details>
196
+
197
+ ---
198
+
199
+ ## Tool: `gemini_deep_research`
200
+
201
+ Conducts comprehensive web research using Gemini's Deep Research Agent. Blocks until research completes (typically 10-20 minutes).
202
+
203
+ **When to use:**
204
+ - Complex topics requiring multi-source analysis
205
+ - Synthesized information from the web
206
+ - Fact-checking and cross-referencing
207
+
208
+ | Parameter | Type | Required | Default | Description |
209
+ |-----------|------|----------|---------|-------------|
210
+ | `prompt` | string | ✓ | — | Your research question or topic |
211
+ | `include_citations` | boolean | | `true` | Include resolved source URLs |
212
+
213
+ | Output | Description |
214
+ |--------|-------------|
215
+ | `status` | `completed`, `failed`, or `cancelled` |
216
+ | `report_text` | Synthesized research report |
217
+
218
+ ## Configuration
219
+
220
+ | Variable | Required | Default | Description |
221
+ |----------|----------|---------|-------------|
222
+ | `GEMINI_API_KEY` | ✓ | — | Your [Gemini API key](https://aistudio.google.com/apikey) |
223
+ | `GEMINI_DEEP_RESEARCH_AGENT` | | `deep-research-pro-preview-12-2025` | Model to use |
224
+
225
+ ## Development
226
+
227
+ ```bash
228
+ git clone https://github.com/bharatvansh/gemini-deep-research-mcp.git
229
+ cd gemini-deep-research-mcp
230
+ pip install -e .[dev]
231
+ pytest
232
+ ```
233
+
234
+ ## License
235
+
236
+ MIT
gemini_deep_research_mcp-0.1.1/README.md ADDED
@@ -0,0 +1,208 @@
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/gemini-deep-research-mcp)](https://www.npmjs.com/package/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
+ ### Cursor
12
+
13
+ [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=gemini-deep-research&config=eyJjb21tYW5kIjogInV2eCIsICJhcmdzIjogWyJnZW1pbmktZGVlcC1yZXNlYXJjaC1tY3AiXSwgImVudiI6IHsiR0VNSU5JX0FQSV9LRVkiOiAieW91ci1hcGkta2V5In19)
14
+
15
+ Click the button, then replace `your-api-key` with your [Gemini API key](https://aistudio.google.com/apikey).
16
+
17
+ ---
18
+
19
+ ## Installation Methods
20
+
21
+ ### Using npx (Node.js)
22
+
23
+ Requires [Node.js](https://nodejs.org/) 16+ and [uv](https://docs.astral.sh/uv/).
24
+
25
+ ```bash
26
+ npx gemini-deep-research-mcp
27
+ ```
28
+
29
+ <details>
30
+ <summary><strong>VS Code config</strong></summary>
31
+
32
+ ```json
33
+ {
34
+ "servers": {
35
+ "gemini-deep-research": {
36
+ "command": "npx",
37
+ "args": ["-y", "gemini-deep-research-mcp"],
38
+ "env": {
39
+ "GEMINI_API_KEY": "your-api-key"
40
+ }
41
+ }
42
+ }
43
+ }
44
+ ```
45
+ </details>
46
+
47
+ <details>
48
+ <summary><strong>Claude Desktop config</strong></summary>
49
+
50
+ ```json
51
+ {
52
+ "mcpServers": {
53
+ "gemini-deep-research": {
54
+ "command": "npx",
55
+ "args": ["-y", "gemini-deep-research-mcp"],
56
+ "env": {
57
+ "GEMINI_API_KEY": "your-api-key"
58
+ }
59
+ }
60
+ }
61
+ }
62
+ ```
63
+ </details>
64
+
65
+ ---
66
+
67
+ ### Using uvx (Python)
68
+
69
+ Requires [uv](https://docs.astral.sh/uv/).
70
+
71
+ ```bash
72
+ uvx gemini-deep-research-mcp
73
+ ```
74
+
75
+ <details>
76
+ <summary><strong>VS Code config</strong></summary>
77
+
78
+ ```json
79
+ {
80
+ "servers": {
81
+ "gemini-deep-research": {
82
+ "command": "uvx",
83
+ "args": ["gemini-deep-research-mcp"],
84
+ "env": {
85
+ "GEMINI_API_KEY": "your-api-key"
86
+ }
87
+ }
88
+ }
89
+ }
90
+ ```
91
+ </details>
92
+
93
+ <details>
94
+ <summary><strong>Claude Desktop config</strong></summary>
95
+
96
+ ```json
97
+ {
98
+ "mcpServers": {
99
+ "gemini-deep-research": {
100
+ "command": "uvx",
101
+ "args": ["gemini-deep-research-mcp"],
102
+ "env": {
103
+ "GEMINI_API_KEY": "your-api-key"
104
+ }
105
+ }
106
+ }
107
+ }
108
+ ```
109
+ </details>
110
+
111
+ ---
112
+
113
+ ### Using pip
114
+
115
+ ```bash
116
+ pip install gemini-deep-research-mcp
117
+ ```
118
+
119
+ <details>
120
+ <summary><strong>VS Code config</strong></summary>
121
+
122
+ ```json
123
+ {
124
+ "servers": {
125
+ "gemini-deep-research": {
126
+ "command": "gemini-deep-research-mcp",
127
+ "env": {
128
+ "GEMINI_API_KEY": "your-api-key"
129
+ }
130
+ }
131
+ }
132
+ }
133
+ ```
134
+ </details>
135
+
136
+ <details>
137
+ <summary><strong>Claude Desktop config</strong></summary>
138
+
139
+ ```json
140
+ {
141
+ "mcpServers": {
142
+ "gemini-deep-research": {
143
+ "command": "gemini-deep-research-mcp",
144
+ "env": {
145
+ "GEMINI_API_KEY": "your-api-key"
146
+ }
147
+ }
148
+ }
149
+ }
150
+ ```
151
+ </details>
152
+
153
+ ---
154
+
155
+ ## Prerequisites
156
+
157
+ <details>
158
+ <summary><strong>Install uv (required for npx/uvx methods)</strong></summary>
159
+
160
+ ```bash
161
+ # macOS/Linux
162
+ curl -LsSf https://astral.sh/uv/install.sh | sh
163
+
164
+ # Windows (PowerShell)
165
+ powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
166
+ ```
167
+ </details>
168
+
169
+ ---
170
+
171
+ ## Tool: `gemini_deep_research`
172
+
173
+ Conducts comprehensive web research using Gemini's Deep Research Agent. Blocks until research completes (typically 10-20 minutes).
174
+
175
+ **When to use:**
176
+ - Complex topics requiring multi-source analysis
177
+ - Synthesized information from the web
178
+ - Fact-checking and cross-referencing
179
+
180
+ | Parameter | Type | Required | Default | Description |
181
+ |-----------|------|----------|---------|-------------|
182
+ | `prompt` | string | ✓ | — | Your research question or topic |
183
+ | `include_citations` | boolean | | `true` | Include resolved source URLs |
184
+
185
+ | Output | Description |
186
+ |--------|-------------|
187
+ | `status` | `completed`, `failed`, or `cancelled` |
188
+ | `report_text` | Synthesized research report |
189
+
190
+ ## Configuration
191
+
192
+ | Variable | Required | Default | Description |
193
+ |----------|----------|---------|-------------|
194
+ | `GEMINI_API_KEY` | ✓ | — | Your [Gemini API key](https://aistudio.google.com/apikey) |
195
+ | `GEMINI_DEEP_RESEARCH_AGENT` | | `deep-research-pro-preview-12-2025` | Model to use |
196
+
197
+ ## Development
198
+
199
+ ```bash
200
+ git clone https://github.com/bharatvansh/gemini-deep-research-mcp.git
201
+ cd gemini-deep-research-mcp
202
+ pip install -e .[dev]
203
+ pytest
204
+ ```
205
+
206
+ ## License
207
+
208
+ MIT
{gemini_deep_research_mcp-0.1.0 → gemini_deep_research_mcp-0.1.1}/pyproject.toml RENAMED
@@ -4,7 +4,7 @@ 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.1"
8
8
  description = "MCP server exposing Gemini Deep Research (Interactions API) tools"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
gemini_deep_research_mcp-0.1.1/src/gemini_deep_research_mcp.egg-info/PKG-INFO ADDED
@@ -0,0 +1,236 @@
1
+ Metadata-Version: 2.4
2
+ Name: gemini-deep-research-mcp
3
+ Version: 0.1.1
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
+ [![npm version](https://img.shields.io/npm/v/gemini-deep-research-mcp)](https://www.npmjs.com/package/gemini-deep-research-mcp)
33
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
34
+
35
+ An MCP server that exposes Gemini's **Deep Research Agent** for comprehensive web research.
36
+
37
+ ## One-Click Install
38
+
39
+ ### Cursor
40
+
41
+ [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=gemini-deep-research&config=eyJjb21tYW5kIjogInV2eCIsICJhcmdzIjogWyJnZW1pbmktZGVlcC1yZXNlYXJjaC1tY3AiXSwgImVudiI6IHsiR0VNSU5JX0FQSV9LRVkiOiAieW91ci1hcGkta2V5In19)
42
+
43
+ Click the button, then replace `your-api-key` with your [Gemini API key](https://aistudio.google.com/apikey).
44
+
45
+ ---
46
+
47
+ ## Installation Methods
48
+
49
+ ### Using npx (Node.js)
50
+
51
+ Requires [Node.js](https://nodejs.org/) 16+ and [uv](https://docs.astral.sh/uv/).
52
+
53
+ ```bash
54
+ npx gemini-deep-research-mcp
55
+ ```
56
+
57
+ <details>
58
+ <summary><strong>VS Code config</strong></summary>
59
+
60
+ ```json
61
+ {
62
+ "servers": {
63
+ "gemini-deep-research": {
64
+ "command": "npx",
65
+ "args": ["-y", "gemini-deep-research-mcp"],
66
+ "env": {
67
+ "GEMINI_API_KEY": "your-api-key"
68
+ }
69
+ }
70
+ }
71
+ }
72
+ ```
73
+ </details>
74
+
75
+ <details>
76
+ <summary><strong>Claude Desktop config</strong></summary>
77
+
78
+ ```json
79
+ {
80
+ "mcpServers": {
81
+ "gemini-deep-research": {
82
+ "command": "npx",
83
+ "args": ["-y", "gemini-deep-research-mcp"],
84
+ "env": {
85
+ "GEMINI_API_KEY": "your-api-key"
86
+ }
87
+ }
88
+ }
89
+ }
90
+ ```
91
+ </details>
92
+
93
+ ---
94
+
95
+ ### Using uvx (Python)
96
+
97
+ Requires [uv](https://docs.astral.sh/uv/).
98
+
99
+ ```bash
100
+ uvx gemini-deep-research-mcp
101
+ ```
102
+
103
+ <details>
104
+ <summary><strong>VS Code config</strong></summary>
105
+
106
+ ```json
107
+ {
108
+ "servers": {
109
+ "gemini-deep-research": {
110
+ "command": "uvx",
111
+ "args": ["gemini-deep-research-mcp"],
112
+ "env": {
113
+ "GEMINI_API_KEY": "your-api-key"
114
+ }
115
+ }
116
+ }
117
+ }
118
+ ```
119
+ </details>
120
+
121
+ <details>
122
+ <summary><strong>Claude Desktop config</strong></summary>
123
+
124
+ ```json
125
+ {
126
+ "mcpServers": {
127
+ "gemini-deep-research": {
128
+ "command": "uvx",
129
+ "args": ["gemini-deep-research-mcp"],
130
+ "env": {
131
+ "GEMINI_API_KEY": "your-api-key"
132
+ }
133
+ }
134
+ }
135
+ }
136
+ ```
137
+ </details>
138
+
139
+ ---
140
+
141
+ ### Using pip
142
+
143
+ ```bash
144
+ pip install gemini-deep-research-mcp
145
+ ```
146
+
147
+ <details>
148
+ <summary><strong>VS Code config</strong></summary>
149
+
150
+ ```json
151
+ {
152
+ "servers": {
153
+ "gemini-deep-research": {
154
+ "command": "gemini-deep-research-mcp",
155
+ "env": {
156
+ "GEMINI_API_KEY": "your-api-key"
157
+ }
158
+ }
159
+ }
160
+ }
161
+ ```
162
+ </details>
163
+
164
+ <details>
165
+ <summary><strong>Claude Desktop config</strong></summary>
166
+
167
+ ```json
168
+ {
169
+ "mcpServers": {
170
+ "gemini-deep-research": {
171
+ "command": "gemini-deep-research-mcp",
172
+ "env": {
173
+ "GEMINI_API_KEY": "your-api-key"
174
+ }
175
+ }
176
+ }
177
+ }
178
+ ```
179
+ </details>
180
+
181
+ ---
182
+
183
+ ## Prerequisites
184
+
185
+ <details>
186
+ <summary><strong>Install uv (required for npx/uvx methods)</strong></summary>
187
+
188
+ ```bash
189
+ # macOS/Linux
190
+ curl -LsSf https://astral.sh/uv/install.sh | sh
191
+
192
+ # Windows (PowerShell)
193
+ powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
194
+ ```
195
+ </details>
196
+
197
+ ---
198
+
199
+ ## Tool: `gemini_deep_research`
200
+
201
+ Conducts comprehensive web research using Gemini's Deep Research Agent. Blocks until research completes (typically 10-20 minutes).
202
+
203
+ **When to use:**
204
+ - Complex topics requiring multi-source analysis
205
+ - Synthesized information from the web
206
+ - Fact-checking and cross-referencing
207
+
208
+ | Parameter | Type | Required | Default | Description |
209
+ |-----------|------|----------|---------|-------------|
210
+ | `prompt` | string | ✓ | — | Your research question or topic |
211
+ | `include_citations` | boolean | | `true` | Include resolved source URLs |
212
+
213
+ | Output | Description |
214
+ |--------|-------------|
215
+ | `status` | `completed`, `failed`, or `cancelled` |
216
+ | `report_text` | Synthesized research report |
217
+
218
+ ## Configuration
219
+
220
+ | Variable | Required | Default | Description |
221
+ |----------|----------|---------|-------------|
222
+ | `GEMINI_API_KEY` | ✓ | — | Your [Gemini API key](https://aistudio.google.com/apikey) |
223
+ | `GEMINI_DEEP_RESEARCH_AGENT` | | `deep-research-pro-preview-12-2025` | Model to use |
224
+
225
+ ## Development
226
+
227
+ ```bash
228
+ git clone https://github.com/bharatvansh/gemini-deep-research-mcp.git
229
+ cd gemini-deep-research-mcp
230
+ pip install -e .[dev]
231
+ pytest
232
+ ```
233
+
234
+ ## License
235
+
236
+ MIT
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