Merge pull request #13 from MiniMax-AI/dev/format_code

feat: format dependencies and tool desc

Author: Maosghoul

mcp_server_config_demo.json

@@ -6,7 +6,7 @@
           "minimax-coding-plan-mcp"
         ],
         "env": {
-          "MINIMAX_API_KEY": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWUsImlhdCI6MTc0NTM3NjU1N30.nrmwo6orXJfyf63IqJCK4LiUXrq9r9ZELCY530Mu6sLyx_qNAVsJ3Q828Rqy6pwoQl6VFMMFaJG3kc6aIMEfVLo7xlB-4NbwMxYKhwtxyQL8g_agYqw-1aY4zr3uvgTZxafXt1dEjcuS5i9O9SuOXXofeqb0jAnb_dssaLfgHNKlKthJpjsg8G76ZULS7KCpm6GvPWR4mwIdH-i0IhBU6CVSWpBAYKVNHJ-FVN_HzN5UgGvHkDbOOggg6Ib1illYbx6zkb7_JYZ7Tek1erjvJi7IG8Keh4NHq5kcyROWBetO9W8_2if_nfO6XBhlJRECpEmYBONwroGw0nH6xNblQw",
+          "MINIMAX_API_KEY": "sk-cp-test123",
           "MINIMAX_API_HOST": "https://api.minimax.chat"
         }
       }

minimax_mcp/server.py

@@ -40,16 +40,18 @@
 @mcp.tool(
     description="""
     
-    Web Search API, works like Google Search.
+    You MUST use this tool whenever you need to search for real-time or external information on the web.
+    
+    A web search API that works just like Google Search.
     
     Args:
-        query (str): The search query string. Use 3-5 keywords. Add the current date for time-sensitive queries, e.g. `latest iPhone 2025`
+        query (str): The search query. Aim for 3-5 keywords for best results. For time-sensitive topics, include the current date (e.g. `latest iPhone 2025`).
         
     Search Strategy:
-        - If no valid results found, try changing search keywords
+        - If no useful results are returned, try rephrasing your query with different keywords.
         
     Returns:
-        Text content with search results in JSON format. The response structure is:
+        A JSON object containing the search results, structured as follows:
         {
             "organic": [
                 {
@@ -102,26 +104,28 @@ def web_search(
 @mcp.tool(
     description="""
     
-    A powerful LLM that can analyze and understand image content from files or URLs, follow your instruction.
-    Use this tool to understand images by LLM.
-    Only support jpeg, png, webp formats. Other formats like pdf/gif/psd/svg and so on are not supported.
+    You MUST use this tool whenever you need to analyze, describe, or extract information from an image,
+    including when you get an image from user input or any task-related image.
+
+    An LLM-powered vision tool that can analyze and interpret image content from local files or URLs based on your instructions.
+    Only JPEG, PNG, and WebP formats are supported. Other formats (e.g. PDF, GIF, PSD, SVG) are not supported.
 
     Args:
-        prompt (str): The text prompt describing what you want to analyze or extract from the image.
-        image_source (str): The source location of the image to analyze.
+        prompt (str): A text prompt describing what you want to analyze or extract from the image.
+        image_source (str): The location of the image to analyze.
             Accepts:
             - HTTP/HTTPS URL: "https://example.com/image.jpg"
             - Local file path:
                 - Relative path: "images/photo.png"
                 - Absolute path: "/Users/username/Documents/image.jpg"
-            IMPORTANT: If the file path starts with @ symbol, you MUST remove the @ prefix before passing to this function.
+            IMPORTANT: If the file path starts with an @ symbol, you MUST strip the @ prefix before passing it to this function.
             For example:
-                - If you see "@Documents/photo.jpg", use "Documents/photo.jpg"
-                - If you see "@/Users/username/image.png", use "/Users/username/image.png"
+                - "@Documents/photo.jpg" → "Documents/photo.jpg"
+                - "@/Users/username/image.png" → "/Users/username/image.png"
             Supported formats: JPEG, PNG, WebP
         
     Returns:
-        Text content with the image analysis result.
+        A text description of the image analysis result.
     """
 )
 def understand_image(

minimax_mcp/utils.py

@@ -2,7 +2,7 @@
 import base64
 import requests
 from minimax_mcp.const import *
-from minimax_mcp.exceptions import MinimaxMcpError, MinimaxRequestError
+from minimax_mcp.exceptions import  MinimaxRequestError
 
 
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "minimax-coding-plan-mcp"
-version = "0.0.3"
+version = "0.0.4"
 description = "Specialized MiniMax Model Context Protocol (MCP) server designed for coding-plan users"
 authors = [
     { name = "Roy Wu", email = "zhengyu@minimax.chat" },
@@ -23,15 +23,7 @@ keywords = [
 requires-python = ">=3.10"
 dependencies = [
     "mcp[cli]>=1.6.0",
-    "fastapi>=0.109.2",
-    "uvicorn>=0.27.1",
     "python-dotenv>=1.0.1",
-    "pydantic>=2.6.1",
-    "httpx>=0.28.1",
-    "fuzzywuzzy>=0.18.0",
-    "python-Levenshtein>=0.25.0",
-    "sounddevice>=0.5.1",
-    "soundfile>=0.13.1",
     "requests>=2.31.0",
 ]
 

scripts/dev.sh

@@ -1,2 +1,2 @@
 #!/bin/bash
-uv run fastmcp dev minimax_mcp/server.py --with python-dotenv --with fuzzywuzzy --with python-Levenshtein --with sounddevice --with soundfile --with-editable .
+uv run --extra dev fastmcp dev minimax_mcp/server.py