minimax-mcp-api

A Model Context Protocol (MCP) server written in NestJS that wraps the MiniMax platform APIs and exposes them as MCP tools over stdio.

Prerequisites

• Node.js ≥ 22 (per engines.node in package.json). Older versions lack the TypeScript target support used in tsconfig.build.json.

Related MCP server: MiniMax Unified MCP

Install

npm install

Build

npm run build

Run (stdio)

node dist/main.js

Environment variables

Copy .env.example to .env and fill in MINIMAX_API_KEY before running.

MCP tools

(16 tools total over 5 domains.)

Configure Claude Desktop

Add to ~/.config/claude_desktop_config.json (note: the path to dist/main.js must be absolute):

{
  "mcpServers": {
    "minimax": {
      "command": "node",
      "args": ["/abs/path/to/minimax-mcp-api/dist/main.js"],
      "env": {
        "MINIMAX_API_KEY": "sk-..."
      }
    }
  }
}

Probe with MCP Inspector

npm run inspect

Troubleshooting

• 401/403 from any tool — MINIMAX_API_KEY is missing, malformed, or revoked. Verify with echo $MINIMAX_API_KEY and recopy the key from the MiniMax dashboard.

• npm run build fails with TypeScript errors — Node version mismatch. Check node -v returns v22.x; older Node lacks the target support configured in tsconfig.build.json.

• Claude Desktop can't connect — confirm args[0] is an absolute path to dist/main.js (not relative) and that the file exists (run npm run build first).

• MINIMAX_API_URL change has no effect — stdio MCP servers read environment variables at startup only. Restart Claude Desktop (or the stdio process) after editing .env.

License

UNLICENSED — private project, not for redistribution.