{"_id":"@ameno/pi-minimax-mcp","_rev":"2-14773f4a67d6e465c3b835cf11c37c09","name":"@ameno/pi-minimax-mcp","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@ameno/pi-minimax-mcp","version":"1.0.0","keywords":["pi","pi-package","pi-extension","pi-coding-agent","pi-mcp","pi-tool","pi-ai","ai","minimax","mcp","mcp-server","web-search","image-understanding","model-context-protocol","coding-agent","agent-tools"],"author":{"name":"ameno"},"license":"MIT","_id":"@ameno/pi-minimax-mcp@1.0.0","maintainers":[{"name":"ameno","email":"ameno.osman13@gmail.com"}],"homepage":"https://github.com/ameno-/pi-minimax-mcp#readme","bugs":{"url":"https://github.com/ameno-/pi-minimax-mcp/issues"},"pi":{"extensions":["./extensions/index.ts"]},"bin":{"pi-minimax-mcp":"bin/pi-minimax-mcp.js"},"dist":{"shasum":"a3f78dc174cb5fa7620ad91450f61e23b9a49438","tarball":"https://registry.npmjs.org/@ameno/pi-minimax-mcp/-/pi-minimax-mcp-1.0.0.tgz","fileCount":26,"integrity":"sha512-wpQYO/1SE42DTUl9eoW5MIOckTBqMzPRGxY53kO5zRVNtXa25d/34GnusewLoeDaF0Q8QYULZdtH9L51el5ptA==","signatures":[{"sig":"MEYCIQClrz7iyW2ZFhS2BcqgxPFAQ3iNPH6D8umB2qaIpheIpAIhAJm6K0Nkqwh4liYcqnQ5CjSD1DGB6xhvNQvtcGqArJGN","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":59488},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.0.0"},"gitHead":"5cc7078f436b34da0924b3fb7972b6f9b611e26d","scripts":{"dev":"tsc --watch","lint":"biome check src/","test":"node --test dist/**/*.test.js","build":"tsc","format":"biome format --write src/"},"_npmUser":{"name":"ameno","email":"ameno.osman13@gmail.com"},"repository":{"url":"git+https://github.com/ameno-/pi-minimax-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MiniMax MCP tools for pi - Web search and image understanding via MiniMax's Model Context Protocol","directories":{},"_nodeVersion":"22.13.1","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^22.0.0"},"peerDependencies":{"@sinclair/typebox":"*","@mariozechner/pi-ai":"*","@mariozechner/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-minimax-mcp_1.0.0_1769989840902_0.5016868422460719","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@ameno/pi-minimax-mcp","version":"1.0.1","description":"MiniMax MCP tools for pi - Web search and image understanding via MiniMax's Model Context Protocol","keywords":["pi","pi-package","pi-extension","pi-coding-agent","pi-mcp","pi-tool","pi-ai","ai","minimax","mcp","mcp-server","web-search","image-understanding","model-context-protocol","coding-agent","agent-tools"],"type":"module","main":"dist/index.js","types":"dist/index.d.ts","bin":{"pi-minimax-mcp":"bin/pi-minimax-mcp.js"},"pi":{"extensions":["./extensions/index.ts"]},"scripts":{"build":"tsc","dev":"tsc --watch","test":"node --test dist/**/*.test.js","lint":"biome check src/","format":"biome format --write src/"},"peerDependencies":{"@mariozechner/pi-ai":"*","@mariozechner/pi-coding-agent":"*","@sinclair/typebox":"*"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.5.0"},"engines":{"node":">=20.0.0"},"repository":{"type":"git","url":"git+https://github.com/ameno-/pi-minimax-mcp.git"},"author":{"name":"ameno"},"license":"MIT","_id":"@ameno/pi-minimax-mcp@1.0.1","gitHead":"4a1a07fe280a780daa92aca6888a7a2b5d1c0a5e","bugs":{"url":"https://github.com/ameno-/pi-minimax-mcp/issues"},"homepage":"https://github.com/ameno-/pi-minimax-mcp#readme","_nodeVersion":"22.13.1","_npmVersion":"10.9.2","dist":{"integrity":"sha512-/E1dzPW70lUA3pcZOpjInIfb1atzN1k7eSJh2UFvZ067thcOx1FPSOyllP8FosaRtqeSUF1CEetL8eqH1YUkNw==","shasum":"660bb3d9b05e137cf5735c9fd31e4e96edab162c","tarball":"https://registry.npmjs.org/@ameno/pi-minimax-mcp/-/pi-minimax-mcp-1.0.1.tgz","fileCount":50,"unpackedSize":113988,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDb2yHXavMrIUBMKDtfzp1u5y5EH7PguJOfnk7Ur3MQfwIgDWa5Z0pWJof4KLDgitwhVPLjvw3Ln3pvPUVa1g734yM="}]},"_npmUser":{"name":"ameno","email":"ameno.osman13@gmail.com"},"directories":{},"maintainers":[{"name":"ameno","email":"ameno.osman13@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pi-minimax-mcp_1.0.1_1770159787029_0.6030801883524854"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-01T23:50:40.736Z","modified":"2026-02-03T23:03:07.372Z","1.0.0":"2026-02-01T23:50:41.106Z","1.0.1":"2026-02-03T23:03:07.240Z"},"bugs":{"url":"https://github.com/ameno-/pi-minimax-mcp/issues"},"author":{"name":"ameno"},"license":"MIT","homepage":"https://github.com/ameno-/pi-minimax-mcp#readme","keywords":["pi","pi-package","pi-extension","pi-coding-agent","pi-mcp","pi-tool","pi-ai","ai","minimax","mcp","mcp-server","web-search","image-understanding","model-context-protocol","coding-agent","agent-tools"],"repository":{"type":"git","url":"git+https://github.com/ameno-/pi-minimax-mcp.git"},"description":"MiniMax MCP tools for pi - Web search and image understanding via MiniMax's Model Context Protocol","maintainers":[{"name":"ameno","email":"ameno.osman13@gmail.com"}],"readme":"# pi-minimax-mcp\n\nMiniMax MCP tools for [Pi](https://github.com/mariozechner/pi) - Web search and image understanding via MiniMax's Model Context Protocol.\n\n[![Pi Extension](https://img.shields.io/badge/Pi-Extension-blue)](https://github.com/mariozechner/pi)\n[![MiniMax](https://img.shields.io/badge/MiniMax-MCP-green)](https://platform.minimax.io)\n\n## Features\n\n- 🔍 **Web Search** - Real-time web search for current information\n- 🖼️ **Image Understanding** - Analyze and describe image content\n- ⚡ **Pi Native** - Works as Pi extension or standalone CLI\n- 🔧 **Configurable** - Environment variables, config files, or CLI flags\n\n## Prerequisites\n\n1. **Get MiniMax API Key**\n   - Visit [MiniMax Coding Plan](https://platform.minimax.io/subscribe/coding-plan)\n   - Subscribe and get your API key\n\n2. **Install uvx**\n   ```bash\n   curl -LsSf https://astral.sh/uv/install.sh | sh\n   ```\n\n## Installation\n\n### As Pi Extension\n\n```bash\npi install npm:@ameno-/pi-minimax-mcp\n```\n\n### As Standalone CLI\n\n```bash\nnpm install -g @ameno-/pi-minimax-mcp\n# or\npnpm add -g @ameno-/pi-minimax-mcp\n```\n\n## Configuration\n\n### Environment Variables\n\n```bash\nexport MINIMAX_API_KEY=\"your-api-key\"\nexport MINIMAX_API_HOST=\"https://api.minimax.io\"  # optional\nexport MINIMAX_MCP_BASE_PATH=\"/tmp/minimax\"        # optional\nexport MINIMAX_API_RESOURCE_MODE=\"url\"             # optional: url | local\n```\n\n### Config File\n\nCreate `~/.pi/agent/extensions/minimax-mcp.json`:\n\n```json\n{\n  \"apiKey\": \"your-api-key\",\n  \"apiHost\": \"https://api.minimax.io\",\n  \"basePath\": \"/tmp/minimax-output\",\n  \"resourceMode\": \"url\",\n  \"timeoutMs\": 60000,\n  \"maxBytes\": 51200,\n  \"maxLines\": 2000\n}\n```\n\nOr project-specific `.pi/extensions/minimax-mcp.json`.\n\n## Usage\n\n### In Pi\n\n```\nSearch the web for \"latest React server components\"\n```\n\n```\nWhat does this screenshot show? ./screenshot.png\n```\n\n### CLI\n\n```bash\n# Web search\npi-minimax-mcp search \"quantum computing breakthroughs\"\npi-minimax-mcp search \"Rust async patterns\" --num-results 10\n\n# Image analysis\npi-minimax-mcp understand ./error.png\npi-minimax-mcp understand ./chart.png --prompt \"What trends?\"\n\n# Configuration\npi-minimax-mcp config\npi-minimax-mcp init\n```\n\n### Programmatic\n\n```typescript\nimport { MiniMaxMcpClient } from \"@ameno-/pi-minimax-mcp\";\n\nconst client = new MiniMaxMcpClient({\n  apiKey: process.env.MINIMAX_API_KEY!,\n});\n\n// Web search\nconst searchResults = await client.webSearch({\n  query: \"TypeScript 5.5 features\",\n  numResults: 5,\n});\n\n// Image understanding\nconst imageAnalysis = await client.understandImage({\n  imagePath: \"./diagram.png\",\n  prompt: \"Explain this architecture\",\n});\n\nclient.disconnect();\n```\n\n## Pi Extension Flags\n\n```bash\npi --minimax-api-key=<key> --minimax-api-host=<host>\n```\n\n| Flag | Description |\n|------|-------------|\n| `--minimax-api-key` | Override API key |\n| `--minimax-api-host` | Override API host |\n| `--minimax-mcp-config` | Custom config file path |\n| `--minimax-mcp-max-bytes` | Max output bytes |\n| `--minimax-mcp-max-lines` | Max output lines |\n\n## Architecture\n\n```\n┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐\n│   Pi Agent      │────▶│  pi-minimax-mcp  │────▶│  uvx minimax-   │\n│   Extension     │◄────│   Extension      │◄────│  coding-plan-mcp│\n└─────────────────┘     └──────────────────┘     └─────────────────┘\n                                                        │\n                                                        ▼\n                                                   ┌─────────┐\n                                                   │ MiniMax │\n                                                   │  API    │\n                                                   └─────────┘\n```\n\n## Tools Reference\n\n### `web_search`\n\nSearch the web for current information.\n\n**Parameters:**\n- `query` (string, required): Search query\n- `numResults` (number, optional): Results to return (1-10, default: 5)\n- `recencyDays` (number, optional): Limit to recent days\n\n### `understand_image`\n\nAnalyze image content.\n\n**Parameters:**\n- `imagePath` (string, required): Path to image file\n- `prompt` (string, optional): Guiding question/prompt\n\n## Development\n\n```bash\n# Clone\ngit clone https://github.com/ameno-/pi-minimax-mcp.git\ncd pi-minimax-mcp\n\n# Install dependencies\npnpm install\n\n# Build\npnpm run build\n\n# Test\npnpm test\n```\n\n## License\n\nMIT\n\n## Acknowledgments\n\n- Inspired by [@benvargas/pi-exa-mcp](https://github.com/ben-vargas/pi-packages)\n- Powered by [MiniMax](https://minimax.io)\n","readmeFilename":"README.md"}