🚀 使用谷歌自定义搜索的MCP服务器
这是一个提供网页搜索功能的模型上下文协议（MCP）服务器，借助谷歌自定义搜索API和网页内容提取功能，为用户提供便捷的网页搜索与内容提取服务。
🚀 快速开始
设置
获取谷歌API密钥和搜索引擎ID
- 创建谷歌云项目：
- 访问谷歌云控制台。
- 创建新项目或选择现有项目。
- 开启项目计费。
- 启用自定义搜索API：
- 访问API库。
- 搜索“Custom Search API”。
- 点击“启用”。
- 获取API密钥：
- 访问凭证。
- 点击“创建凭证”>“API密钥”。
- 复制你的API密钥。
- （可选）限制该密钥仅用于自定义搜索API。
- 创建自定义搜索引擎：
- 访问可编程搜索引擎。
- 输入要搜索的站点（使用www.google.com进行全网搜索）。
- 点击“创建”。
- 在下一步中点击“自定义”。
- 在设置中启用“搜索整个网络”。
- 复制你的搜索引擎ID(cx)。
开发
安装依赖
npm install
构建服务器
npm run build
开发时自动重建
npm run watch
✨ 主要特性
搜索工具
使用谷歌自定义搜索API执行网页搜索：
- 可搜索整个网络或特定站点。
- 能控制结果数量（1 - 10）。
- 可获取结构化结果，包括标题、链接和摘录。
网页阅读器工具
提取任何网页内容：
- 抓取并解析网页内容。
- 提取页面标题和正文文本。
- 清理内容以去除脚本和样式。
- 返回结构化数据，包括标题、文本和URL。
📦 安装指南
通过Smithery安装
要自动通过Smithery安装适用于Claude桌面的谷歌自定义搜索服务器：
npx -y @smithery/cli install @adenot/mcp-google-search --client claude
与Claude桌面一起使用时，添加包含你的谷歌API凭证的服务器配置：
- 在MacOS中：
~/Library/Application Support/Claude/claude_desktop_config.json - 在Windows中：
%APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"google-search": {
"command": "npx",
"args": [
"-y",
"@adenot/mcp-google-search"
],
"env": {
"GOOGLE_API_KEY": "your-api-key-here",
"GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id-here"
}
}
}
}
💻 使用示例
搜索工具
{
"name": "search",
"arguments": {
"query": "你的搜索查询",
"num": 5 // 可选，默认为5，范围1-10
}
}
网页阅读器工具
{
"name": "extract",
"arguments": {
"url": "网页链接"
}
}
示例响应
搜索工具
{
"items": [
{
"title": "结果标题1",
"link": "https://example.com/1",
"snippet": "结果摘录1"
},
// 其他结果...
]
}
网页阅读器工具
{
"title": "页面标题",
"text": "页面正文内容..."
}
调试
使用DEBUG=mcp-google-search环境变量启用调试输出：
DEBUG=mcp-google-search npm start
⚠️ 重要提示
- 确保你拥有搜索目标站点的权限。
- 遵守谷歌API的服务条款和使用限制。