Google MCP Server

Google 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 Custom Search API 凭据

在项目根目录中创建一个 .env 文件，内容如下：

GOOGLE_API_KEY=your_google_api_key_here
GOOGLE_CX_ID=your_custom_search_engine_id_here

• GOOGLE_API_KEY：你的 Google Custom Search API 密钥。
• GOOGLE_CX_ID：你的 Google Custom Search Engine ID。

你可以在 Google Custom Search 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. googleSearchContent：使用 Google Custom Search API 执行网页搜索，并返回结构化结果（标题、链接和摘要）。
2. googleSearchImages：使用 Google Custom Search API 执行图片搜索，并返回第一个结果的 Markdown 图片链接。

如需详细了解用法，请参阅 src/tools.ts 中的源代码。

---

开发

要修改项目：

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

---

故障排除

• 确保已在 .env 文件或环境中正确设置 Google API 密钥和 CX ID。
• 检查是否已安装所有依赖项（npm install）。
• 确认使用的是 Node.js 18 或更高版本。
• 如果修改了代码，请重启服务或测试脚本。

---

许可证

本项目采用 MIT 许可证。