使用说明
谷歌mcp
27个工具。一台MCP服务器。整个谷歌研究堆栈。
唯一一个将谷歌服务打包的MCP服务器 没有官方API 将其转化为干净、可缓存的工具。YouTube成绩单、谷歌学者、NotebookLM自动化、趋势、新闻、地图、金融、arXiv、专利、书籍、翻译、维基百科——一切尽在一处 server.py.
27个工具中有21个是完全免费的。没有API密钥。
快速开始
git clone https://github.com/Miles0sage/google-mcp.git
cd google-mcp
pip install -r requirements.txt
python3 server.py
就是这样。服务器在stdio上运行，并与任何MCP客户端一起工作。
MCP配置
添加 ~/.mcp.json （Claude Code）或您客户的MCP配置：
{
"mcpServers": {
"google-research": {
"command": "python3",
"args": ["server.py"],
"cwd": "/path/to/google-mcp"
}
}
}
Docker：
docker build -t google-mcp .
docker run -it google-mcp
全部27个工具
YouTube（3个工具）
| 工具 | 描述 | 身份验证 |
|---|---|---|
youtube_transcript |
从任何视频中提取完整成绩单 | 免费 |
youtube_search |
按关键字搜索视频 | 免费 |
youtube_channel |
从频道获取最新视频 | 免费 |
NotebookLM（9个工具）-- 没有其他MCP服务器具有此功能
| 工具 | 描述 | 身份验证 |
|---|---|---|
notebooklm_list |
列出所有笔记本 | 浏览器 |
notebooklm_create |
创建笔记本+添加URL源 | 浏览器 |
notebooklm_add_source |
将URL添加到现有笔记本 | 浏览器 |
notebooklm_add_youtube |
添加YouTube视频作为源 | 浏览器 |
notebooklm_add_text |
添加文本/粘贴为源 | 浏览器 |
notebooklm_podcast |
生成音频概述（播客） | 浏览器 |
notebooklm_video |
生成电影视频概述 | 浏览器 |
notebooklm_ask |
用引用的答案提问 | 浏览器 |
notebooklm_sources |
列出笔记本中的源 | 浏览器 |
学术研究（4种工具）
| 工具 | 描述 | 身份验证 |
|---|---|---|
google_scholar |
搜索论文、引文、摘要 | 免费 |
arxiv_search |
搜索arXiv论文 | 免费 |
arxiv_paper |
按ID列出的全文详细信息 | 免费 |
research_pipeline |
一次通话中的多源研究 | 免费 |
谷歌服务（6个工具）
| 工具 | 描述 | 身份验证 |
|---|---|---|
google_trends |
兴趣随时间变化，热门话题 | 免费 |
google_news |
实时新闻搜索 | 免费 |
books_search |
搜索谷歌图书 | 免费 |
patents_search |
搜索谷歌专利 | 免费 |
maps_search |
搜索场所、餐馆、企业 | API密钥 |
maps_details |
评论、时间、电话、网站 | API密钥 |
金融（2个工具）
| 工具 | 描述 | 身份验证 |
|---|---|---|
stock_quote |
实时价格，市盈率，52周区间 | 免费 |
market_overview |
标准普尔500指数、纳斯达克指数、道琼斯指数快照 | 免费 |
实用程序（3个工具）
| 工具 | 描述 | 身份验证 |
|---|---|---|
translate |
100多种语言通过谷歌翻译 | 免费 |
wikipedia |
文章摘要和搜索 | 免费 |
webpage_read |
从任何URL提取文本 | 免费 |
杀手级功能：NotebookLM自动化
其他MCP服务器无法做到这一点：
"Create a notebook about AI agents and generate a podcast"
1. notebooklm_create("AI Agents Research", "url1,url2,url3")
2. notebooklm_add_youtube(id, "https://youtube.com/watch?v=...")
3. notebooklm_podcast(id) --> Audio Overview generating
4. notebooklm_ask(id, "Key findings?") --> Cited answer
程序化NotebookLM：通过MCP创建笔记本、添加源、生成播客和视频、提问。
vs学者mcp
| 谷歌mcp | 学者mcp | |
|---|---|---|
| 工具总数 | 27 | 7 |
| 谷歌学者 | 是 | 是 |
| arXiv | 是 | 是 |
| YouTube成绩单 | 是 | 否 |
| YouTube搜索 | 是 | 否 |
| NotebookLM（9个工具） | 是 | 没有 |
| 谷歌趋势 | 是 | 否 |
| 谷歌新闻 | 是 | 否 |
| 谷歌地图 | 是 | 否 |
| 谷歌财经 | 是 | 否 |
| 谷歌图书 | 是 | 否 |
| 谷歌专利 | 是 | 否 |
| 谷歌翻译 | 是 | 否 |
| 维基百科 | 是 | 否 |
| 网页阅读器 | 是 | 否 |
| 研究管道 | 是 | 否 |
| 响应缓存 | 带TTL的SQLite | 没有 |
| Docker支持 | 是 | 否 |
学者mcp在学术搜索方面做得很好。谷歌mcp做学术搜索 再加上20个工具 在整个谷歌生态系统中。
例子
YouTube文字记录：
youtube_transcript({"video_url": "https://youtube.com/watch?v=jGwO_UgTS7I"})
--> Full CS229 lecture transcript (69,877 chars)
多源研究（一通电话）：
research_pipeline({"topic": "autonomous AI agents"})
--> NEWS + ACADEMIC PAPERS + TRENDS combined
股票报价：
stock_quote({"symbol": "NVDA"})
--> $142.50 | +2.3% | PE 35.2 | 52w: $78.40 - $153.20
配置
| 变量 | 必填 | 描述 |
|---|---|---|
GOOGLE_MAPS_API_KEY |
仅地图工具 | 谷歌云控制台 （200美元/月免费信贷） |
PERPLEXITY_API_KEY |
可选 | 增强 research_pipeline 配备困惑声纳 |
NOTEBOOKLM_STORAGE_STATE |
NotebookLM工具 | Playwright浏览器Cookie的路径 |
其他一切都是开箱即用的。没有密钥，没有OAuth，没有设置。
建筑
MCP Client (Claude Code / Cursor / Windsurf)
|
v
google-mcp server (stdio)
|
|-- YouTube ............. youtube-transcript-api, scrapetube
|-- NotebookLM ......... Playwright browser automation
|-- Google Scholar ..... scholarly
|-- Google Trends ...... pytrends
|-- Google News ........ gnews
|-- Google Maps ........ googlemaps
|-- Google Finance ..... yfinance
|-- arXiv .............. arxiv API
|-- Google Books ....... Google Books API (free)
|-- Google Patents ..... scraping
|-- Translate .......... deep-translator
|-- Wikipedia .......... wikipedia-api
|-- Webpage ............ BeautifulSoup
|
+-- SQLite cache (configurable TTL, same query never hits Google twice)
贡献
每个工具都有自己的生命 tools_*.py 模块。添加新的Google服务：
- 创建
tools_yourservice.py - 在中添加MCP工具包装
server.py - 在中添加测试
tests/ - 提交PR
pytest tests/ -v
许可证
麻省理工学院
