@bharatvansh/gemini-deep-research-mcp 0.1.0

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 (3) hide show
  1. package/README.md +208 -0
  2. package/bin/cli.js +36 -0
  3. package/package.json +34 -0
package/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
package/bin/cli.js ADDED
@@ -0,0 +1,36 @@
1
+ #!/usr/bin/env node
2
+
3
+ const { spawn } = require('child_process');
4
+ const { platform } = require('os');
5
+
6
+ // Try uvx first (recommended), fall back to python -m
7
+ function runWithUvx() {
8
+ const proc = spawn('uvx', ['gemini-deep-research-mcp'], {
9
+ stdio: 'inherit',
10
+ shell: platform() === 'win32'
11
+ });
12
+
13
+ proc.on('error', (err) => {
14
+ if (err.code === 'ENOENT') {
15
+ console.error('Error: uvx not found. Please install uv first:');
16
+ console.error('');
17
+ if (platform() === 'win32') {
18
+ console.error(' powershell -c "irm https://astral.sh/uv/install.ps1 | iex"');
19
+ } else {
20
+ console.error(' curl -LsSf https://astral.sh/uv/install.sh | sh');
21
+ }
22
+ console.error('');
23
+ console.error('Or install the Python package directly:');
24
+ console.error(' pip install gemini-deep-research-mcp');
25
+ console.error(' gemini-deep-research-mcp');
26
+ process.exit(1);
27
+ }
28
+ throw err;
29
+ });
30
+
31
+ proc.on('exit', (code) => {
32
+ process.exit(code || 0);
33
+ });
34
+ }
35
+
36
+ runWithUvx();
package/package.json ADDED
@@ -0,0 +1,34 @@
1
+ {
2
+ "name": "@bharatvansh/gemini-deep-research-mcp",
3
+ "version": "0.1.0",
4
+ "description": "MCP server exposing Gemini Deep Research (Interactions API) tools",
5
+ "bin": {
6
+ "gemini-deep-research-mcp": "bin/cli.js"
7
+ },
8
+ "files": [
9
+ "bin"
10
+ ],
11
+ "keywords": [
12
+ "mcp",
13
+ "gemini",
14
+ "deep-research",
15
+ "ai",
16
+ "google",
17
+ "model-context-protocol",
18
+ "research",
19
+ "agent"
20
+ ],
21
+ "author": "Ayush <ayusin439@gmail.com>",
22
+ "license": "MIT",
23
+ "repository": {
24
+ "type": "git",
25
+ "url": "git+https://github.com/bharatvansh/gemini-deep-research-mcp.git"
26
+ },
27
+ "homepage": "https://github.com/bharatvansh/gemini-deep-research-mcp",
28
+ "bugs": {
29
+ "url": "https://github.com/bharatvansh/gemini-deep-research-mcp/issues"
30
+ },
31
+ "engines": {
32
+ "node": ">=16"
33
+ }
34
+ }