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 文件。