gemini-deep-research-mcp 0.1.0__py3-none-any.whl → 0.1.2__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.
@@ -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
@@ -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.2.dist-info/METADATA,sha256=o991BThOrBDuvj8c7MP7ZwwXpW1qC-pvKHZcwaaEeuY,3696
9
+ gemini_deep_research_mcp-0.1.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
10
+ gemini_deep_research_mcp-0.1.2.dist-info/entry_points.txt,sha256=nE5DP4kZ2RG5LB1Ied-hykIRmBei2GJw0wy_PijepRE,82
11
+ gemini_deep_research_mcp-0.1.2.dist-info/top_level.txt,sha256=sk90gOv-N7MHdyHhJE6N-fLVHrtFPfme8m1opjwXoMM,25
12
+ gemini_deep_research_mcp-0.1.2.dist-info/RECORD,,
@@ -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