minimax search

MiniMax搜索MCP服务器

英文文档 | 中文文档

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

🔧 版本说明

该项目使用 标准MCP服务器协议，符合MCP规范：

• ✅ 完成 list_tools() 实施
• ✅ 完成 call_tool() 实施
• ✅ 标准 stdio_server() 沟通

特性

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

快速开始

通过Git安装（推荐）

# Run directly from Git repository
uvx --from git+ssh://git@github.com:MiniMax-AI/minimax_search.git minimax-search 

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

# Run from local directory
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.搜索-并行网络搜索

同时搜索多个查询，返回简短结果（标题、URL、代码片段）。

参数:

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

支持的搜索引擎:

• 谷歌搜索（通过Serper API）

高级搜索语法:

• site:example.com -限制在特定地点
• intitle:keyword -标题包含关键字
• inurl:keyword -URL包含关键字
• "exact match" -精确短语匹配

示例:

{
  "queries": ["Python asyncio tutorial", "Python threading vs asyncio"]
}

2.浏览-批量智能浏览

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

参数:

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

示例:

{
  "urls": [
    "https://docs.python.org/3/library/asyncio.html",
    "https://realpython.com/async-io-python/"
  ],
  "query": "Summarize the main features and use cases of asyncio"
}

环境变量配置

所需的环境变量

基本搜索功能:

• SERPER_API_KEY：谷歌搜索

- 从以下网址获取：https://serper.dev/ - 免费套餐：2500次/月

Web浏览功能:

• JINA_API_KEY：Web内容阅读

- 从以下网址获取：https://jina.ai/ - 免费套餐可用

浏览功能（LLM理解）:

• MINIMAX_API_KEY：MiniMax API密钥

- 从以下网址获取：https://platform.minimax.io/

使用示例

在代理中使用

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

并行搜索多个查询:

User: Search for "Python asyncio" and "Python threading" differences simultaneously

Agent: [Calls search tool]
→ search(queries=["Python asyncio", "Python threading"])
→ Returns search results for both queries (executed in parallel)

批量浏览多个网页:

User: Visit these links and summarize the main features of asyncio
     - https://docs.python.org/3/library/asyncio.html
     - https://realpython.com/async-io-python/

Agent: [Calls browse tool]
→ browse(
    urls=["https://docs.python.org/...", "https://realpython.com/..."],
    query="Summarize the main features of asyncio"
  )
→ Returns comprehensive summary and answer

技术实现

项目结构

minimax_search/
├── server.py                    # MCP Server entry point (2 tools)
├── minimax_search_browse.py     # Core search and browse implementation
├── pyproject.toml              # Project configuration
└── README.md

核心功能

并行搜索:

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

批量浏览:

• 原生支持url数组
• Jina Reader提取网络内容（转换为Markdown）
• MiniMax LLM了解内容并生成全面的答案

许可证

麻省理工学院

该项目基于 MiniMax-M2型号 项目