Smart Search MCP 服务器

一个集成了远程智能搜索 API 的 MCP 服务器实现，提供了强大的网页搜索功能。

功能

• 网页搜索：执行网页搜索，并可控制结果数量、分页、语言和安全级别。
• 结构化的 JSON 输出：所有搜索结果都以清晰的 JSON 格式返回。
• 易于集成：设计为与任何兼容 MCP 的客户端无缝使用。

工具

smart_search

执行带有过滤和分页选项的网页搜索。

输入参数：

• query (字符串)：搜索词。
• count (数字, 可选)：要返回的结果数量（默认值: 10）。

配置

获取 API 密钥

1. 在搜索 API 提供商处注册账户。
2. 生成您的 API 密钥。密钥应采用 endpoint-apikey 格式。

环境变量

此服务器需要设置 SERVER_KEY 环境变量为您获取的 API 密钥。

与 MCP 客户端一起使用

要将此服务器与 OpenWebUI 或 Claude Desktop 等客户端一起使用，请添加以下配置。此示例使用 npx 直接从 npm 注册表运行服务器。

开发

安装依赖项：
bash
npm install

构建服务器：
bash
npm run build

开发时自动重建：
bash
npm run watch

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 SmartSearch 服务器：

bash
npx -y @smithery/cli install @pgzhang/smartsearch-mcp --client claude

要与 Claude Desktop 一起使用，请在配置文件中添加服务器配置并提供您的 Google API 凭证：

在 MacOS 上: ~/Library/Application Support/Claude/claude_desktop_config.json
在 Windows 上: %APPDATA%/Claude/claude_desktop_config.json

json
{
"mcpServers": {
"smart-search": {
"command": "npx",
"args": [
"-y",
"@pgzhang/smartsearch-mcp"
],
"env": {
"AK": "YOUR_API_KEY_HERE",
"ENDPOINT": "YOUR_ENDPOINT_HERE"
}
}
}
}

使用方法

搜索工具

json
{
"name": "search",
"arguments": {
"query": "your search query",
"count": 5 // 可选，默认值是 10，最大值是 50
}
}

许可证

此 MCP 服务器根据 MIT 许可证发布。有关更多详细信息，请参阅 LICENSE 文件。