diff --git a/docs/DEVELOPMENT_GUIDE.md b/docs/DEVELOPMENT_GUIDE.md index 968aff9f..65bd599e 100644 --- a/docs/DEVELOPMENT_GUIDE.md +++ b/docs/DEVELOPMENT_GUIDE.md @@ -10,6 +10,8 @@ - [2.2 Integrated MCP Tools](#22-integrated-mcp-tools) - [Memory - Knowledge Graph Memory System](#memory---knowledge-graph-memory-system) - [MiniMax Search - Web Search and Browse](#minimax-search---web-search-and-browse) + - [Token Plan MCP - Helping developers quickly access information and understand image content during coding](#token-plan-mcp---helping-developers-quickly-access-information-and-understand-image-content-during-coding) + - [MiniMax MCP - Supporting multimodal capabilities such as text-to-speech (TTS), voice cloning, image generation, and video generation](#minimax-mcp---supporting-multimodal-capabilities-such-as-text-to-speech-tts-voice-cloning-image-generation-and-video-generation) - [3. Extended Abilities](#3-extended-abilities) - [3.1 Adding Custom Tools](#31-adding-custom-tools) - [Steps](#steps) @@ -108,6 +110,71 @@ This project comes with pre-configured MCP (Model Context Protocol) tools that e } ``` +--- + +#### [Token Plan MCP - Helping developers quickly access information and understand image content during coding](https://platform.minimax.io/docs/guides/token-plan-mcp-guide) + +**Function**: Provides ten powerful tools: +- `web_search` - Performs web searches based on search queries, returning search results and related suggestions. +- `understand_image` - Performs image understanding and analysis, supporting multiple image input methods. + +**Status**: Disabled by default, needs configuration to enable + +**Configuration Example** + +```json +{ + "mcpServers": { + "minimax-coding-plan-mcp": { + "disabled": false, + "env": { + "MINIMAX_API_KEY": "Enter your API key", + "MINIMAX_MCP_BASE_PATH": "Local output directory path, ensure the path exists and is writable", + "MINIMAX_API_HOST": "https://api.minimax.io", + "MINIMAX_API_RESOURCE_MODE": "Optional. Resource delivery method: url or local, default url" + } + } + } +} +``` + +--- + +#### [MiniMax MCP - Supporting multimodal capabilities such as text-to-speech (TTS), voice cloning, image generation, and video generation](https://platform.minimax.io/docs/guides/mcp-guide) + +**Function**: Provides ten powerful tools: +- `text_to_audio` - This tool converts the text to natural and fluent speech. +- `list_voices` - This tool lists all available voices. +- `voice_clone` - This tool clones a voice from a specified audio file. +- `voice_design` - This tool generates a voice and preview audio from a prompt. +- `play_audio` - This tool plays an audio file. +- `music_generation` - This tool generates music from a prompt and lyrics. +- `generate_video` - Generates a video based on a prompt. At least one of `prompt` or `first_frame_image` in the parameters is required. +- `image_to_video` - Generates a video from a first-frame image. At least one of `prompt` or `first_frame_image` in the parameters is required. Only available in the **JavaScript/TypeScript** MCP version. +- `query_video_generation` - Queries the status of an asynchronous video generation task. +- `text_to_image` - Generates images from a text prompt. + +**Status**: Disabled by default, needs configuration to enable + +**Configuration Example** + +```json +{ + "mcpServers": { + "minimax-mcp": { + "disabled": false, + "env": { + "MINIMAX_API_KEY": "Enter your API key", + "MINIMAX_MCP_BASE_PATH": "Local output directory path, e.g., /User/xxx/Desktop", + "MINIMAX_API_HOST": "https://api.minimax.io", + "MINIMAX_API_RESOURCE_MODE": "Optional. Specifies how generated resources are exposed. Options: [url | local]. Default: url" + }, + "transport": "Optional: transport mode. Options: [studio|SSE], default: studio" + } + } +} +``` + ## 3. Extended Abilities ### 3.1 Adding Custom Tools diff --git a/docs/DEVELOPMENT_GUIDE_CN.md b/docs/DEVELOPMENT_GUIDE_CN.md index 13702d3e..3b99a2e8 100644 --- a/docs/DEVELOPMENT_GUIDE_CN.md +++ b/docs/DEVELOPMENT_GUIDE_CN.md @@ -11,6 +11,8 @@ - [2.2 已集成的 MCP 工具](#22-已集成的-mcp-工具) - [Memory - 知识图谱记忆系统](#memory---知识图谱记忆系统) - [MiniMax Search - 网页搜索与浏览](#minimax-search---网页搜索与浏览) + - [Token Plan MCP - 网页搜索与图片理解和分析](#token-plan-mcp---网页搜索与图片理解和分析) + - [MiniMax MCP - 语音合成、音色克隆、图像与视频生成等多模态能力](#minimax-mcp---语音合成音色克隆图像与视频生成等多模态能力) - [3. 扩展能力](#3-扩展能力) - [3.1 添加自定义工具](#31-添加自定义工具) - [步骤](#步骤) @@ -109,6 +111,71 @@ mini-agent/ } ``` +--- + +#### [Token Plan MCP - 网页搜索与图片理解和分析](https://platform.minimaxi.com/docs/guides/token-plan-mcp-guide#web-search) + +**功能**：提供两大强大工具： +- `web_search` - 根据搜索查询词进行网络搜索，返回搜索结果和相关搜索建议。 +- `understand_image` - 对图片进行理解和分析，支持多种图片输入方式。 + +**状态**：默认禁用，需要配置 API Key 后方可启用。 + +**配置示例**： + +```json +{ + "mcpServers": { + "MiniMax": { + "disabled": false, + "env": { + "MINIMAX_API_KEY": "填写你的API密钥", + "MINIMAX_MCP_BASE_PATH": "本地输出目录路径，需保证路径存在且有写入权限", + "MINIMAX_API_HOST": "https://api.minimaxi.com", + "MINIMAX_API_RESOURCE_MODE": "可选，资源提供方式：url 或 local，默认 url" + } + } + } +} +``` + +--- + +#### [MiniMax MCP - 语音合成、音色克隆、图像与视频生成等多模态能力](https://platform.minimaxi.com/docs/guides/mcp-guide) + +**功能**：提供十大强大工具： +- `text_to_audio` - 该工具可将将输入的文本合成为自然流畅的语音 +- `list_voices` - 该工具可查询所有可用音色 +- `voice_clone` - 该工具可根据指定音频文件克隆音色 +- `voice_design` - 该工具可根据指定提示词生成音色和试听文本 +- `play_audio` - 该工具用于播放一个音频文件 +- `music_generation` - 该工具可根据指定提示词和歌词生成音乐 +- `generate_video` - 该工具可根据指定文本或图片进行视频生成生成 +- `image_to_video` - 该工具用于使用首帧图像生成视频 +- `query_video_generation` - 该工具用于查询异步视频生成任务的状态 +- `text_to_image` - 该工具可根据指定提示词生成图片 + +**状态**：默认禁用，需要配置 API Key 后方可启用。 + +**配置示例**： + +```json +{ + "mcpServers": { + "MiniMax": { + "disabled": false, + "env": { + "MINIMAX_API_KEY": "填写你的API密钥", + "MINIMAX_MCP_BASE_PATH": "本地输出目录路径，如/User/xxx/Desktop", + "MINIMAX_API_HOST": "填写API Host, https://api.minimaxi.com 或 https://api.minimax.io", + "MINIMAX_API_RESOURCE_MODE": "可选配置，资源生成后的提供方式, 可选项为 [url|local], 默认为 url" + }, + "transport": "可选配置，传输方式，可选项为 [studio|SSE]，默认为 studio" + } + } +} +``` + ## 3. 扩展能力 ### 3.1 添加自定义工具 diff --git a/mini_agent/config/mcp-example.json b/mini_agent/config/mcp-example.json index 4147b554..ab99fa5d 100644 --- a/mini_agent/config/mcp-example.json +++ b/mini_agent/config/mcp-example.json @@ -24,6 +24,29 @@ "@modelcontextprotocol/server-memory" ], "disabled": true + }, + "minimax-coding-plan-mcp": { + "command": "uvx", + "args": ["minimax-coding-plan-mcp"], + "env": { + "MINIMAX_API_KEY": "", + "MINIMAX_MCP_BASE_PATH": "", + "MINIMAX_API_HOST": "API Host, https://api.minimaxi.com or https://api.minimax.io", + "MINIMAX_API_RESOURCE_MODE": "<[Optional] Resource access mode after generation: url or local, Default: url>" + }, + "disabled": true + }, + "minimax-mcp": { + "command": "uvx", + "args": ["minimax-mcp"], + "env": { + "MINIMAX_API_KEY": "", + "MINIMAX_MCP_BASE_PATH": "", + "MINIMAX_API_HOST": "API Host, https://api.minimaxi.com or https://api.minimax.io", + "MINIMAX_API_RESOURCE_MODE": "<[Optional] Resource access mode after generation: url or local, Default: url>" + }, + "transport": "<[Optional] Transport method: studio or SSE, Default: studio>", + "disabled": true } } } \ No newline at end of file