AI导哈

模型上下文协议服务器

该项目实现了一个用于Google API的模型上下文协议（MCP）服务器，支持与AI助手和其他MCP兼容客户端的集成。

  • by rtbui2012
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 rtbui2012/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许可证获得许可。

相关 MCP