🚀 谷歌MCP服务器
该项目实现了一个用于Google API的模型上下文协议（MCP）服务器，支持与AI助手和其他MCP兼容客户端集成，为用户提供便捷的搜索服务。
🚀 快速开始
本服务器的使用需要满足一定的先决条件，并且按照特定步骤进行安装和配置。
先决条件
- Node.js 18+ 版本
- npm 包管理器
安装步骤
1. 克隆仓库
git clone https://github.com/your-username/mcp-google-search.git
cd google-mcp-server
2. 安装依赖项
npm install
3. 配置Google自定义搜索API凭证
在项目根目录创建一个.env文件，内容如下：
GOOGLE_API_KEY=your_google_api_key_here
GOOGLE_CX_ID=your_custom_search_engine_id_here
GOOGLE_API_KEY：您的Google自定义搜索API密钥。GOOGLE_CX_ID：您的自定义搜索引擎ID。
您可以在Google自定义搜索JSON API文档中获取这些信息。
💻 使用示例
基础用法
1. 运行测试搜索
npx ts-node src/test.ts
这将执行一次样例搜索，并在控制台输出结果。
高级用法
2. 集成到MCP兼容客户端
要在MCP配置文件（例如claude_desktop_config.json）中使用此服务器，请添加如下条目：
{
"mcpServers": {
"google-api": {
"command": "npx",
"args": ["ts-node", "src/index.ts"],
"env": {
"GOOGLE_API_KEY": "your_google_api_key_here",
"GOOGLE_CX_ID": "your_custom_search_engine_id_here"
}
}
}
}
请将API密钥和CX ID替换为您的实际凭证。
✨ 主要特性
该服务器提供了以下工具：
- googleSearchContent：使用Google自定义搜索API执行网络搜索，并返回结构化结果（标题、链接和摘录）。
- googleSearchImages：使用Google自定义搜索API执行图片搜索，并返回第一个结果的Markdown图片链接。
查看src/tools.ts中的源代码以获取详细使用信息。
📚 详细文档
开发
对项目进行修改时：
- 按需修改
src目录下的代码。 - 如果添加或移除依赖项，请更新
package.json文件。 - 重新启动您的MCP客户端或测试脚本以应用更改。
故障排除
- 确保Google API密钥和CX ID正确设置在
.env文件或环境中。 - 检查所有依赖项是否已安装（
npm install）。 - 验证Node.js版本为18或更高。
- 修改代码后请重新启动服务器或测试脚本。
📄 许可证
该项目采用MIT许可证。