SearchAPI.site - MCP Server

基本能力

产品定位

SearchAPI.site - MCP Server 是一个中间件服务，用于将 AI 助手与外部搜索引擎（如 Google、Bing 等）连接起来，提供丰富的搜索功能。

核心功能

• 支持多种搜索引擎（Google、Bing 等）的 Web 搜索、图片搜索和 YouTube 搜索。
• 提供 CLI 工具，方便开发者通过命令行进行搜索操作。
• 支持 MCP 协议，可以与 AI 系统无缝集成。
• 提供开发工具和测试框架，便于扩展和定制。

适用场景

• AI 助手需要访问外部搜索引擎的场景。
• 开发者需要快速集成搜索功能的项目。
• 需要定制化搜索工具的开发环境。

工具列表

• search-google: 通过 Google 进行 Web 搜索。
• search-google-images: 通过 Google 进行图片搜索。
• search-youtube: 通过 YouTube 进行视频搜索。

常见问题解答

• 如何获取 API Key？ 在 SearchAPI.site 创建 API Key。
• 支持哪些搜索引擎？ 目前支持 Google 和 Bing 的部分搜索功能，具体支持列表见文档。

使用教程

使用依赖

• Node.js (>=18.x): 下载
• Git: 用于版本控制

安装教程

# 克隆仓库
git clone https://github.com/mrgoonie/searchapi-mcp-server.git
cd searchapi-mcp-server

# 安装依赖
npm install

调试方式

# 启动开发服务器
npm run dev:server

# 测试 CLI 工具
npm run dev:cli -- search-google --query "your search query" --api-key "your-api-key"

架构

项目结构

• src/cli/: 命令行接口
• src/controllers/: 业务逻辑
• src/tools/: MCP 工具定义
• src/services/: 外部 API 交互

开发指南

# 启动开发服务器
npm run dev:server

# 运行测试
npm test

# 生成测试覆盖率报告
npm run test:coverage

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。