seedream-image-mcp 1.2.7__tar.gz

seedream_image_mcp-1.2.7/.gitignore

@@ -0,0 +1,234 @@
+# ================================
+# Python 相关文件
+# ================================
+
+# 字节码编译文件
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C 扩展文件
+*.so
+
+# 分发和打包相关
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller 相关
+*.manifest
+*.spec
+
+# 安装日志
+pip-log.txt
+pip-delete-this-directory.txt
+
+# ================================
+# 测试和覆盖率相关
+# ================================
+
+# 单元测试和覆盖率报告
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# ================================
+# 框架相关文件
+# ================================
+
+# Django 相关
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask 相关
+instance/
+.webassets-cache
+
+# Scrapy 相关
+.scrapy
+
+# Sphinx 文档
+docs/_build/
+
+# PyBuilder
+target/
+
+# ================================
+# Jupyter 和 IPython
+# ================================
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# ================================
+# 环境管理
+# ================================
+
+# pyenv
+.python-version
+
+# pipenv
+#Pipfile.lock
+
+# poetry
+#poetry.lock
+
+# pdm
+#pdm.lock
+.pdm.toml
+
+# PEP 582
+__pypackages__/
+
+# uv
+.uv/
+
+# Celery 相关
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath 解析文件
+*.sage.py
+
+# 虚拟环境
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# ================================
+# 开发工具配置
+# ================================
+
+# Spyder 项目设置
+.spyderproject
+.spyproject
+
+# Rope 项目设置
+.ropeproject
+
+# mkdocs 文档
+/site
+
+# mypy 类型检查
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre 类型检查
+.pyre/
+
+# ================================
+# IDE 和编辑器
+# ================================
+
+# Visual Studio Code
+.vscode/
+
+# PyCharm
+.idea/
+
+# Vim/Emacs
+*.swp
+*.swo
+*~
+
+# Trae AI IDE
+.trae/
+
+# ================================
+# 操作系统相关
+# ================================
+
+# macOS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+
+# Windows
+ehthumbs.db
+Thumbs.db
+
+# ================================
+# 项目特定文件
+# ================================
+
+# 日志文件
+logs/
+*.log
+
+# 临时文件
+tmp/
+temp/
+.tmp/
+
+# 生成的图片和输出
+images/
+seedream_images/
+
+# 项目构建产物
+seedream_mcp.egg-info/
+dist/
+
+# 代理/说明文件
+.codex/
+.claude/
+AGENTS.md
+CLAUDE.md
+
+# ================================
+# 本地配置文件
+# ================================
+
+# 本地配置
+config.local.py
+settings.local.py
+
+# ================================
+# 可选忽略项（根据需要取消注释）
+# ================================
+
+# 测试文件输出
+# test_*.py
+
+# 演示脚本输出
+# demo_*.py
+
+# 验证脚本输出
+# verify_*.py

seedream_image_mcp-1.2.7/LICENSE

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2026 TengMMVP
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

seedream_image_mcp-1.2.7/PKG-INFO

