minimax-coding-plan-mcp 0.0.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (20) hide show
  1. minimax_coding_plan_mcp-0.0.1/LICENSE +21 -0
  2. minimax_coding_plan_mcp-0.0.1/PKG-INFO +202 -0
  3. minimax_coding_plan_mcp-0.0.1/README.md +145 -0
  4. minimax_coding_plan_mcp-0.0.1/minimax_coding_plan_mcp.egg-info/PKG-INFO +202 -0
  5. minimax_coding_plan_mcp-0.0.1/minimax_coding_plan_mcp.egg-info/SOURCES.txt +18 -0
  6. minimax_coding_plan_mcp-0.0.1/minimax_coding_plan_mcp.egg-info/dependency_links.txt +1 -0
  7. minimax_coding_plan_mcp-0.0.1/minimax_coding_plan_mcp.egg-info/entry_points.txt +2 -0
  8. minimax_coding_plan_mcp-0.0.1/minimax_coding_plan_mcp.egg-info/requires.txt +20 -0
  9. minimax_coding_plan_mcp-0.0.1/minimax_coding_plan_mcp.egg-info/top_level.txt +1 -0
  10. minimax_coding_plan_mcp-0.0.1/minimax_mcp/__init__.py +3 -0
  11. minimax_coding_plan_mcp-0.0.1/minimax_mcp/__main__.py +100 -0
  12. minimax_coding_plan_mcp-0.0.1/minimax_mcp/client.py +95 -0
  13. minimax_coding_plan_mcp-0.0.1/minimax_mcp/const.py +30 -0
  14. minimax_coding_plan_mcp-0.0.1/minimax_mcp/exceptions.py +24 -0
  15. minimax_coding_plan_mcp-0.0.1/minimax_mcp/server.py +170 -0
  16. minimax_coding_plan_mcp-0.0.1/minimax_mcp/utils.py +251 -0
  17. minimax_coding_plan_mcp-0.0.1/pyproject.toml +59 -0
  18. minimax_coding_plan_mcp-0.0.1/setup.cfg +4 -0
  19. minimax_coding_plan_mcp-0.0.1/setup.py +6 -0
  20. minimax_coding_plan_mcp-0.0.1/tests/test_utils.py +107 -0
