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

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 (6) hide show
  1. gemini_deep_research_mcp-0.1.1.dist-info/METADATA +236 -0
  2. {gemini_deep_research_mcp-0.1.0.dist-info → gemini_deep_research_mcp-0.1.1.dist-info}/RECORD +5 -5
  3. gemini_deep_research_mcp-0.1.0.dist-info/METADATA +0 -127
  4. {gemini_deep_research_mcp-0.1.0.dist-info → gemini_deep_research_mcp-0.1.1.dist-info}/WHEEL +0 -0
  5. {gemini_deep_research_mcp-0.1.0.dist-info → gemini_deep_research_mcp-0.1.1.dist-info}/entry_points.txt +0 -0
  6. {gemini_deep_research_mcp-0.1.0.dist-info → gemini_deep_research_mcp-0.1.1.dist-info}/top_level.txt +0 -0
gemini_deep_research_mcp-0.1.1.dist-info/METADATA 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.dist-info → gemini_deep_research_mcp-0.1.1.dist-info}/RECORD RENAMED
@@ -5,8 +5,8 @@ gemini_deep_research_mcp/extract.py,sha256=lBFB2GfpHdPQXRszV6yulfSTa5cU3ApwU0Kww
5
5
  gemini_deep_research_mcp/gemini.py,sha256=-4wptf99qVcukl0vsohsQQDBwMPq-B7LzZHqjpPZSqg,1572
6
6
  gemini_deep_research_mcp/resolve.py,sha256=LmSuTGOe1-qjToKdQL6pcpNlzoMQwn43_uzX1KSQvOo,3105
7
7
  gemini_deep_research_mcp/server.py,sha256=lAolJPB-fV4oN9W0Ldq4VQYkXt86Zxd3SVInwT3QsNk,3991
8
- gemini_deep_research_mcp-0.1.0.dist-info/METADATA,sha256=_CahiTs3Q1OqndH2hXmMuy7FYwqKcwtlCJlBNw6N4sc,3503
9
- gemini_deep_research_mcp-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
10
- gemini_deep_research_mcp-0.1.0.dist-info/entry_points.txt,sha256=nE5DP4kZ2RG5LB1Ied-hykIRmBei2GJw0wy_PijepRE,82
11
- gemini_deep_research_mcp-0.1.0.dist-info/top_level.txt,sha256=sk90gOv-N7MHdyHhJE6N-fLVHrtFPfme8m1opjwXoMM,25
12
- gemini_deep_research_mcp-0.1.0.dist-info/RECORD,,
8
+ gemini_deep_research_mcp-0.1.1.dist-info/METADATA,sha256=vThBjNYnfR5iNanKFrA1ycVh5oUuQ_I4o4jFmIo7fM4,5659
9
+ gemini_deep_research_mcp-0.1.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
10
+ gemini_deep_research_mcp-0.1.1.dist-info/entry_points.txt,sha256=nE5DP4kZ2RG5LB1Ied-hykIRmBei2GJw0wy_PijepRE,82
11
+ gemini_deep_research_mcp-0.1.1.dist-info/top_level.txt,sha256=sk90gOv-N7MHdyHhJE6N-fLVHrtFPfme8m1opjwXoMM,25
12
+ gemini_deep_research_mcp-0.1.1.dist-info/RECORD,,
gemini_deep_research_mcp-0.1.0.dist-info/METADATA 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