🚀 谷歌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替换为您的实际凭证。

✨ 主要特性

该服务器提供了以下工具：

1. googleSearchContent：使用Google自定义搜索API执行网络搜索，并返回结构化结果（标题、链接和摘录）。
2. googleSearchImages：使用Google自定义搜索API执行图片搜索，并返回第一个结果的Markdown图片链接。

查看src/tools.ts中的源代码以获取详细使用信息。

📚 详细文档

开发

对项目进行修改时：

1. 按需修改src目录下的代码。
2. 如果添加或移除依赖项，请更新package.json文件。
3. 重新启动您的MCP客户端或测试脚本以应用更改。

故障排除

• 确保Google API密钥和CX ID正确设置在.env文件或环境中。
• 检查所有依赖项是否已安装（npm install）。
• 验证Node.js版本为18或更高。
• 修改代码后请重新启动服务器或测试脚本。

📄 许可证

该项目采用MIT许可证。