---
name: minimax-web-search
description: Use MiniMax MCP to perform web searches and retrieve up-to-date information from the internet. Use when the user asks to search the web, find current information, look up news, or research topics online via MiniMax API.
compatibility: Requires uvx and MINIMAX_API_KEY environment variable
metadata:
  author: minimax
  version: "1.0"
  mcp-server: minimax-coding-plan-mcp
allowed-tools: Bash(python3:*) Bash(uvx:*)
---

# MiniMax Web Search

通过脚本直接启动 `minimax-coding-plan-mcp` MCP 服务器并调用 `web_search` 工具，使用 MCP stdio 协议通信。

## 前置条件

- 安装 `uvx`（`pip install uv` 或 `brew install uv`）
- 设置环境变量 `MINIMAX_API_KEY`（从 https://platform.minimaxi.com/subscribe/token-plan 获取）

## 使用方法

使用脚本 `scripts/web_search.py` 直接通过 stdio 调用 MCP 工具：

```bash
MINIMAX_API_KEY=your_api_key python3 scripts/web_search.py "搜索关键词"
```

或已设置环境变量时：

```bash
python3 scripts/web_search.py "your search query"
```

## 示例

```bash
# 搜索最新新闻
python3 scripts/web_search.py "AI 大模型 2025 最新进展"

# 搜索技术文档
python3 scripts/web_search.py "Python asyncio best practices"

# 搜索产品信息
python3 scripts/web_search.py "MiniMax API pricing"
```

## 工作原理

脚本会：
1. 以子进程方式启动 `uvx minimax-coding-plan-mcp -y`
2. 通过 stdio 发送 MCP JSON-RPC 协议消息（initialize → tools/call）
3. 解析响应并输出搜索结果
4. 完成后终止子进程

## 工具参数

| 参数    | 类型   | 必填 | 说明           |
| ------- | ------ | ---- | -------------- |
| `query` | string | 是   | 搜索关键词或问题 |

## 在 Claude Code 中调用

让 Claude 通过 Bash 运行脚本：

```bash
python3 /path/to/minimax-web-search/scripts/web_search.py "your query"
```

确保 `MINIMAX_API_KEY` 已在当前 shell 环境中设置。
