modelscope·@joeseesun/Seedream_MCP
暂无描述。
基于火山引擎 Seedream 4.0 API 的 MCPModel Context Protocol工具集提供文生图图生图多图融合和组图生成等功能
致谢: 本项目基于 tengmmvp/Seedream_MCP 进行增强开发感谢原作者的贡献
增强功能:
- 七牛云自动上传和公网访问
- 提示词模板系统 (8个预设模板)
- Raycast AI Markdown 图片渲染支持
- 优化的图片保存和管理
git clone <repository-url>
cd Seedream_MCP
pip install -e .
创建 .env 文件
# 必需配置
ARK_API_KEY=your_api_key_here
# 可选配置
ARK_BASE_URL=https://ark.cn-beijing.volces.com/api/v3
SEEDREAM_MODEL_ID=doubao-seedream-4-0-250828
SEEDREAM_DEFAULT_SIZE=2K
SEEDREAM_DEFAULT_WATERMARK=false
SEEDREAM_TIMEOUT=60
SEEDREAM_API_TIMEOUT=60
SEEDREAM_MAX_RETRIES=3
LOG_LEVEL=INFO
LOG_FILE=logs/seedream_mcp.log
# 自动保存配置
SEEDREAM_AUTO_SAVE_ENABLED=true
SEEDREAM_AUTO_SAVE_BASE_DIR=./seedream_images
SEEDREAM_AUTO_SAVE_DOWNLOAD_TIMEOUT=30
SEEDREAM_AUTO_SAVE_MAX_RETRIES=3
SEEDREAM_AUTO_SAVE_MAX_FILE_SIZE=52428800
SEEDREAM_AUTO_SAVE_MAX_CONCURRENT=5
SEEDREAM_AUTO_SAVE_DATE_FOLDER=true
SEEDREAM_AUTO_SAVE_CLEANUP_DAYS=30
# 七牛云配置可选用于上传图片到七牛云存储
QINIU_ACCESS_KEY=your_access_key
QINIU_SECRET_KEY=your_secret_key
QINIU_BUCKET_NAME=your_bucket_name
QINIU_DOMAIN=https://your-domain.com
注意: 配置七牛云后,生成的图片会自动上传到七牛云,并在返回结果中提供公网可访问的 Markdown 图片链接详见 七牛云集成文档
在你的 MCP 客户端配置文件中添加以下配置:
Raycast AI / Claude Desktop / Cline 等:
{
"mcpServers": {
"seedream": {
"command": "python",
"args": [
"/你的路径/Seedream_MCP/main.py"
],
"env": {
"ARK_BASE_URL": "https://ark.cn-beijing.volces.com/api/v3"
}
}
}
}
配置文件位置:
~/Library/Application Support/com.raycast.macos/mcp.json~/Library/Application Support/Claude/claude_desktop_config.json.vscode/settings.json 或用户设置重要提示:
/你的路径/Seedream_MCP/main.py 替换为你的实际项目路径配置好 MCP 客户端后,你可以直接用自然语言对话生成图片:
你说:
帮我生成一张图片一只可爱的小恐龙友好的表情卡通风格
AI 回复:
图片生成成功
seedream_images/2025-11-18/text_to_image/...你说:
潮流派对关键词可口可乐
AI 回复:
图片生成成功
你说:
公众号封面主题AI 技术革新
AI 回复:
图片生成成功
直接说出模板名称 + 关键词即可:
| 模板名称 | 使用方式 | 适用场景 |
|---|---|---|
| 潮流派对 | "潮流派对关键词XXX" | 运营活动艺术字体 |
| 公众号封面 | "公众号封面主题XXX" | 公众号配图 (21:9) |
| 国潮风格 | "国潮风格主题XXX" | 中国风设计 |
| 小清新 | "小清新主题XXX" | 文艺清新风格 |
| 赛博朋克 | "赛博朋克主题XXX" | 科技未来风格 |
| 新年喜庆 | "新年喜庆主题XXX" | 节日庆典 |
| 商务简约 | "商务简约主题XXX" | 商务场景 |
| 水彩插画 | "水彩插画主题XXX" | 手绘插画风格 |
python -m seedream_mcp.server
import asyncio
from seedream_mcp import SeedreamClient, SeedreamConfig
async def main():
# 加载配置
config = SeedreamConfig.from_env()
# 创建客户端
client = SeedreamClient(config)
try:
# 文生图启用自动保存
result = await client.text_to_image(
prompt="一只可爱的小猫咪卡通风格",
size="2K",
watermark=False,
auto_save=True,
custom_name="cute_cat"
)
print(f"生成的图像URL: {result['image_url']}")
print(f"本地保存路径: {result['local_path']}")
print(f"Markdown引用: {result['markdown']}")
# 图生图
result = await client.image_to_image(
prompt="将这张图片转换为油画风格",
image="path/to/image.jpg",
size="2K",
auto_save=True
)
print(f"转换后的图像URL: {result['image_url']}")
print(f"本地保存路径: {result['local_path']}")
finally:
await client.close()
if __name__ == "__main__":
asyncio.run(main())
内置 8 个专业提示词模板,只需说出模板名称 + 关键词即可生成对应风格的图片:
配置七牛云后,生成的图片会自动上传到七牛云存储:
根据文本描述生成图像
参数
prompt (必需): 文本描述建议不超过 300 汉字或 600 英文单词size (可选): 图像尺寸可选值1K2K4K默认 2Kwatermark (可选): 是否添加水印默认 falseresponse_format (可选): 响应格式可选值imageurlb64_json默认 imageauto_save (可选): 是否自动保存图片到本地默认使用全局配置save_path (可选): 自定义保存路径不指定则使用默认路径custom_name (可选): 自定义文件名前缀自然语言示例
帮我生成一张图片一只可爱的小猫咪卡通风格
或使用提示词模板:
潮流派对关键词可口可乐
基于参考图像和文本指令生成新图像
参数
prompt (必需): 图像编辑指令image (必需): 参考图像 UR…ModelContextProtocol服务器适用于Magic UI，它通过提供诸如跑马灯、动画、特效和互动背景等组件的代码，使AI助手能够轻松为Web应用程序实现UI组件。
一个提供网页开发工具的MCP服务器，例如屏幕捕捉功能，可以让AI代理获取并处理用户屏幕的截图。
一个由人工智能驱动的工具，可以从自然语言描述生成现代UI组件，并与流行的IDE集成，以简化UI开发工作流程。
通过模型上下文协议（MCP）将Blender连接到Claude AI，使Claude能够直接与Blender交互并对其进行控制，从而实现AI辅助的3D建模、场景操作和渲染。
集成了Dify AI API，为Ant Design组件提供代码生成服务，支持文本和图像输入，并具备流式处理能力。
一种模型上下文协议服务器，提供创建、管理和导出Excalidraw绘图的API功能，支持SVG、PNG和JSON等多种格式。