MiniMaxMCP使用指南 minimax-mcp-usage

本技能文档提供了 MiniMax MCP 工具(网络搜索和图像理解)的最佳实践指南,包括查询构建、成本分析、集成模式和故障排除。适用于开发者、研究人员和内容创作者进行高效信息检索和图像分析。关键词:MiniMax MCP, 网络搜索, 图像分析, 开发者工具, 成本优化, 查询构建, 故障排除, 集成指南。

DevOps 0 次安装 0 次浏览 更新于 3/4/2026

版本: 2.88.0

名称: minimax-mcp-usage 描述: “[已弃用] 请使用 Zai MCP 的 /research 技能 - MiniMax MCP 工具的最佳使用模式”

已弃用 (v2.88.0): 此技能已弃用。请使用 /research 技能,它利用 Zai MCP 进行全面的网络搜索,具有更好的功能:

  • 无需 API 密钥(免费)
  • 支持中文内容(CSDN、掘金、Linux.do
  • GitHub README 提取
  • 带 Markdown 转换的 URL 阅读器
  • 域名和时效性筛选

参见:.claude/skills/research/SKILL.md

ultrathink - 深呼吸。我们不是来写代码的。我们是来改变世界的。

愿景

MiniMax 查询应该简洁、准确、果断。

你的工作,分步进行

  1. 选择工具:web_search 与 understand_image。
  2. 构建查询:具体、有时间限制且重点突出。
  3. 运行分析:以最小的噪音收集结果。
  4. 综合整理:将输出转换为清晰的指导。

Ultrathink 原则实践

  • 不同凡想:使用最低成本的路径获取真相。
  • 痴迷细节:查询的精确性至关重要。
  • 像达芬奇一样规划:在搜索前决定意图。
  • 精心制作,而非编码:保持结果可操作。
  • 不懈迭代:优化查询直到清晰为止。
  • 无情简化:剔除模糊或宽泛的请求。

MiniMax MCP 使用模式 (v2.24)

本文档记录了 MiniMax MCP 工具的最佳使用模式。

可用工具

1. mcp__MiniMax__web_search

目的: 网络搜索,成本仅为替代方案的 8%

输入:

query: string  # 3-5 个关键词,对于近期主题请包含年份

输出:

{
  "organic": [{ "title", "link", "snippet", "date" }],
  "related_searches": [{ "query" }]
}

最佳模式:

# 好:具体、有时间限制
mcp__MiniMax__web_search:
  query: "React 19 useOptimistic 钩子示例 2025"

# 好:专注于错误
mcp__MiniMax__web_search:
  query: "TypeError 无法读取属性 undefined Next.js"

# 差:过于模糊
mcp__MiniMax__web_search:
  query: "javascript"  # 太宽泛

2. mcp__MiniMax__understand_image

目的: 用于调试和审查的图像分析

输入:

prompt: string       # 关于图像的清晰、具体的问题
image_source: string # 本地路径(不带 @)或 HTTPS URL

最佳模式:

# 好:具体的分析请求
mcp__MiniMax__understand_image:
  prompt: "识别此截图中确切的错误信息和堆栈跟踪"
  image_source: "/tmp/error.png"

# 好:UI 审查
mcp__MiniMax__understand_image:
  prompt: "列出此表单设计中的所有无障碍访问违规项"
  image_source: "./mockup.png"

# 差:模糊的提示
mcp__MiniMax__understand_image:
  prompt: "这是什么?"  # 太模糊
  image_source: "./image.png"

与 Ralph Loop 集成

# 研究阶段:使用 web_search
Task:
  prompt: |
    使用 mcp__MiniMax__web_search 研究 $TOPIC 的最新模式。
    将发现整理成结构化报告。

# 调试阶段:使用 understand_image
Task:
  prompt: |
    使用 mcp__MiniMax__understand_image 分析 $PATH 处的错误截图。
    识别根本原因并提出修复建议。

成本分析

操作 MiniMax MCP Gemini CLI 节省
网络搜索 ~$0.008 ~$0.06 87%
图像分析 ~$0.01 N/A 新功能

何时不使用

场景 替代方案
仅限美国的搜索 WebSearch(免费)
代码搜索 ast-grep MCP (v2.23)
长文本生成 Gemini CLI (1M 上下文)
实时数据 原生 WebFetch

故障排除

问题 解决方案
“API 密钥无效” 检查 ~/.claude.json 中的 MINIMAX_API_KEY
“图像太大” 压缩至 <20MB
“格式不支持” 转换为 JPEG/PNG/WebP
“无结果” 使用更多关键词优化查询