Gemini深度研究MCP
](https://pypi.org/project/gemini-deep-research-mcp/) ](https://www.npmjs.com/package/@bharatvansh/gemini-deep-research-mcp) 
暴露Gemini的MCP服务器 深度研究代理 用于全面的网络研究。
一键安装
| IDE | 安装 |
|---|---|
| 光标 |  |
| VS Code |  |
| VS代码内部人员 |  |
注: 单击后,替换 your-api-key 和你一起 Gemini API密钥.VS Code需要1.101+版本。______________________________________________________________________
安装方法
使用npx(Node.js)
需要 16+和 紫外线.
npx @bharatvansh/gemini-deep-research-mcpVS Code config
{
"servers": {
"gemini-deep-research": {
"command": "npx",
"args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Claude Desktop config
{
"mcpServers": {
"gemini-deep-research": {
"command": "npx",
"args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Windsurf config
添加到 ~/.codeium/windsurf/mcp_config.json (macOS/Linux)或 %USERPROFILE%\.codeium\windsurf\mcp_config.json (Windows):
{
"mcpServers": {
"gemini-deep-research": {
"command": "npx",
"args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Cline config
{
"mcpServers": {
"gemini-deep-research": {
"command": "npx",
"args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Claude Code config
添加到 ~/.claude/settings.json:
{
"mcpServers": {
"gemini-deep-research": {
"command": "npx",
"args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Codex config
添加到 ~/.codex/config.toml:
[mcp_servers.gemini-deep-research]
command = "npx"
args = ["-y", "@bharatvansh/gemini-deep-research-mcp"]
[mcp_servers.gemini-deep-research.env]
GEMINI_API_KEY = "your-api-key"Cursor config
添加到 ~/.cursor/mcp.json:
{
"mcpServers": {
"gemini-deep-research": {
"command": "npx",
"args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Antigravity config
加入你的反重力 mcp_config.json:
{
"gemini-deep-research": {
"command": "npx",
"args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}______________________________________________________________________
使用uvx(Python)
需要 紫外线.
uvx gemini-deep-research-mcpVS Code config
{
"servers": {
"gemini-deep-research": {
"command": "uvx",
"args": ["gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Claude Desktop config
{
"mcpServers": {
"gemini-deep-research": {
"command": "uvx",
"args": ["gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Windsurf config
添加到 ~/.codeium/windsurf/mcp_config.json (macOS/Linux)或 %USERPROFILE%\.codeium\windsurf\mcp_config.json (Windows):
{
"mcpServers": {
"gemini-deep-research": {
"command": "uvx",
"args": ["gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Cline config
{
"mcpServers": {
"gemini-deep-research": {
"command": "uvx",
"args": ["gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Claude Code config
添加到 ~/.claude/settings.json:
{
"mcpServers": {
"gemini-deep-research": {
"command": "uvx",
"args": ["gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Codex config
添加到 ~/.codex/config.toml:
[mcp_servers.gemini-deep-research]
command = "uvx"
args = ["gemini-deep-research-mcp"]
[mcp_servers.gemini-deep-research.env]
GEMINI_API_KEY = "your-api-key"Cursor config
添加到 ~/.cursor/mcp.json:
{
"mcpServers": {
"gemini-deep-research": {
"command": "uvx",
"args": ["gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Antigravity config
加入你的反重力 mcp_config.json:
{
"gemini-deep-research": {
"command": "uvx",
"args": ["gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}______________________________________________________________________
使用pip
pip install gemini-deep-research-mcpVS Code config
{
"servers": {
"gemini-deep-research": {
"command": "gemini-deep-research-mcp",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Claude Desktop config
{
"mcpServers": {
"gemini-deep-research": {
"command": "gemini-deep-research-mcp",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Windsurf config
添加到 ~/.codeium/windsurf/mcp_config.json (macOS/Linux)或 %USERPROFILE%\.codeium\windsurf\mcp_config.json (Windows):
{
"mcpServers": {
"gemini-deep-research": {
"command": "gemini-deep-research-mcp",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Cline config
{
"mcpServers": {
"gemini-deep-research": {
"command": "gemini-deep-research-mcp",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Claude Code config
添加到 ~/.claude/settings.json:
{
"mcpServers": {
"gemini-deep-research": {
"command": "gemini-deep-research-mcp",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Codex config
添加到 ~/.codex/config.toml:
[mcp_servers.gemini-deep-research]
command = "gemini-deep-research-mcp"
[mcp_servers.gemini-deep-research.env]
GEMINI_API_KEY = "your-api-key"Cursor config
添加到 ~/.cursor/mcp.json:
{
"mcpServers": {
"gemini-deep-research": {
"command": "gemini-deep-research-mcp",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Antigravity config
加入你的反重力 mcp_config.json:
{
"gemini-deep-research": {
"command": "gemini-deep-research-mcp",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}______________________________________________________________________
反重力
- 打开 代理侧面板 → click ... → MCP商店
- 搜索您的MCP服务器或单击 添加自定义服务器
- 将此配置添加到您的
mcp_config.json:
{
"gemini-deep-research": {
"command": "uvx",
"args": ["gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}______________________________________________________________________
先决条件
Install uv (required for npx/uvx methods)
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"______________________________________________________________________
工具: gemini_deep_research
使用Gemini的Deep research Agent进行全面的网络研究。直到研究完成(通常为10-20分钟)。
何时使用:
- 需要多源分析的复杂主题
- 来自网络的综合信息
- 事实核查和交叉引用
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
prompt | string | ✓ | — | 您的研究问题或主题 |
include_citations | boolean | true | 包含已解析的源URL |
| 输出 | 描述 |
|---|---|
status | completed, failed,或 cancelled |
report_text | 综合研究报告 |
配置
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
GEMINI_API_KEY | ✓ | — | Your Gemini API密钥 |
GEMINI_DEEP_RESEARCH_AGENT | deep-research-pro-preview-12-2025 | 要使用的模型 |
发展
git clone https://github.com/bharatvansh/gemini-deep-research-mcp.git
cd gemini-deep-research-mcp
pip install -e .[dev]
pytest许可证
麻省理工学院
