网页搜索MCP服务器

一个基于Rust实现的MCP服务器,通过Synthetic API为AI助手提供网页搜索功能,支持OpenCode等MCP兼容客户端获取搜索结果及相关元数据。

  • by Syoongy
  • Rust
  • 本地部署
  • 更新于
在 GitHub 查看 Syoongy/synthetic-web-search-mcp-rs

使用说明

合成Web搜索MCP服务器(Rust)

使用合成API进行网络搜索的模型上下文协议(MCP)服务器的Rust实现。

概述

该MCP服务器通过合成API为人工智能助手提供网络搜索功能。它允许OpenCode和其他兼容MCP的客户端执行网络搜索,并使用元数据(包括URL、标题、内容片段、发布日期)检索相关结果。

安装

cargo build --release

这将在以下位置创建二进制文件 ./target/release/synthetic-web-search-mcp.

使用opencode

将以下内容添加到您的opencode MCP配置中:

{
  "mcpServers": {
    "synthetic-web-search": {
      "command": "/path/to/synthetic-web-search-mcp",
      "env": {
        "SYNTHETIC_API_KEY": "your_api_key_here"
      }
    }
  }
}

MCP检验员测试

要手动测试服务器,请使用MCP检查器:

npx @modelcontextprotocol/inspector /path/to/your/binary

可用工具

搜索web

使用合成API搜索网页。

论据:

  • query (String):搜索查询字符串
  • limit (选项):要返回的最大结果数(默认值:5)

退货: 包含以下字段的搜索结果数组:

  • url (String):搜索结果的URL
  • title (String):页面的标题
  • text (String):内容片段或描述
  • published (选项<String>):发布日期(如果可用)

API详细信息

  • 端点: https://api.synthetic.new/v2/search
  • 方法: 发布
  • 身份验证: 承载令牌(SYNTHETIC_API_KEY)

环境变量

  • SYNTHETIC_API_KEY (必需):您的合成API密钥
  • DEFAULT_SEARCH_LIMIT (可选):默认返回的最大结果数(默认值:5)

项目结构

synthetic-web-search-mcp-rs/
├── Cargo.toml              # Rust project manifest
├── src/
│   ├── main.rs            # Entry point and MCP server setup
│   ├── lib.rs             # Library exports
│   └── search.rs          # Search tool implementation
└── README.md              # This file

许可证

看 许可证 了解详情。