minimax_coding_plan_mcp-0.0.1/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright 2025 MiniMax AI.
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
minimax_coding_plan_mcp-0.0.1/PKG-INFO ADDED
@@ -0,0 +1,202 @@
1
+ Metadata-Version: 2.4
2
+ Name: minimax-coding-plan-mcp
3
+ Version: 0.0.1
4
+ Summary: Specialized MiniMax Model Context Protocol (MCP) server designed for coding-plan users
5
+ Author-email: Roy Wu <zhengyu@minimax.chat>
6
+ License: MIT License
7
+
8
+ Copyright 2025 MiniMax AI.
9
+
10
+ Permission is hereby granted, free of charge, to any person obtaining a copy
11
+ of this software and associated documentation files (the "Software"), to deal
12
+ in the Software without restriction, including without limitation the rights
13
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
14
+ copies of the Software, and to permit persons to whom the Software is
15
+ furnished to do so, subject to the following conditions:
16
+
17
+ The above copyright notice and this permission notice shall be included in all
18
+ copies or substantial portions of the Software.
19
+
20
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
21
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
22
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
23
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
24
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
25
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
26
+ SOFTWARE.
27
+
28
+ Keywords: minimax,mcp,coding-plan-search,coding-plan-vlm
29
+ Classifier: Development Status :: 4 - Beta
30
+ Classifier: Intended Audience :: Developers
31
+ Classifier: License :: OSI Approved :: MIT License
32
+ Classifier: Programming Language :: Python :: 3
33
+ Classifier: Programming Language :: Python :: 3.10
34
+ Requires-Python: >=3.10
35
+ Description-Content-Type: text/markdown
36
+ License-File: LICENSE
37
+ Requires-Dist: mcp[cli]>=1.6.0
38
+ Requires-Dist: fastapi>=0.109.2
39
+ Requires-Dist: uvicorn>=0.27.1
40
+ Requires-Dist: python-dotenv>=1.0.1
41
+ Requires-Dist: pydantic>=2.6.1
42
+ Requires-Dist: httpx>=0.28.1
43
+ Requires-Dist: fuzzywuzzy>=0.18.0
44
+ Requires-Dist: python-Levenshtein>=0.25.0
45
+ Requires-Dist: sounddevice>=0.5.1
46
+ Requires-Dist: soundfile>=0.13.1
47
+ Requires-Dist: requests>=2.31.0
48
+ Provides-Extra: dev
49
+ Requires-Dist: pre-commit>=3.6.2; extra == "dev"
50
+ Requires-Dist: ruff>=0.3.0; extra == "dev"
51
+ Requires-Dist: fastmcp>=0.4.1; extra == "dev"
52
+ Requires-Dist: pytest>=8.0.0; extra == "dev"
53
+ Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
54
+ Requires-Dist: twine>=6.1.0; extra == "dev"
55
+ Requires-Dist: build>=1.0.3; extra == "dev"
56
+ Dynamic: license-file
57
+
58
+ ![export](https://github.com/MiniMax-AI/MiniMax-01/raw/main/figures/MiniMaxLogo-Light.png)
59
+
60
+ <div align="center" style="line-height: 1;">
61
+ <a href="https://www.minimax.io" target="_blank" style="margin: 2px; color: var(--fgColor-default);">
62
+ <img alt="Homepage" src="https://img.shields.io/badge/_Homepage-MiniMax-FF4040?style=flat-square&labelColor=2C3E50&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgNDkwLjE2IDQxMS43Ij48ZGVmcz48c3R5bGU+LmNscy0xe2ZpbGw6I2ZmZjt9PC9zdHlsZT48L2RlZnM+PHBhdGggY2xhc3M9ImNscy0xIiBkPSJNMjMzLjQ1LDQwLjgxYTE3LjU1LDE3LjU1LDAsMSwwLTM1LjEsMFYzMzEuNTZhNDAuODIsNDAuODIsMCwwLDEtODEuNjMsMFYxNDVhMTcuNTUsMTcuNTUsMCwxLDAtMzUuMDksMHY3OS4wNmE0MC44Miw0MC44MiwwLDAsMS04MS42MywwVjE5NS40MmExMS42MywxMS42MywwLDAsMSwyMy4yNiwwdjI4LjY2YTE3LjU1LDE3LjU1LDAsMCwwLDM1LjEsMFYxNDVBNDAuODIsNDAuODIsMCwwLDEsMTQwLDE0NVYzMzEuNTZhMTcuNTUsMTcuNTUsMCwwLDAsMzUuMSwwVjIxNy41aDBWNDAuODFhNDAuODEsNDAuODEsMCwxLDEsODEuNjIsMFYyODEuNTZhMTEuNjMsMTEuNjMsMCwxLDEtMjMuMjYsMFptMjE1LjksNjMuNEE0MC44Niw0MC44NiwwLDAsMCw0MDguNTMsMTQ1VjMwMC44NWExNy41NSwxNy41NSwwLDAsMS0zNS4wOSwwdi0yNjBhNDAuODIsNDAuODIsMCwwLDAtODEuNjMsMFYzNzAuODlhMTcuNTUsMTcuNTUsMCwwLDEtMzUuMSwwVjMzMGExMS42MywxMS42MywwLDEsMC0yMy4yNiwwdjQwLjg2YTQwLjgxLDQwLjgxLDAsMCwwLDgxLjYyLDBWNDAuODFhMTcuNTUsMTcuNTUsMCwwLDEsMzUuMSwwdjI2MGE0MC44Miw0MC44MiwwLDAsMCw4MS42MywwVjE0NWExNy41NSwxNy41NSwwLDEsMSwzNS4xLDBWMjgxLjU2YTExLjYzLDExLjYzLDAsMCwwLDIzLjI2LDBWMTQ1QTQwLjg1LDQwLjg1LDAsMCwwLDQ0OS4zNSwxMDQuMjFaIi8+PC9zdmc+&logoWidth=20" style="display: inline-block; vertical-align: middle;"/>
63
+ </a>
64
+ <a href="https://arxiv.org/abs/2501.08313" target="_blank" style="margin: 2px;">
65
+ <img alt="Paper" src="https://img.shields.io/badge/📖_Paper-MiniMax--01-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/>
66
+ </a>
67
+ <a href="https://chat.minimax.io/" target="_blank" style="margin: 2px;">
68
+ <img alt="Chat" src="https://img.shields.io/badge/_MiniMax_Chat-FF4040?style=flat-square&labelColor=2C3E50&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgNDkwLjE2IDQxMS43Ij48ZGVmcz48c3R5bGU+LmNscy0xe2ZpbGw6I2ZmZjt9PC9zdHlsZT48L2RlZnM+PHBhdGggY2xhc3M9ImNscy0xIiBkPSJNMjMzLjQ1LDQwLjgxYTE3LjU1LDE3LjU1LDAsMSwwLTM1LjEsMFYzMzEuNTZhNDAuODIsNDAuODIsMCwwLDEtODEuNjMsMFYxNDVhMTcuNTUsMTcuNTUsMCwxLDAtMzUuMDksMHY3OS4wNmE0MC44Miw0MC44MiwwLDAsMS04MS42MywwVjE5NS40MmExMS42MywxMS42MywwLDAsMSwyMy4yNiwwdjI4LjY2YTE3LjU1LDE3LjU1LDAsMCwwLDM1LjEsMFYxNDVBNDAuODIsNDAuODIsMCwwLDEsMTQwLDE0NVYzMzEuNTZhMTcuNTUsMTcuNTUsMCwwLDAsMzUuMSwwVjIxNy41aDBWNDAuODFhNDAuODEsNDAuODEsMCwxLDEsODEuNjIsMFYyODEuNTZhMTEuNjMsMTEuNjMsMCwxLDEtMjMuMjYsMFptMjE1LjksNjMuNEE0MC44Niw0MC44NiwwLDAsMCw0MDguNTMsMTQ1VjMwMC44NWExNy41NSwxNy41NSwwLDAsMS0zNS4wOSwwdi0yNjBhNDAuODIsNDAuODIsMCwwLDAtODEuNjMsMFYzNzAuODlhMTcuNTUsMTcuNTUsMCwwLDEtMzUuMSwwVjMzMGExMS42MywxMS42MywwLDEsMC0yMy4yNiwwdjQwLjg2YTQwLjgxLDQwLjgxLDAsMCwwLDgxLjYyLDBWNDAuODFhMTcuNTUsMTcuNTUsMCwwLDEsMzUuMSwwdjI2MGE0MC44Miw0MC44MiwwLDAsMCw4MS42MywwVjE0NWExNy41NSwxNy41NSwwLDEsMSwzNS4xLDBWMjgxLjU2YTExLjYzLDExLjYzLDAsMCwwLDIzLjI2LDBWMTQ1QTQwLjg1LDQwLjg1LDAsMCwwLDQ0OS4zNSwxMDQuMjFaIi8+PC9zdmc+&logoWidth=20" style="display: inline-block; vertical-align: middle;"/>
69
+ </a>
70
+ <a href="https://www.minimax.io/platform" style="margin: 2px;">
71
+ <img alt="API" src="https://img.shields.io/badge/⚡_API-Platform-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/>
72
+ </a>
73
+ </div>
74
+ <div align="center" style="line-height: 1;">
75
+ <a href="https://huggingface.co/MiniMaxAI" target="_blank" style="margin: 2px;">
76
+ <img alt="Hugging Face" src="https://img.shields.io/badge/🤗_Hugging_Face-MiniMax-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/>
77
+ </a>
78
+ <a href="https://github.com/MiniMax-AI/MiniMax-AI.github.io/blob/main/images/wechat-qrcode.jpeg" target="_blank" style="margin: 2px;">
79
+ <img alt="WeChat" src="https://img.shields.io/badge/_WeChat-MiniMax-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/>
80
+ </a>
81
+ <a href="https://www.modelscope.cn/organization/MiniMax" target="_blank" style="margin: 2px;">
82
+ <img alt="ModelScope" src="https://img.shields.io/badge/_ModelScope-MiniMax-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/>
83
+ </a>
84
+ </div>
85
+ <div align="center" style="line-height: 1;">
86
+ <a href="https://github.com/MiniMax-AI/MiniMax-MCP/blob/main/LICENSE" style="margin: 2px;">
87
+ <img alt="Code License" src="https://img.shields.io/badge/_Code_License-MIT-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/>
88
+ </a>
89
+ </div>
90
+
91
+ <p align="center">
92
+ Specialized MiniMax Model Context Protocol (MCP) server designed for <b>coding-plan</b> users, featuring AI-powered search and vision analysis APIs optimized for code development workflows. Unlike the standard <a href="https://github.com/MiniMax-AI/MiniMax-MCP">MiniMax-MCP</a>, this version provides coding-specific tools (for examples: <code>coding_plan_search</code> and <code>coding_plan_vlm</code>) that integrate seamlessly with MCP clients like <a href="https://www.anthropic.com/claude">Claude Desktop</a>, <a href="https://www.cursor.so">Cursor</a>, <a href="https://codeium.com/windsurf">Windsurf</a>, <a href="https://github.com/openai/openai-agents-python">OpenAI Agents</a> and others to enhance your coding experience.
93
+ </p>
94
+
95
+ ## Documentation
96
+ - [中文文档](README-CN.md)
97
+
98
+
99
+ ## Quickstart with MCP Client
100
+ 1. Get your API key from [MiniMax](https://www.minimax.io/platform/user-center/basic-information/interface-key).
101
+ 2. Install `uv` (Python package manager), install with `curl -LsSf https://astral.sh/uv/install.sh | sh` or see the `uv` [repo](https://github.com/astral-sh/uv) for additional install methods.
102
+ 3. **Important**: The API host and key vary by region and must match; otherwise, you'll encounter an `Invalid API key` error.
103
+
104
+ |Region| Global | Mainland |
105
+ |:--|:-----|:-----|
106
+ |MINIMAX_API_KEY| go get from [MiniMax Global](https://www.minimax.io/platform/user-center/basic-information/interface-key) | go get from [MiniMax](https://platform.minimaxi.com/user-center/basic-information/interface-key) |
107
+ |MINIMAX_API_HOST| https://api.minimax.io | https://api.minimaxi.com |
108
+
109
+
110
+ ### Claude Desktop
111
+ Go to `Claude > Settings > Developer > Edit Config > claude_desktop_config.json` to include the following:
112
+
113
+ ```
114
+ {
115
+ "mcpServers": {
116
+ "MiniMax": {
117
+ "command": "uvx",
118
+ "args": [
119
+ "minimax-coding-plan-mcp",
120
+ "-y"
121
+ ],
122
+ "env": {
123
+ "MINIMAX_API_KEY": "insert-your-api-key-here",
124
+ "MINIMAX_MCP_BASE_PATH": "local-output-dir-path, such as /User/xxx/Desktop",
125
+ "MINIMAX_API_HOST": "api host, https://api.minimax.io | https://api.minimaxi.com",
126
+ "MINIMAX_API_RESOURCE_MODE": "optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format"
127
+ }
128
+ }
129
+ }
130
+ }
131
+
132
+ ```
133
+ ⚠️ Warning: The API key needs to match the host. If an error "API Error: invalid api key" occurs, please check your api host:
134
+ - Global Host：`https://api.minimax.io`
135
+ - Mainland Host：`https://api.minimaxi.com`
136
+
137
+ If you're using Windows, you will have to enable "Developer Mode" in Claude Desktop to use the MCP server. Click "Help" in the hamburger menu in the top left and select "Enable Developer Mode".
138
+
139
+
140
+ ### Cursor
141
+ Go to `Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server` to add above config.
142
+
143
+ That's it. Your MCP client can now interact with MiniMax through these tools:
144
+
145
+ ## Transport
146
+ We support two transport types: stdio and sse.
147
+ | stdio | SSE |
148
+ |:-----|:-----|
149
+ | Run locally | Can be deployed locally or in the cloud |
150
+ | Communication through `stdout` | Communication through `network` |
151
+ | Input: Supports processing `local files` or valid `URL` resources | Input: When deployed in the cloud, it is recommended to use `URL` for input |
152
+
153
+ ## Available Tools
154
+ | tool | description |
155
+ |-|-|
156
+ |`coding_plan_search`|Performs web searches and returns organic search results along with related search queries|
157
+ |`coding_plan_vlm`|Analyzes images with AI based on text prompts, extracts information and answers questions about images|
158
+
159
+ ## Release Notes
160
+
161
+ ### November 20, 2025
162
+
163
+ #### 🆕 What's New
164
+ - **Web Search**: New `coding_plan_search` tool - perform web searches and get organic results with related search queries
165
+ - **Vision Language Model**: New `coding_plan_vlm` tool - analyze images using AI based on text prompts
166
+
167
+ #### 📈 Features
168
+ - `coding_plan_search` - Search the web and get structured results including titles, links, snippets, and related searches
169
+ - `coding_plan_vlm` - Analyze images from URLs or local files, supporting JPEG, PNG, GIF, and WebP formats
170
+
171
+ ## FAQ
172
+ ### 1. invalid api key
173
+ Please ensure your API key and API host are regionally aligned
174
+ |Region| Global | Mainland |
175
+ |:--|:-----|:-----|
176
+ |MINIMAX_API_KEY| go get from [MiniMax Global](https://www.minimax.io/platform/user-center/basic-information/interface-key) | go get from [MiniMax](https://platform.minimaxi.com/user-center/basic-information/interface-key) |
177
+ |MINIMAX_API_HOST| https://api.minimax.io | https://api.minimaxi.com |
178
+
179
+ ### 2. spawn uvx ENOENT
180
+ Please confirm its absolute path by running this command in your terminal:
181
+ ```sh
182
+ which uvx
183
+ ```
184
+ Once you obtain the absolute path (e.g., /usr/local/bin/uvx), update your configuration to use that path (e.g., "command": "/usr/local/bin/uvx").
185
+
186
+
187
+
188
+ ## Example usage
189
+
190
+ ⚠️ Warning: Using these tools may incur costs.
191
+
192
+ ### 1. Web Search
193
+ Use the `coding_plan_search` tool to search for information on the web:
194
+
195
+ <img src="https://cdn.hailuoai.video/moss/prod/2025-11-20-15/user/multi_chat_file/99ff15e3-e5d6-48e2-8216-38c6abf03c71.image/png" style="display:
196
+ inline-block; vertical-align: middle; "/>
197
+
198
+ ### 2. Image Analysis
199
+ Use the `coding_plan_vlm` tool to analyze images with AI:
200
+
201
+ <img src="https://cdn.hailuoai.video/moss/prod/2025-11-20-15/user/multi_chat_file/1f8174a2-68d5-4576-b886-86933eab5280.image/png" style="display:
202
+ inline-block; vertical-align: middle; "/>
minimax_coding_plan_mcp-0.0.1/README.md ADDED
@@ -0,0 +1,145 @@
1
+ ![export](https://github.com/MiniMax-AI/MiniMax-01/raw/main/figures/MiniMaxLogo-Light.png)
2
+
3
+ <div align="center" style="line-height: 1;">
4
+ <a href="https://www.minimax.io" target="_blank" style="margin: 2px; color: var(--fgColor-default);">
5
+ <img alt="Homepage" src="https://img.shields.io/badge/_Homepage-MiniMax-FF4040?style=flat-square&labelColor=2C3E50&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgNDkwLjE2IDQxMS43Ij48ZGVmcz48c3R5bGU+LmNscy0xe2ZpbGw6I2ZmZjt9PC9zdHlsZT48L2RlZnM+PHBhdGggY2xhc3M9ImNscy0xIiBkPSJNMjMzLjQ1LDQwLjgxYTE3LjU1LDE3LjU1LDAsMSwwLTM1LjEsMFYzMzEuNTZhNDAuODIsNDAuODIsMCwwLDEtODEuNjMsMFYxNDVhMTcuNTUsMTcuNTUsMCwxLDAtMzUuMDksMHY3OS4wNmE0MC44Miw0MC44MiwwLDAsMS04MS42MywwVjE5NS40MmExMS42MywxMS42MywwLDAsMSwyMy4yNiwwdjI4LjY2YTE3LjU1LDE3LjU1LDAsMCwwLDM1LjEsMFYxNDVBNDAuODIsNDAuODIsMCwwLDEsMTQwLDE0NVYzMzEuNTZhMTcuNTUsMTcuNTUsMCwwLDAsMzUuMSwwVjIxNy41aDBWNDAuODFhNDAuODEsNDAuODEsMCwxLDEsODEuNjIsMFYyODEuNTZhMTEuNjMsMTEuNjMsMCwxLDEtMjMuMjYsMFptMjE1LjksNjMuNEE0MC44Niw0MC44NiwwLDAsMCw0MDguNTMsMTQ1VjMwMC44NWExNy41NSwxNy41NSwwLDAsMS0zNS4wOSwwdi0yNjBhNDAuODIsNDAuODIsMCwwLDAtODEuNjMsMFYzNzAuODlhMTcuNTUsMTcuNTUsMCwwLDEtMzUuMSwwVjMzMGExMS42MywxMS42MywwLDEsMC0yMy4yNiwwdjQwLjg2YTQwLjgxLDQwLjgxLDAsMCwwLDgxLjYyLDBWNDAuODFhMTcuNTUsMTcuNTUsMCwwLDEsMzUuMSwwdjI2MGE0MC44Miw0MC44MiwwLDAsMCw4MS42MywwVjE0NWExNy41NSwxNy41NSwwLDEsMSwzNS4xLDBWMjgxLjU2YTExLjYzLDExLjYzLDAsMCwwLDIzLjI2LDBWMTQ1QTQwLjg1LDQwLjg1LDAsMCwwLDQ0OS4zNSwxMDQuMjFaIi8+PC9zdmc+&logoWidth=20" style="display: inline-block; vertical-align: middle;"/>
6
+ </a>
7
+ <a href="https://arxiv.org/abs/2501.08313" target="_blank" style="margin: 2px;">
8
+ <img alt="Paper" src="https://img.shields.io/badge/📖_Paper-MiniMax--01-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/>
9
+ </a>
10
+ <a href="https://chat.minimax.io/" target="_blank" style="margin: 2px;">
11
+ <img alt="Chat" src="https://img.shields.io/badge/_MiniMax_Chat-FF4040?style=flat-square&labelColor=2C3E50&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgNDkwLjE2IDQxMS43Ij48ZGVmcz48c3R5bGU+LmNscy0xe2ZpbGw6I2ZmZjt9PC9zdHlsZT48L2RlZnM+PHBhdGggY2xhc3M9ImNscy0xIiBkPSJNMjMzLjQ1LDQwLjgxYTE3LjU1LDE3LjU1LDAsMSwwLTM1LjEsMFYzMzEuNTZhNDAuODIsNDAuODIsMCwwLDEtODEuNjMsMFYxNDVhMTcuNTUsMTcuNTUsMCwxLDAtMzUuMDksMHY3OS4wNmE0MC44Miw0MC44MiwwLDAsMS04MS42MywwVjE5NS40MmExMS42MywxMS42MywwLDAsMSwyMy4yNiwwdjI4LjY2YTE3LjU1LDE3LjU1LDAsMCwwLDM1LjEsMFYxNDVBNDAuODIsNDAuODIsMCwwLDEsMTQwLDE0NVYzMzEuNTZhMTcuNTUsMTcuNTUsMCwwLDAsMzUuMSwwVjIxNy41aDBWNDAuODFhNDAuODEsNDAuODEsMCwxLDEsODEuNjIsMFYyODEuNTZhMTEuNjMsMTEuNjMsMCwxLDEtMjMuMjYsMFptMjE1LjksNjMuNEE0MC44Niw0MC44NiwwLDAsMCw0MDguNTMsMTQ1VjMwMC44NWExNy41NSwxNy41NSwwLDAsMS0zNS4wOSwwdi0yNjBhNDAuODIsNDAuODIsMCwwLDAtODEuNjMsMFYzNzAuODlhMTcuNTUsMTcuNTUsMCwwLDEtMzUuMSwwVjMzMGExMS42MywxMS42MywwLDEsMC0yMy4yNiwwdjQwLjg2YTQwLjgxLDQwLjgxLDAsMCwwLDgxLjYyLDBWNDAuODFhMTcuNTUsMTcuNTUsMCwwLDEsMzUuMSwwdjI2MGE0MC44Miw0MC44MiwwLDAsMCw4MS42MywwVjE0NWExNy41NSwxNy41NSwwLDEsMSwzNS4xLDBWMjgxLjU2YTExLjYzLDExLjYzLDAsMCwwLDIzLjI2LDBWMTQ1QTQwLjg1LDQwLjg1LDAsMCwwLDQ0OS4zNSwxMDQuMjFaIi8+PC9zdmc+&logoWidth=20" style="display: inline-block; vertical-align: middle;"/>
12
+ </a>
13
+ <a href="https://www.minimax.io/platform" style="margin: 2px;">
14
+ <img alt="API" src="https://img.shields.io/badge/⚡_API-Platform-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/>
15
+ </a>
16
+ </div>
17
+ <div align="center" style="line-height: 1;">
18
+ <a href="https://huggingface.co/MiniMaxAI" target="_blank" style="margin: 2px;">
19
+ <img alt="Hugging Face" src="https://img.shields.io/badge/🤗_Hugging_Face-MiniMax-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/>
20
+ </a>
21
+ <a href="https://github.com/MiniMax-AI/MiniMax-AI.github.io/blob/main/images/wechat-qrcode.jpeg" target="_blank" style="margin: 2px;">
22
+ <img alt="WeChat" src="https://img.shields.io/badge/_WeChat-MiniMax-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/>
23
+ </a>
24
+ <a href="https://www.modelscope.cn/organization/MiniMax" target="_blank" style="margin: 2px;">
25
+ <img alt="ModelScope" src="https://img.shields.io/badge/_ModelScope-MiniMax-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/>
26
+ </a>
27
+ </div>
28
+ <div align="center" style="line-height: 1;">
29
+ <a href="https://github.com/MiniMax-AI/MiniMax-MCP/blob/main/LICENSE" style="margin: 2px;">
30
+ <img alt="Code License" src="https://img.shields.io/badge/_Code_License-MIT-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/>
31
+ </a>
32
+ </div>
33
+
34
+ <p align="center">
35
+ Specialized MiniMax Model Context Protocol (MCP) server designed for <b>coding-plan</b> users, featuring AI-powered search and vision analysis APIs optimized for code development workflows. Unlike the standard <a href="https://github.com/MiniMax-AI/MiniMax-MCP">MiniMax-MCP</a>, this version provides coding-specific tools (for examples: <code>coding_plan_search</code> and <code>coding_plan_vlm</code>) that integrate seamlessly with MCP clients like <a href="https://www.anthropic.com/claude">Claude Desktop</a>, <a href="https://www.cursor.so">Cursor</a>, <a href="https://codeium.com/windsurf">Windsurf</a>, <a href="https://github.com/openai/openai-agents-python">OpenAI Agents</a> and others to enhance your coding experience.
36
+ </p>
37
+
38
+ ## Documentation
39
+ - [中文文档](README-CN.md)
40
+
41
+
42
+ ## Quickstart with MCP Client
43
+ 1. Get your API key from [MiniMax](https://www.minimax.io/platform/user-center/basic-information/interface-key).
44
+ 2. Install `uv` (Python package manager), install with `curl -LsSf https://astral.sh/uv/install.sh | sh` or see the `uv` [repo](https://github.com/astral-sh/uv) for additional install methods.
45
+ 3. **Important**: The API host and key vary by region and must match; otherwise, you'll encounter an `Invalid API key` error.
46
+
47
+ |Region| Global | Mainland |
48
+ |:--|:-----|:-----|
49
+ |MINIMAX_API_KEY| go get from [MiniMax Global](https://www.minimax.io/platform/user-center/basic-information/interface-key) | go get from [MiniMax](https://platform.minimaxi.com/user-center/basic-information/interface-key) |
50
+ |MINIMAX_API_HOST| https://api.minimax.io | https://api.minimaxi.com |
51
+
52
+
53
+ ### Claude Desktop
54
+ Go to `Claude > Settings > Developer > Edit Config > claude_desktop_config.json` to include the following:
55
+
56
+ ```
57
+ {
58
+ "mcpServers": {
59
+ "MiniMax": {
60
+ "command": "uvx",
61
+ "args": [
62
+ "minimax-coding-plan-mcp",
63
+ "-y"
64
+ ],
65
+ "env": {
66
+ "MINIMAX_API_KEY": "insert-your-api-key-here",
67
+ "MINIMAX_MCP_BASE_PATH": "local-output-dir-path, such as /User/xxx/Desktop",
68
+ "MINIMAX_API_HOST": "api host, https://api.minimax.io | https://api.minimaxi.com",
69
+ "MINIMAX_API_RESOURCE_MODE": "optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format"
70
+ }
71
+ }
72
+ }
73
+ }
74
+
75
+ ```
76
+ ⚠️ Warning: The API key needs to match the host. If an error "API Error: invalid api key" occurs, please check your api host:
77
+ - Global Host：`https://api.minimax.io`
78
+ - Mainland Host：`https://api.minimaxi.com`
79
+
80
+ If you're using Windows, you will have to enable "Developer Mode" in Claude Desktop to use the MCP server. Click "Help" in the hamburger menu in the top left and select "Enable Developer Mode".
81
+
82
+
83
+ ### Cursor
84
+ Go to `Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server` to add above config.
85
+
86
+ That's it. Your MCP client can now interact with MiniMax through these tools:
87
+
88
+ ## Transport
89
+ We support two transport types: stdio and sse.
90
+ | stdio | SSE |
91
+ |:-----|:-----|
92
+ | Run locally | Can be deployed locally or in the cloud |
93
+ | Communication through `stdout` | Communication through `network` |
94
+ | Input: Supports processing `local files` or valid `URL` resources | Input: When deployed in the cloud, it is recommended to use `URL` for input |
95
+
96
+ ## Available Tools
97
+ | tool | description |
98
+ |-|-|
99
+ |`coding_plan_search`|Performs web searches and returns organic search results along with related search queries|
100
+ |`coding_plan_vlm`|Analyzes images with AI based on text prompts, extracts information and answers questions about images|
101
+
102
+ ## Release Notes
103
+
104
+ ### November 20, 2025
105
+
106
+ #### 🆕 What's New
107
+ - **Web Search**: New `coding_plan_search` tool - perform web searches and get organic results with related search queries
108
+ - **Vision Language Model**: New `coding_plan_vlm` tool - analyze images using AI based on text prompts
109
+
110
+ #### 📈 Features
111
+ - `coding_plan_search` - Search the web and get structured results including titles, links, snippets, and related searches
112
+ - `coding_plan_vlm` - Analyze images from URLs or local files, supporting JPEG, PNG, GIF, and WebP formats
113
+
114
+ ## FAQ
115
+ ### 1. invalid api key
116
+ Please ensure your API key and API host are regionally aligned
117
+ |Region| Global | Mainland |
118
+ |:--|:-----|:-----|
119
+ |MINIMAX_API_KEY| go get from [MiniMax Global](https://www.minimax.io/platform/user-center/basic-information/interface-key) | go get from [MiniMax](https://platform.minimaxi.com/user-center/basic-information/interface-key) |
120
+ |MINIMAX_API_HOST| https://api.minimax.io | https://api.minimaxi.com |
121
+
122
+ ### 2. spawn uvx ENOENT
123
+ Please confirm its absolute path by running this command in your terminal:
124
+ ```sh
125
+ which uvx
126
+ ```
127
+ Once you obtain the absolute path (e.g., /usr/local/bin/uvx), update your configuration to use that path (e.g., "command": "/usr/local/bin/uvx").
128
+
129
+
130
+
131
+ ## Example usage
132
+
133
+ ⚠️ Warning: Using these tools may incur costs.
134
+
135
+ ### 1. Web Search
136
+ Use the `coding_plan_search` tool to search for information on the web:
137
+
138
+ <img src="https://cdn.hailuoai.video/moss/prod/2025-11-20-15/user/multi_chat_file/99ff15e3-e5d6-48e2-8216-38c6abf03c71.image/png" style="display:
139
+ inline-block; vertical-align: middle; "/>
140
+
141
+ ### 2. Image Analysis
142
+ Use the `coding_plan_vlm` tool to analyze images with AI:
143
+
144
+ <img src="https://cdn.hailuoai.video/moss/prod/2025-11-20-15/user/multi_chat_file/1f8174a2-68d5-4576-b886-86933eab5280.image/png" style="display:
145
+ inline-block; vertical-align: middle; "/>
minimax_coding_plan_mcp-0.0.1/minimax_coding_plan_mcp.egg-info/PKG-INFO ADDED
@@ -0,0 +1,202 @@
1
+ Metadata-Version: 2.4
2
+ Name: minimax-coding-plan-mcp
3
+ Version: 0.0.1
4
+ Summary: Specialized MiniMax Model Context Protocol (MCP) server designed for coding-plan users
5
+ Author-email: Roy Wu <zhengyu@minimax.chat>
6
+ License: MIT License
7
+
8
+ Copyright 2025 MiniMax AI.
9
+
10
+ Permission is hereby granted, free of charge, to any person obtaining a copy
11
+ of this software and associated documentation files (the "Software"), to deal
12
+ in the Software without restriction, including without limitation the rights
13
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
14
+ copies of the Software, and to permit persons to whom the Software is
15
+ furnished to do so, subject to the following conditions:
16
+
17
+ The above copyright notice and this permission notice shall be included in all
18
+ copies or substantial portions of the Software.
19
+
20
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
21
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
22
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
23
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
24
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
25
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
26
+ SOFTWARE.
27
+
28
+ Keywords: minimax,mcp,coding-plan-search,coding-plan-vlm
29
+ Classifier: Development Status :: 4 - Beta
30
+ Classifier: Intended Audience :: Developers
31
+ Classifier: License :: OSI Approved :: MIT License
32
+ Classifier: Programming Language :: Python :: 3
33
+ Classifier: Programming Language :: Python :: 3.10
34
+ Requires-Python: >=3.10
35
+ Description-Content-Type: text/markdown
36
+ License-File: LICENSE
37
+ Requires-Dist: mcp[cli]>=1.6.0
38
+ Requires-Dist: fastapi>=0.109.2
39
+ Requires-Dist: uvicorn>=0.27.1
40
+ Requires-Dist: python-dotenv>=1.0.1
41
+ Requires-Dist: pydantic>=2.6.1
42
+ Requires-Dist: httpx>=0.28.1
43
+ Requires-Dist: fuzzywuzzy>=0.18.0
44
+ Requires-Dist: python-Levenshtein>=0.25.0
45
+ Requires-Dist: sounddevice>=0.5.1
46
+ Requires-Dist: soundfile>=0.13.1
47
+ Requires-Dist: requests>=2.31.0
48
+ Provides-Extra: dev
49
+ Requires-Dist: pre-commit>=3.6.2; extra == "dev"
50
+ Requires-Dist: ruff>=0.3.0; extra == "dev"
51
+ Requires-Dist: fastmcp>=0.4.1; extra == "dev"
52
+ Requires-Dist: pytest>=8.0.0; extra == "dev"
53
+ Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
54
+ Requires-Dist: twine>=6.1.0; extra == "dev"
55
+ Requires-Dist: build>=1.0.3; extra == "dev"
56
+ Dynamic: license-file
57
+
58
+ ![export](https://github.com/MiniMax-AI/MiniMax-01/raw/main/figures/MiniMaxLogo-Light.png)
59
+
60
+ <div align="center" style="line-height: 1;">
61
+ <a href="https://www.minimax.io" target="_blank" style="margin: 2px; color: var(--fgColor-default);">
62
+ <img alt="Homepage" src="https://img.shields.io/badge/_Homepage-MiniMax-FF4040?style=flat-square&labelColor=2C3E50&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgNDkwLjE2IDQxMS43Ij48ZGVmcz48c3R5bGU+LmNscy0xe2ZpbGw6I2ZmZjt9PC9zdHlsZT48L2RlZnM+PHBhdGggY2xhc3M9ImNscy0xIiBkPSJNMjMzLjQ1LDQwLjgxYTE3LjU1LDE3LjU1LDAsMSwwLTM1LjEsMFYzMzEuNTZhNDAuODIsNDAuODIsMCwwLDEtODEuNjMsMFYxNDVhMTcuNTUsMTcuNTUsMCwxLDAtMzUuMDksMHY3OS4wNmE0MC44Miw0MC44MiwwLDAsMS04MS42MywwVjE5NS40MmExMS42MywxMS42MywwLDAsMSwyMy4yNiwwdjI4LjY2YTE3LjU1LDE3LjU1LDAsMCwwLDM1LjEsMFYxNDVBNDAuODIsNDAuODIsMCwwLDEsMTQwLDE0NVYzMzEuNTZhMTcuNTUsMTcuNTUsMCwwLDAsMzUuMSwwVjIxNy41aDBWNDAuODFhNDAuODEsNDAuODEsMCwxLDEsODEuNjIsMFYyODEuNTZhMTEuNjMsMTEuNjMsMCwxLDEtMjMuMjYsMFptMjE1LjksNjMuNEE0MC44Niw0MC44NiwwLDAsMCw0MDguNTMsMTQ1VjMwMC44NWExNy41NSwxNy41NSwwLDAsMS0zNS4wOSwwdi0yNjBhNDAuODIsNDAuODIsMCwwLDAtODEuNjMsMFYzNzAuODlhMTcuNTUsMTcuNTUsMCwwLDEtMzUuMSwwVjMzMGExMS42MywxMS42MywwLDEsMC0yMy4yNiwwdjQwLjg2YTQwLjgxLDQwLjgxLDAsMCwwLDgxLjYyLDBWNDAuODFhMTcuNTUsMTcuNTUsMCwwLDEsMzUuMSwwdjI2MGE0MC44Miw0MC44MiwwLDAsMCw4MS42MywwVjE0NWExNy41NSwxNy41NSwwLDEsMSwzNS4xLDBWMjgxLjU2YTExLjYzLDExLjYzLDAsMCwwLDIzLjI2LDBWMTQ1QTQwLjg1LDQwLjg1LDAsMCwwLDQ0OS4zNSwxMDQuMjFaIi8+PC9zdmc+&logoWidth=20" style="display: inline-block; vertical-align: middle;"/>
63
+ </a>
64
+ <a href="https://arxiv.org/abs/2501.08313" target="_blank" style="margin: 2px;">
65
+ <img alt="Paper" src="https://img.shields.io/badge/📖_Paper-MiniMax--01-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/>
66
+ </a>
67
+ <a href="https://chat.minimax.io/" target="_blank" style="margin: 2px;">
68
+ <img alt="Chat" src="https://img.shields.io/badge/_MiniMax_Chat-FF4040?style=flat-square&labelColor=2C3E50&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgNDkwLjE2IDQxMS43Ij48ZGVmcz48c3R5bGU+LmNscy0xe2ZpbGw6I2ZmZjt9PC9zdHlsZT48L2RlZnM+PHBhdGggY2xhc3M9ImNscy0xIiBkPSJNMjMzLjQ1LDQwLjgxYTE3LjU1LDE3LjU1LDAsMSwwLTM1LjEsMFYzMzEuNTZhNDAuODIsNDAuODIsMCwwLDEtODEuNjMsMFYxNDVhMTcuNTUsMTcuNTUsMCwxLDAtMzUuMDksMHY3OS4wNmE0MC44Miw0MC44MiwwLDAsMS04MS42MywwVjE5NS40MmExMS42MywxMS42MywwLDAsMSwyMy4yNiwwdjI4LjY2YTE3LjU1LDE3LjU1LDAsMCwwLDM1LjEsMFYxNDVBNDAuODIsNDAuODIsMCwwLDEsMTQwLDE0NVYzMzEuNTZhMTcuNTUsMTcuNTUsMCwwLDAsMzUuMSwwVjIxNy41aDBWNDAuODFhNDAuODEsNDAuODEsMCwxLDEsODEuNjIsMFYyODEuNTZhMTEuNjMsMTEuNjMsMCwxLDEtMjMuMjYsMFptMjE1LjksNjMuNEE0MC44Niw0MC44NiwwLDAsMCw0MDguNTMsMTQ1VjMwMC44NWExNy41NSwxNy41NSwwLDAsMS0zNS4wOSwwdi0yNjBhNDAuODIsNDAuODIsMCwwLDAtODEuNjMsMFYzNzAuODlhMTcuNTUsMTcuNTUsMCwwLDEtMzUuMSwwVjMzMGExMS42MywxMS42MywwLDEsMC0yMy4yNiwwdjQwLjg2YTQwLjgxLDQwLjgxLDAsMCwwLDgxLjYyLDBWNDAuODFhMTcuNTUsMTcuNTUsMCwwLDEsMzUuMSwwdjI2MGE0MC44Miw0MC44MiwwLDAsMCw4MS42MywwVjE0NWExNy41NSwxNy41NSwwLDEsMSwzNS4xLDBWMjgxLjU2YTExLjYzLDExLjYzLDAsMCwwLDIzLjI2LDBWMTQ1QTQwLjg1LDQwLjg1LDAsMCwwLDQ0OS4zNSwxMDQuMjFaIi8+PC9zdmc+&logoWidth=20" style="display: inline-block; vertical-align: middle;"/>
69
+ </a>
70
+ <a href="https://www.minimax.io/platform" style="margin: 2px;">
71
+ <img alt="API" src="https://img.shields.io/badge/⚡_API-Platform-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/>
72
+ </a>
73
+ </div>
74
+ <div align="center" style="line-height: 1;">
75
+ <a href="https://huggingface.co/MiniMaxAI" target="_blank" style="margin: 2px;">
76
+ <img alt="Hugging Face" src="https://img.shields.io/badge/🤗_Hugging_Face-MiniMax-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/>
77
+ </a>
78
+ <a href="https://github.com/MiniMax-AI/MiniMax-AI.github.io/blob/main/images/wechat-qrcode.jpeg" target="_blank" style="margin: 2px;">
79
+ <img alt="WeChat" src="https://img.shields.io/badge/_WeChat-MiniMax-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/>
80
+ </a>
81
+ <a href="https://www.modelscope.cn/organization/MiniMax" target="_blank" style="margin: 2px;">
82
+ <img alt="ModelScope" src="https://img.shields.io/badge/_ModelScope-MiniMax-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/>
83
+ </a>
84
+ </div>
85
+ <div align="center" style="line-height: 1;">
86
+ <a href="https://github.com/MiniMax-AI/MiniMax-MCP/blob/main/LICENSE" style="margin: 2px;">
87
+ <img alt="Code License" src="https://img.shields.io/badge/_Code_License-MIT-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/>
88
+ </a>
89
+ </div>
90
+
91
+ <p align="center">
92
+ Specialized MiniMax Model Context Protocol (MCP) server designed for <b>coding-plan</b> users, featuring AI-powered search and vision analysis APIs optimized for code development workflows. Unlike the standard <a href="https://github.com/MiniMax-AI/MiniMax-MCP">MiniMax-MCP</a>, this version provides coding-specific tools (for examples: <code>coding_plan_search</code> and <code>coding_plan_vlm</code>) that integrate seamlessly with MCP clients like <a href="https://www.anthropic.com/claude">Claude Desktop</a>, <a href="https://www.cursor.so">Cursor</a>, <a href="https://codeium.com/windsurf">Windsurf</a>, <a href="https://github.com/openai/openai-agents-python">OpenAI Agents</a> and others to enhance your coding experience.
93
+ </p>
94
+
95
+ ## Documentation
96
+ - [中文文档](README-CN.md)
97
+
98
+
99
+ ## Quickstart with MCP Client
100
+ 1. Get your API key from [MiniMax](https://www.minimax.io/platform/user-center/basic-information/interface-key).
101
+ 2. Install `uv` (Python package manager), install with `curl -LsSf https://astral.sh/uv/install.sh | sh` or see the `uv` [repo](https://github.com/astral-sh/uv) for additional install methods.
102
+ 3. **Important**: The API host and key vary by region and must match; otherwise, you'll encounter an `Invalid API key` error.
103
+
104
+ |Region| Global | Mainland |
105
+ |:--|:-----|:-----|
106
+ |MINIMAX_API_KEY| go get from [MiniMax Global](https://www.minimax.io/platform/user-center/basic-information/interface-key) | go get from [MiniMax](https://platform.minimaxi.com/user-center/basic-information/interface-key) |
107
+ |MINIMAX_API_HOST| https://api.minimax.io | https://api.minimaxi.com |
108
+
109
+
110
+ ### Claude Desktop
111
+ Go to `Claude > Settings > Developer > Edit Config > claude_desktop_config.json` to include the following:
112
+
113
+ ```
114
+ {
115
+ "mcpServers": {
116
+ "MiniMax": {
117
+ "command": "uvx",
118
+ "args": [
119
+ "minimax-coding-plan-mcp",
120
+ "-y"
121
+ ],
122
+ "env": {
123
+ "MINIMAX_API_KEY": "insert-your-api-key-here",
124
+ "MINIMAX_MCP_BASE_PATH": "local-output-dir-path, such as /User/xxx/Desktop",
125
+ "MINIMAX_API_HOST": "api host, https://api.minimax.io | https://api.minimaxi.com",
126
+ "MINIMAX_API_RESOURCE_MODE": "optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format"
127
+ }
128
+ }
129
+ }
130
+ }
131
+
132
+ ```
133
+ ⚠️ Warning: The API key needs to match the host. If an error "API Error: invalid api key" occurs, please check your api host:
134
+ - Global Host：`https://api.minimax.io`
135
+ - Mainland Host：`https://api.minimaxi.com`
136
+
137
+ If you're using Windows, you will have to enable "Developer Mode" in Claude Desktop to use the MCP server. Click "Help" in the hamburger menu in the top left and select "Enable Developer Mode".
138
+
139
+
140
+ ### Cursor
141
+ Go to `Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server` to add above config.
142
+
143
+ That's it. Your MCP client can now interact with MiniMax through these tools:
144
+
145
+ ## Transport
146
+ We support two transport types: stdio and sse.
147
+ | stdio | SSE |
148
+ |:-----|:-----|
149
+ | Run locally | Can be deployed locally or in the cloud |
150
+ | Communication through `stdout` | Communication through `network` |
151
+ | Input: Supports processing `local files` or valid `URL` resources | Input: When deployed in the cloud, it is recommended to use `URL` for input |
152
+
153
+ ## Available Tools
154
+ | tool | description |
155
+ |-|-|
156
+ |`coding_plan_search`|Performs web searches and returns organic search results along with related search queries|
157
+ |`coding_plan_vlm`|Analyzes images with AI based on text prompts, extracts information and answers questions about images|
158
+
159
+ ## Release Notes
160
+
161
+ ### November 20, 2025
162
+
163
+ #### 🆕 What's New
164
+ - **Web Search**: New `coding_plan_search` tool - perform web searches and get organic results with related search queries
165
+ - **Vision Language Model**: New `coding_plan_vlm` tool - analyze images using AI based on text prompts
166
+
167
+ #### 📈 Features
168
+ - `coding_plan_search` - Search the web and get structured results including titles, links, snippets, and related searches
169
+ - `coding_plan_vlm` - Analyze images from URLs or local files, supporting JPEG, PNG, GIF, and WebP formats
170
+
171
+ ## FAQ
172
+ ### 1. invalid api key
173
+ Please ensure your API key and API host are regionally aligned
174
+ |Region| Global | Mainland |
175
+ |:--|:-----|:-----|
176
+ |MINIMAX_API_KEY| go get from [MiniMax Global](https://www.minimax.io/platform/user-center/basic-information/interface-key) | go get from [MiniMax](https://platform.minimaxi.com/user-center/basic-information/interface-key) |
177
+ |MINIMAX_API_HOST| https://api.minimax.io | https://api.minimaxi.com |
178
+
179
+ ### 2. spawn uvx ENOENT
180
+ Please confirm its absolute path by running this command in your terminal:
181
+ ```sh
182
+ which uvx
183
+ ```
184
+ Once you obtain the absolute path (e.g., /usr/local/bin/uvx), update your configuration to use that path (e.g., "command": "/usr/local/bin/uvx").
185
+
186
+
187
+
188
+ ## Example usage
189
+
190
+ ⚠️ Warning: Using these tools may incur costs.
191
+
192
+ ### 1. Web Search
193
+ Use the `coding_plan_search` tool to search for information on the web:
194
+
195
+ <img src="https://cdn.hailuoai.video/moss/prod/2025-11-20-15/user/multi_chat_file/99ff15e3-e5d6-48e2-8216-38c6abf03c71.image/png" style="display:
196
+ inline-block; vertical-align: middle; "/>
197
+
198
+ ### 2. Image Analysis
199
+ Use the `coding_plan_vlm` tool to analyze images with AI:
200
+
201
+ <img src="https://cdn.hailuoai.video/moss/prod/2025-11-20-15/user/multi_chat_file/1f8174a2-68d5-4576-b886-86933eab5280.image/png" style="display:
202
+ inline-block; vertical-align: middle; "/>
minimax_coding_plan_mcp-0.0.1/minimax_coding_plan_mcp.egg-info/SOURCES.txt ADDED
@@ -0,0 +1,18 @@
1
+ LICENSE
2
+ README.md
3
+ pyproject.toml
4
+ setup.py
5
+ minimax_coding_plan_mcp.egg-info/PKG-INFO
6
+ minimax_coding_plan_mcp.egg-info/SOURCES.txt
7
+ minimax_coding_plan_mcp.egg-info/dependency_links.txt
8
+ minimax_coding_plan_mcp.egg-info/entry_points.txt
9
+ minimax_coding_plan_mcp.egg-info/requires.txt
10
+ minimax_coding_plan_mcp.egg-info/top_level.txt
11
+ minimax_mcp/__init__.py
12
+ minimax_mcp/__main__.py
13
+ minimax_mcp/client.py
14
+ minimax_mcp/const.py
15
+ minimax_mcp/exceptions.py
16
+ minimax_mcp/server.py
17
+ minimax_mcp/utils.py
18
+ tests/test_utils.py
minimax_coding_plan_mcp-0.0.1/minimax_coding_plan_mcp.egg-info/entry_points.txt ADDED
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ minimax-coding-plan-mcp = minimax_mcp.server:main
minimax_coding_plan_mcp-0.0.1/minimax_coding_plan_mcp.egg-info/requires.txt ADDED
@@ -0,0 +1,20 @@
1
+ mcp[cli]>=1.6.0
2
+ fastapi>=0.109.2
3
+ uvicorn>=0.27.1
4
+ python-dotenv>=1.0.1
5
+ pydantic>=2.6.1
6
+ httpx>=0.28.1
7
+ fuzzywuzzy>=0.18.0
8
+ python-Levenshtein>=0.25.0
9
+ sounddevice>=0.5.1
10
+ soundfile>=0.13.1
11
+ requests>=2.31.0
12
+
13
+ [dev]
14
+ pre-commit>=3.6.2
15
+ ruff>=0.3.0
16
+ fastmcp>=0.4.1
17
+ pytest>=8.0.0
18
+ pytest-cov>=4.1.0
19
+ twine>=6.1.0
20
+ build>=1.0.3
minimax_coding_plan_mcp-0.0.1/minimax_mcp/__init__.py ADDED
@@ -0,0 +1,3 @@
1
+ """Minimax Coding Plan MCP Server package."""
2
+
3
+ __version__ = "0.0.1"