Google MCP Server

谷歌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：您的Google自定义搜索引擎ID。

您可以从 Google自定义搜索JSON API文档.

______________________________________________________________________

用法

1.运行测试搜索

npx ts-node src/test.ts

这将执行示例搜索并将结果打印到控制台。

2.与MCP兼容客户端集成

要将此服务器用作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. 谷歌搜索内容：使用Google Custom search API执行web搜索，并返回结构化结果（标题、链接和片段）。
2. 谷歌搜索图片：使用Google Custom search API执行图像搜索，并返回第一个结果的Markdown图像链接。

请参阅中的源代码 src/tools.ts 了解详细的使用信息。

______________________________________________________________________

发展

要更改项目，请执行以下操作：

1. 修改代码 src 目录根据需要。
2. 如果添加或删除依赖项，请更新 package.json 因此。
3. 重新启动MCP客户端或测试脚本以应用更改。

______________________________________________________________________

故障排除

• 确保您的Google API密钥和CX ID在 .env 文件或您的环境。
• 检查是否安装了所有依赖项(npm install).
• 验证您使用的是Node.js 18或更高版本。
• 如果对代码进行了更改，请重新启动服务器或测试脚本。

______________________________________________________________________

许可证

该项目根据MIT许可证获得许可。