MiniMax Search MCP Server

英文文档 | 中文文档

MiniMax Search 是一个 MCP（模型上下文协议）服务器，提供网络搜索和浏览功能。

🔧 版本说明

该项目使用了 标准的 MCP Server 协议，符合 MCP 规范：

• ✅ 完整实现 list_tools()
• ✅ 完整实现 call_tool()
• ✅ 标准的 stdio_server() 通信

功能

• 🔍 多引擎搜索：支持 Google 搜索引擎
• 🚀 并行搜索：原生支持并行多查询搜索
• 🌐 批量浏览：支持多个 URL 的批量浏览
• 🤖 智能理解：使用 MiniMax LLM 理解网页内容并回答问题
• 🎯 高级搜索：支持 Google 高级搜索语法
• 🔄 自动回退：搜索失败时自动切换到其他引擎

快速开始

通过 Git 安装（推荐）

# 直接从 Git 仓库运行
uvx --from git+ssh://git@github.com:MiniMax-AI/minimax_search.git minimax-search 

通过本地路径安装（开发）

# 从本地目录运行
uvx --from /xxx/minimax_search minimax-search

MCP 客户端配置

在您的 MCP 客户端配置文件（例如 mcp.json）中添加：

{
  "mcpServers": {
    "minimax_search": {
      "command": "uvx",
      "args": [
        "--from",
        "git+ssh://git@github.com:MiniMax-AI/minimax_search.git",
        "minimax-search"
      ],
      "env": {
        "MINIMAX_API_KEY": "your_minimax_api_key",
        "SERPER_API_KEY": "your_serper_api_key",
        "JINA_API_KEY": "your_jina_api_key"
      }
    }
  }
}

可用工具

1. search - 并行网络搜索

同时搜索多个查询，返回简要结果（标题、URL、摘要）。

参数：

• queries（字符串数组，必需）：查询列表，支持 Google 高级搜索语法

支持的搜索引擎：

• Google 搜索（通过 Serper API）

高级搜索语法：

• site:example.com - 限制特定站点
• intitle:关键词 - 标题包含关键词
• inurl:关键词 - URL 包含关键词
• "精确匹配" - 精确短语匹配

示例：

{
  "queries": ["Python asyncio 教程", "Python 线程 vs asyncio"]
}

2. browse - 批量智能浏览

访问多个网页，使用 MiniMax LLM 理解内容并回答问题。

参数：

• urls（字符串数组，必需）：目标网页 URL 列表
• query（字符串，必需）：需要回答的问题

示例：

{
  "urls": [
    "https://docs.python.org/3/library/asyncio.html",
    "https://realpython.com/async-io-python/"
  ],
  "query": "总结 asyncio 的主要特性和使用场景"
}

环境变量配置

必需的环境变量

基本搜索功能：

• SERPER_API_KEY：Google 搜索
  • 获取地址：https://serper.dev/
  • 免费层级：每月 2,500 次请求

网页浏览功能：

• JINA_API_KEY：网页内容阅读
  • 获取地址：https://jina.ai/
  • 提供免费层级

浏览功能（LLM 理解）：

• MINIMAX_API_KEY：MiniMax API 密钥
  • 获取地址：https://platform.minimax.io/

使用示例

在代理中的使用

一旦 MCP 服务器启动，代理可以使用以下工具：

并行搜索多个查询：

用户：同时搜索“Python asyncio”和“Python 线程”的差异

代理：[调用 search 工具]
→ search(queries=["Python asyncio", "Python 线程"])
→ 返回两个查询的结果（并行执行）

批量浏览多个网页：

用户：访问这些链接并总结 asyncio 的主要特性
     - https://docs.python.org/3/library/asyncio.html
     - https://realpython.com/async-io-python/

代理：[调用 browse 工具]
→ browse(
    urls=["https://docs.python.org/...", "https://realpython.com/..."],
    query="总结 asyncio 的主要特性"
  )
→ 返回综合摘要和答案

技术实现

项目结构

minimax_search/
├── server.py                    # MCP Server 入口点（2 个工具）
├── minimax_search_browse.py     # 核心搜索和浏览实现
├── pyproject.toml              # 项目配置
└── README.md

核心功能

并行搜索：

• 原生支持查询数组
• 使用线程池并发执行
• 自动格式化和分组结果

批量浏览：

• 原生支持 URL 数组
• Jina Reader 提取网页内容（转换为 Markdown）
• MiniMax LLM 理解内容并生成综合答案

许可证

MIT

本项目基于 MiniMax-M2 模型 项目