@@ -0,0 +1,385 @@
+Metadata-Version: 2.4
+Name: seedream-image-mcp
+Version: 1.2.7
+Summary: 基于火山引擎 Seedream API 的 MCP 工具，支持 AI 图像生成功能
+Project-URL: Homepage, https://github.com/tengmmvp/Seedream_MCP
+Project-URL: Documentation, https://github.com/tengmmvp/Seedream_MCP#readme
+Project-URL: Repository, https://github.com/tengmmvp/Seedream_MCP.git
+Project-URL: Bug Tracker, https://github.com/tengmmvp/Seedream_MCP/issues
+Author-email: TengMMVP <tengmmvp@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: ai,image-generation,mcp,seedream,stable-diffusion,volcengine
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: aiofiles>=23.0.0
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: httpx>=0.26.0
+Requires-Dist: loguru>=0.7.0
+Requires-Dist: mcp<2.0.0,>=1.26.0
+Requires-Dist: pillow>=10.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: typing-extensions>=4.0.0
+Description-Content-Type: text/markdown
+
+<h1 align="center">Seedream 4.0、4.5 和 5.0 MCP 生图工具</h1>
+
+<div align="center">
+  <a href="https://zread.ai/tengmmvp/Seedream_MCP">
+    <img src="https://img.shields.io/badge/Ask_Zread-_.svg?style=for-the-badge&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff" alt="Ask Zread"/>
+  </a>
+  <br>
+  <img src="https://img.shields.io/github/v/release/tengmmvp/Seedream_MCP?display_name=tag&sort=semver&label=Release" alt="Version"/>
+  <img src="https://img.shields.io/pypi/v/seedream-image-mcp?label=PyPI" alt="PyPI"/>
+  <img src="https://img.shields.io/badge/Python-3.10+-cyan.svg" alt="Python"/>
+  <img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License"/>
+  <img src="https://img.shields.io/badge/Powered_By-Codex%26GLM-violet.svg" alt="Powered by Codex&GLM"/>
+  <br><br>
+  <img src="https://raw.githubusercontent.com/tengmmvp/img2code/main/img/doubao-seedream-5-0.jpeg" alt="Seedream MCP" width="450"/>
+  <br><br>
+  <b>基于火山引擎 Seedream 4.0、4.5 和 5.0 API 的 MCP 工具，支持 AI 图像生成。</b>
+</div>
+
+## ⚡ 快速安装
+
+### 1. 前置准备
+
+安装 [uv](https://docs.astral.sh/uv/)（包含 `uvx` 命令）：
+
+```bash
+# macOS / Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows (PowerShell)
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+在[火山引擎控制台](https://console.volcengine.com/)获取 API 密钥，通过环境变量 `ARK_API_KEY` 提供。
+
+### 2. 一键启动
+
+```bash
+# 通过环境变量提供密钥（推荐）
+ARK_API_KEY=your_api_key_here uvx seedream-image-mcp
+
+# 也可显式指定模型、尺寸等运行参数
+ARK_API_KEY=your_api_key_here uvx seedream-image-mcp --model doubao-seedream-5.0 --default-size 2K
+```
+
+`uvx` 自动从 [PyPI](https://pypi.org/project/seedream-image-mcp/) 拉取最新版本并在隔离环境运行——无需 clone 仓库、无需手动创建虚拟环境、无需安装依赖。
+
+### 3. 可选：Docker Compose
+
+```bash
+# 下载 docker-compose.yml
+curl -O https://raw.githubusercontent.com/tengmmvp/Seedream_MCP/main/docker-compose.yml
+
+# 启动服务
+ARK_API_KEY=your_api_key_here docker-compose up -d
+```
+
+## 🔧 客户端配置
+
+> 推荐通过 `env` 注入 `ARK_API_KEY`，避免把密钥写进 `args`（命令行参数会出现在进程列表中，存在泄露风险）。
+
+### Claude Desktop
+
+编辑 `claude_desktop_config.json`：
+
+```json
+{
+  "mcpServers": {
+    "seedream": {
+      "command": "uvx",
+      "args": ["seedream-image-mcp"],
+      "env": { "ARK_API_KEY": "your_api_key_here" }
+    }
+  }
+}
+```
+
+### Claude Code（命令行一键注册）
+
+```bash
+claude mcp add seedream --env ARK_API_KEY=your_api_key_here -- uvx seedream-image-mcp
+```
+
+### Cursor
+
+在项目根目录创建 `.cursor/mcp.json`：
+
+```json
+{
+  "mcpServers": {
+    "seedream": {
+      "command": "uvx",
+      "args": ["seedream-image-mcp"],
+      "env": { "ARK_API_KEY": "your_api_key_here" }
+    }
+  }
+}
+```
+
+### Cline / 其他 stdio 客户端
+
+通用配置（`command` + `args` + `env` 字段同上）。Cline 编辑 `cline_mcp_settings.json`：
+
+```json
+{
+  "mcpServers": {
+    "seedream": {
+      "command": "uvx",
+      "args": ["seedream-image-mcp"],
+      "env": { "ARK_API_KEY": "your_api_key_here" }
+    }
+  }
+}
+```
+
+> 需要指定模型/尺寸时，追加到 `args`，例如 `["seedream-image-mcp", "--model", "doubao-seedream-5.0"]`。
+
+配置后重启对应客户端即可使用。
+
+## ⚙️ 启动参数
+
+```bash
+--api-key TEXT                                     # API 密钥（可选，推荐用环境变量 ARK_API_KEY）
+--model [doubao-seedream-5.0|doubao-seedream-5.0-lite|doubao-seedream-4.5|doubao-seedream-4.0]
+                                                 # 模型选择 (默认: doubao-seedream-5.0)
+--default-size [1K|2K|3K|4K|<宽>x<高>]            # 图像尺寸 (默认: 2K，需与模型兼容)
+--watermark                                        # 启用水印
+--log-level [DEBUG|INFO|WARNING|ERROR]             # 日志级别
+--transport [stdio|sse|streamable-http]            # MCP 传输方式 (默认: stdio)
+--mount-path TEXT                                  # SSE 挂载路径（仅 transport=sse 生效）
+--config-file TEXT                                 # 自定义 .env 配置文件路径
+```
+
+### 使用示例
+
+```bash
+# 基础使用
+ARK_API_KEY=your_key uvx seedream-image-mcp
+
+# 使用自定义配置文件
+ARK_API_KEY=your_key uvx seedream-image-mcp --config-file ./my-config.env
+
+# 使用 Seedream 4.0 模型
+ARK_API_KEY=your_key uvx seedream-image-mcp --model doubao-seedream-4.0
+
+# 高质量图像 + 调试模式
+ARK_API_KEY=your_key uvx seedream-image-mcp --model doubao-seedream-4.5 --default-size 4K --log-level DEBUG
+```
+
+## 🎨 功能特性
+
+- **文生图**：文本生成图像
+- **图文生图**：图像转换风格
+- **多图融合**：融合多张图片
+- **组图输出**：生成图像序列
+- **图片浏览**：本地图片文件浏览
+
+## 🛠️ 可用工具
+
+### 1. `seedream_text_to_image` - 文生图
+
+根据文本提示词生成图像
+
+**参数：**
+
+- `prompt` (必需) - 图像生成的文本提示词，建议不超过 300 个汉字或 600 个英文单词
+- `optimize_prompt_options` (可选) - 提示词优化选项，支持 mode: "standard" 或 "fast"
+- `size` (可选) - 图像尺寸：`1K`、`2K`、`3K`、`4K` 或 `<宽>x<高>` 像素值，默认使用配置文件值，需与所选模型兼容
+- `watermark` (可选) - 是否添加水印，默认使用配置文件值（默认 false）
+- `response_format` (可选) - 响应格式：`url`或`b64_json`，默认`url`
+- `output_format` (可选) - 输出文件格式，仅 `doubao-seedream-5.0` 支持 `jpeg` 或 `png`
+- `stream` (可选) - 是否启用流式输出，默认`false`
+- `tools` (可选) - 模型工具配置，仅 `doubao-seedream-5.0` 支持，例如 `[{"type":"web_search"}]`
+- `request_count` (可选) - 并行请求次数，范围 1-4，默认 1
+- `parallelism` (可选) - 并行度上限，范围 1-4，默认 `min(request_count, 4)`
+- `auto_save` (可选) - 是否自动保存到本地，默认使用全局配置（默认 true）
+- `save_path` (可选) - 自定义保存目录路径
+- `custom_name` (可选) - 自定义文件名前缀
+
+### 2. `seedream_image_to_image` - 图文生图
+
+根据输入图像和文本提示生成新图像
+
+**参数：**
+
+- `prompt` (必需) - 图像修改要求或风格转换指令，建议不超过 300 个汉字或 600 个英文单词
+- `optimize_prompt_options` (可选) - 提示词优化选项，支持 mode: "standard" 或 "fast"
+- `image` (必需) - 输入图像的 URL 或本地文件路径
+- `size` (可选) - 图像尺寸：`1K`、`2K`、`3K`、`4K` 或 `<宽>x<高>` 像素值，默认使用配置文件值，需与所选模型兼容
+- `watermark` (可选) - 是否添加水印，默认使用配置文件值（默认 false）
+- `response_format` (可选) - 响应格式：`url`或`b64_json`，默认`url`
+- `output_format` (可选) - 输出文件格式，仅 `doubao-seedream-5.0` 支持 `jpeg` 或 `png`
+- `stream` (可选) - 是否启用流式输出，默认`false`
+- `tools` (可选) - 模型工具配置，仅 `doubao-seedream-5.0` 支持，例如 `[{"type":"web_search"}]`
+- `request_count` (可选) - 并行请求次数，范围 1-4，默认 1
+- `parallelism` (可选) - 并行度上限，范围 1-4，默认 `min(request_count, 4)`
+- `auto_save` (可选) - 是否自动保存到本地，默认使用全局配置（默认 true）
+- `save_path` (可选) - 自定义保存目录路径
+- `custom_name` (可选) - 自定义文件名前缀
+
+### 3. `seedream_multi_image_fusion` - 多图融合
+
+将多张图像融合生成新图像
+
+**参数：**
+
+- `prompt` (必需) - 图像融合要求或风格指令，建议不超过 300 个汉字或 600 个英文单词
+- `optimize_prompt_options` (可选) - 提示词优化选项，支持 mode: "standard" 或 "fast"
+- `image` (必需) - 输入图像 URL 或本地文件路径列表（2-14 张图像）
+- `size` (可选) - 图像尺寸：`1K`、`2K`、`3K`、`4K` 或 `<宽>x<高>` 像素值，默认使用配置文件值，需与所选模型兼容
+- `watermark` (可选) - 是否添加水印，默认使用配置文件值（默认 false）
+- `response_format` (可选) - 响应格式：`url`或`b64_json`，默认`url`
+- `output_format` (可选) - 输出文件格式，仅 `doubao-seedream-5.0` 支持 `jpeg` 或 `png`
+- `stream` (可选) - 是否启用流式输出，默认`false`
+- `tools` (可选) - 模型工具配置，仅 `doubao-seedream-5.0` 支持，例如 `[{"type":"web_search"}]`
+- `request_count` (可选) - 并行请求次数，范围 1-4，默认 1
+- `parallelism` (可选) - 并行度上限，范围 1-4，默认 `min(request_count, 4)`
+- `auto_save` (可选) - 是否自动保存到本地，默认使用全局配置（默认 true）
+- `save_path` (可选) - 自定义保存目录路径
+- `custom_name` (可选) - 自定义文件名前缀
+
+### 4. `seedream_sequential_generation` - 组图输出
+
+连续生成多张图像，支持文生组图、单图生组图、多图生组图
+
+**参数：**
+
+- `prompt` (必需) - 图像生成的文本提示词，应明确指明生成数量和内容，建议不超过 300 个汉字或 600 个英文单词
+- `optimize_prompt_options` (可选) - 提示词优化选项，支持 mode: "standard" 或 "fast"
+- `image` (可选) - 参考图像，支持单张图片（字符串）或多张图片（数组）；参考图最多 14 张，且参考图数量与 max_images 之和不超过 15
+- `size` (可选) - 图像尺寸：`1K`、`2K`、`3K`、`4K` 或 `<宽>x<高>` 像素值，默认使用配置文件值，需与所选模型兼容
+- `watermark` (可选) - 是否添加水印，默认使用配置文件值（默认 false）
+- `max_images` (可选) - 最大生成图像数量，范围 1-15，默认 15
+- `response_format` (可选) - 响应格式：`url`或`b64_json`，默认`url`
+- `output_format` (可选) - 输出文件格式，仅 `doubao-seedream-5.0` 支持 `jpeg` 或 `png`
+- `stream` (可选) - 是否启用流式输出，默认`false`
+- `tools` (可选) - 模型工具配置，仅 `doubao-seedream-5.0` 支持，例如 `[{"type":"web_search"}]`
+- `request_count` (可选) - 并行请求次数，范围 1-4，默认 1
+- `parallelism` (可选) - 并行度上限，范围 1-4，默认 `min(request_count, 4)`
+- `auto_save` (可选) - 是否自动保存到本地，默认使用全局配置（默认 true）
+- `save_path` (可选) - 自定义保存目录路径
+- `custom_name` (可选) - 自定义文件名前缀
+
+### 5. `seedream_browse_images` - 图片浏览
+
+浏览工作区中的图片文件，获取文件路径用于图像生成
+
+**参数：**
+
+- `directory` (可选) - 要浏览的目录路径，默认当前目录
+- `recursive` (可选) - 是否递归搜索子目录，默认`true`
+- `max_depth` (可选) - 最大搜索深度，范围 1-10，默认 3
+- `limit` (可选) - 返回的最大文件数量，范围 1-200，默认 50
+- `format_filter` (可选) - 过滤特定图片格式，如`['.jpeg', '.png']`
+- `show_details` (可选) - 是否显示详细文件信息，默认`false`
+
+## 🆘 常见问题
+
+**Q: uvx 命令不存在？**
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+**Q: 如何获取 API 密钥？**
+访问 [火山引擎控制台](https://console.volcengine.com/) 创建密钥
+
+**Q: Docker 服务无法启动？**
+确保设置了环境变量：
+
+```bash
+# Linux/macOS
+export ARK_API_KEY=your_key
+docker-compose up -d
+
+# Windows
+$env:ARK_API_KEY="your_key"
+docker-compose up -d
+```
+
+## 🧪 本地开发
+
+```bash
+# 克隆仓库
+git clone https://github.com/tengmmvp/Seedream_MCP
+cd Seedream_MCP
+
+# 安装依赖（开发模式）
+uv sync --dev
+
+# 创建 .env 文件
+cp .env.example .env
+# 编辑 .env 文件，添加您的 API 密钥
+
+# 启动服务
+uv run python -m seedream_mcp.server
+
+# 或直接使用 API 密钥启动
+uv run python -m seedream_mcp.server --api-key your_key
+```
+
+## ⚙️ 环境变量配置
+
+主要配置项（详见 `.env.example`）：
+
+配置优先级：MCP 客户端显式配置（命令行参数） > 运行时系统环境变量 > `.env` 文件 > 默认值。
+
+`.env` 加载规则：
+
+- 使用 `--config-file` 时：仅加载指定文件。
+- 未指定 `--config-file` 时：按“项目根 `.env` -> 当前工作目录 `.env`”顺序合并，后者覆盖前者。
+- `.env` 会注入进程环境变量供运行时读取，但不会覆盖已存在的系统环境变量。
+
+```bash
+# 必需配置
+ARK_API_KEY=your_api_key_here
+
+# 模型配置
+SEEDREAM_MODEL_ID=doubao-seedream-5-0-260128
+
+# 默认值
+SEEDREAM_DEFAULT_SIZE=2K
+SEEDREAM_DEFAULT_WATERMARK=false
+
+# 自动保存
+SEEDREAM_AUTO_SAVE_ENABLED=true
+SEEDREAM_AUTO_SAVE_BASE_DIR=./seedream_images
+SEEDREAM_AUTO_SAVE_DATE_FOLDER=true
+SEEDREAM_AUTO_SAVE_CLEANUP_DAYS=30
+```
+
+## 👥 贡献者
+
+### 项目创建者
+
+- **[@tengmmvp](https://github.com/tengmmvp)** - 项目创建者
+
+### 重要贡献者
+
+- **[@caoergou](https://github.com/caoergou)** - 通过 [PR #2](https://github.com/tengmmvp/Seedream_MCP/pull/2) 贡献了 uvx 支持、Docker 容器化配置、GitHub Actions 自动化发布流程，极大简化了项目的安装与部署体验
+
+### 参与贡献
+
+欢迎提交 Issue 和 Pull Request！请查看 [GitHub Issues](https://github.com/tengmmvp/Seedream_MCP/issues) 了解当前的讨论和需求。
+
+**🌟 如果您希望参与开发，请先在 Issues 中讨论您的想法！**
+
+## 📄 许可证
+
+这个项目基于 MIT 许可证开源。更多信息请查看 [LICENSE](LICENSE) 文件。