pi-minimax-mcp

MiniMax MCP tools for Pi - Web search and image understanding via MiniMax's Model Context Protocol.

Features

🔍 Web Search - Real-time web search for current information
🖼️ Image Understanding - Analyze and describe image content
⚡ Pi Native - Works as Pi extension or standalone CLI
🔧 Configurable - Environment variables, config files, or CLI flags

Prerequisites

Get MiniMax API Key
- Visit MiniMax Coding Plan
- Subscribe and get your API key

Install uvx

curl -LsSf https://astral.sh/uv/install.sh | sh

Installation

As Pi Extension

pi install npm:@ameno/pi-minimax-mcp

As Standalone CLI

npm install -g @ameno/pi-minimax-mcp
# or
pnpm add -g @ameno/pi-minimax-mcp

Configuration

Environment Variables

export MINIMAX_API_KEY="your-api-key"
export MINIMAX_API_HOST="https://api.minimax.io"  # optional
export MINIMAX_MCP_BASE_PATH="/tmp/minimax"        # optional
export MINIMAX_API_RESOURCE_MODE="url"             # optional: url | local

Config File

Create ~/.pi/agent/extensions/minimax-mcp.json:

{
  "apiKey": "your-api-key",
  "apiHost": "https://api.minimax.io",
  "basePath": "/tmp/minimax-output",
  "resourceMode": "url",
  "timeoutMs": 60000,
  "maxBytes": 51200,
  "maxLines": 2000
}

Or project-specific .pi/extensions/minimax-mcp.json.

Usage

In Pi

Search the web for "latest React server components"

What does this screenshot show? ./screenshot.png

CLI

# Web search
pi-minimax-mcp search "quantum computing breakthroughs"
pi-minimax-mcp search "Rust async patterns" --num-results 10

# Image analysis
pi-minimax-mcp understand ./error.png
pi-minimax-mcp understand ./chart.png --prompt "What trends?"

# Configuration
pi-minimax-mcp config
pi-minimax-mcp init

Programmatic

import { MiniMaxMcpClient } from "@ameno/pi-minimax-mcp";

const client = new MiniMaxMcpClient({
  apiKey: process.env.MINIMAX_API_KEY!,
});

// Web search
const searchResults = await client.webSearch({
  query: "TypeScript 5.5 features",
  numResults: 5,
});

// Image understanding
const imageAnalysis = await client.understandImage({
  imagePath: "./diagram.png",
  prompt: "Explain this architecture",
});

client.disconnect();

Pi Extension Flags

pi --minimax-api-key=<key> --minimax-api-host=<host>

Flag	Description
`--minimax-api-key`	Override API key
`--minimax-api-host`	Override API host
`--minimax-mcp-config`	Custom config file path
`--minimax-mcp-max-bytes`	Max output bytes
`--minimax-mcp-max-lines`	Max output lines

Architecture

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   Pi Agent      │────▶│  pi-minimax-mcp  │────▶│  uvx minimax-   │
│   Extension     │◄────│   Extension      │◄────│  coding-plan-mcp│
└─────────────────┘     └──────────────────┘     └─────────────────┘
                                                        │
                                                        ▼
                                                   ┌─────────┐
                                                   │ MiniMax │
                                                   │  API    │
                                                   └─────────┘

Tools Reference

`web_search`

Search the web for current information.

Parameters:

query (string, required): Search query
numResults (number, optional): Results to return (1-10, default: 5)
recencyDays (number, optional): Limit to recent days

`understand_image`

Analyze image content.