gemini-deep-research-mcp 0.1.1__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 (23) hide show
  1. gemini_deep_research_mcp-0.1.2/PKG-INFO +109 -0
  2. gemini_deep_research_mcp-0.1.1/PKG-INFO → gemini_deep_research_mcp-0.1.2/README.md +31 -36
  3. gemini_deep_research_mcp-0.1.2/README.pypi.md +81 -0
  4. {gemini_deep_research_mcp-0.1.1 → 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.1 → 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.1/README.md +0 -208
  8. gemini_deep_research_mcp-0.1.1/src/gemini_deep_research_mcp.egg-info/PKG-INFO +0 -236
  9. {gemini_deep_research_mcp-0.1.1 → gemini_deep_research_mcp-0.1.2}/setup.cfg +0 -0
  10. {gemini_deep_research_mcp-0.1.1 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp/__init__.py +0 -0
  11. {gemini_deep_research_mcp-0.1.1 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp/__main__.py +0 -0
  12. {gemini_deep_research_mcp-0.1.1 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp/config.py +0 -0
  13. {gemini_deep_research_mcp-0.1.1 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp/extract.py +0 -0
  14. {gemini_deep_research_mcp-0.1.1 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp/gemini.py +0 -0
  15. {gemini_deep_research_mcp-0.1.1 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp/resolve.py +0 -0
  16. {gemini_deep_research_mcp-0.1.1 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp/server.py +0 -0
  17. {gemini_deep_research_mcp-0.1.1 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp.egg-info/dependency_links.txt +0 -0
  18. {gemini_deep_research_mcp-0.1.1 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp.egg-info/entry_points.txt +0 -0
  19. {gemini_deep_research_mcp-0.1.1 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp.egg-info/requires.txt +0 -0
  20. {gemini_deep_research_mcp-0.1.1 → gemini_deep_research_mcp-0.1.2}/src/gemini_deep_research_mcp.egg-info/top_level.txt +0 -0
  21. {gemini_deep_research_mcp-0.1.1 → gemini_deep_research_mcp-0.1.2}/tests/test_extract.py +0 -0
  22. {gemini_deep_research_mcp-0.1.1 → gemini_deep_research_mcp-0.1.2}/tests/test_server_output_format.py +0 -0
  23. {gemini_deep_research_mcp-0.1.1 → 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.1/PKG-INFO → gemini_deep_research_mcp-0.1.2/README.md RENAMED
@@ -1,46 +1,21 @@
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
1
  # Gemini Deep Research MCP
30
2
 
31
3
  [![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)
4
+ [![npm version](https://img.shields.io/npm/v/@bharatvansh/gemini-deep-research-mcp)](https://www.npmjs.com/package/@bharatvansh/gemini-deep-research-mcp)
33
5
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
34
6
 
35
7
  An MCP server that exposes Gemini's **Deep Research Agent** for comprehensive web research.
36
8
 
37
9
  ## One-Click Install
38
10
 
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)
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) |
42
17
 
43
- Click the button, then replace `your-api-key` with your [Gemini API key](https://aistudio.google.com/apikey).
18
+ > **Note:** After clicking, replace `your-api-key` with your [Gemini API key](https://aistudio.google.com/apikey). VS Code requires version 1.101+.
44
19
 
45
20
  ---
46
21
 
@@ -51,7 +26,7 @@ Click the button, then replace `your-api-key` with your [Gemini API key](https:/
51
26
  Requires [Node.js](https://nodejs.org/) 16+ and [uv](https://docs.astral.sh/uv/).
52
27
 
53
28
  ```bash
54
- npx gemini-deep-research-mcp
29
+ npx @bharatvansh/gemini-deep-research-mcp
55
30
  ```
56
31
 
57
32
  <details>
@@ -62,7 +37,7 @@ npx gemini-deep-research-mcp
62
37
  "servers": {
63
38
  "gemini-deep-research": {
64
39
  "command": "npx",
65
- "args": ["-y", "gemini-deep-research-mcp"],
40
+ "args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
66
41
  "env": {
67
42
  "GEMINI_API_KEY": "your-api-key"
68
43
  }
@@ -80,7 +55,7 @@ npx gemini-deep-research-mcp
80
55
  "mcpServers": {
81
56
  "gemini-deep-research": {
82
57
  "command": "npx",
83
- "args": ["-y", "gemini-deep-research-mcp"],
58
+ "args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
84
59
  "env": {
85
60
  "GEMINI_API_KEY": "your-api-key"
86
61
  }
@@ -180,6 +155,26 @@ pip install gemini-deep-research-mcp
180
155
 
181
156
  ---
182
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
+
183
178
  ## Prerequisites
184
179
 
185
180
  <details>
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.1 → 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.1"
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.1 → 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.1/README.md DELETED
@@ -1,208 +0,0 @@
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.1/src/gemini_deep_research_mcp.egg-info/PKG-INFO DELETED
@@ -1,236 +0,0 @@
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