mcp-seedream

# MCP Doubao 图像生成器 (MCP Doubao Image Generator) [English](README.md) | [中文](README-CN.md) 一个 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 服务器，赋予 AI 助手使用豆包 Seedream 从文本提示生成图像的能力。 ## ✨ 功能特性 - **豆包 Seedream 集成**：使用豆包 Seedream API 从文本描述生成图像 - **多参数支持**：支持尺寸、样式、质量和数量选项 - **专用提供商**：专为豆包 Seedream 服务设计 - **跨平台**：完美支持 Windows、Linux 和 macOS - **易于集成**：为 MCP 客户端提供简单配置 ## 🚀 安装 ### 使用 uvx (推荐) ```bash uvx mcp-seedream@latest ``` ### 使用 pip ```bash pip install mcp-seedream@latest ``` ### 从源码安装 ```bash git clone https://github.com/aardpro/mcp-seedream.git cd mcp-seedream pip install -e . ``` ## ⚙️ 配置 ### 配置 #### 环境变量配置 在使用 MCP 服务器之前，您需要设置 `ARK_API_KEY` 环境变量。以下是不同操作系统的设置方法： #### Windows (命令提示符) ```cmd set ARK_API_KEY=your-api-key-here ``` #### Windows (PowerShell) ```powershell $env:ARK_API_KEY="your-api-key-here" ``` #### Linux/macOS (Bash/Zsh) ```bash export ARK_API_KEY="your-api-key-here" ``` #### 永久设置 (Linux/macOS) 将以下行添加到您的 `~/.bashrc` 或 `~/.zshrc` 文件中： ```bash export ARK_API_KEY="your-api-key-here" ``` #### 永久设置 (Windows) 在 Windows 系统中，您可以通过以下方式永久设置环境变量： 1. 打开“系统属性”对话框 (右键点击“此电脑” -> “属性”) 2. 点击“高级系统设置” 3. 点击“环境变量” 4. 在“用户变量”部分点击“新建” 5. 变量名：`ARK_API_KEY`，变量值：您的 API 密钥 #### 配置文件 服务器会从内部配置文件加载默认设置。如果需要自定义配置，请按照MCP客户端配置指南进行环境变量设置。 ### MCP 客户端配置 将以下内容添加到你的 MCP 客户端配置中（例如 Claude Desktop, Cursor）： #### 选项 1: 使用 uvx ```json { "mcpServers": { "McpSeedream": { "command": "uvx", "args": ["mcp-seedream"] } } } ``` #### 选项 2: 使用 pip ```json { "mcpServers": { "McpSeedream": { "command": "mcp-seedream" } } } ``` #### 选项 3: Windows 系统 ```json { "mcpServers": { "McpSeedream": { "command": "cmd", "args": [ "/c", "chcp 65001 >nul && uvx mcp-seedream" ] } } } ``` #### 选项 4: Linux/macOS： ```json { "mcpServers": { "McpSeedream": { "command": "python", "args": ["-m", "main"] } } } ``` ## 🛠️ 可用工具 ### `generate_image` 使用配置的 API 从文本提…