版本0.1.0 用于AI图像生成和文档自动化的MCP服务器
与Obsidian Smart Composer集成 生成纳米香蕉(Nano Banana)风格的AI图像提供, Skywork MCP服务器集成了通过的文档生成功能的一体化工具包。
______________________________________________________________________
主要功能
1.创建AI图像(generate_image)
- 应用纳米香蕉风格:自动将15种视觉样式模式应用于提示
- 谷歌图像4.0-FAST:使用最新的高质量图像创建模型
- Obsidian联动:根据注释内容,LLM推荐适当的样式来创建图像
2.浏览样式(list_styles)
- 查看所有可用的视觉样式和关键字
3.生成Skywork文档(集成Proxy)
gen_doc:创建/编辑Word文档gen_excel:创建Excel电子表格gen_ppt:创建PowerPoint演示文稿gen_ppt_fast:快速生成PPT
4.Skywork设置助手(get_skywork_config)
- 自动生成Skywork MCP Server的验证URL
- 代替MD5签名计算,提供立即可用的JSON设置
______________________________________________________________________
可用样式(15种)
| 样式名 | 说明 | 关键字 |
|---|---|---|
| Corporate Memphis | 现代科技企业风格 | Corporate Memphis,3D Render,Confetti |
| Flat Corporate | 商务演示平台设计 | Flat illustration,Corporate,Memphis |
| Isometric Infographic | 用于数据可视化的3D信息图 | Infographic、Isometric、Colorful |
Minimal Line Art简约优雅的黑白绘图Minimal,Monochrome,Line Art | Doodle Notebook |手绘休闲风格| Doodle、Notebook、Blue Ink | Clay3D |可爱的粘土造型风格| Clay,Stopmotion,Cute | | Watercolor Map |水彩画绘画风格| Watercolor,Map,Fantasy | | Pixel Art |怀旧游戏美学| Pixel Art,Retro Game,8-bit | | Glassmorphism |半透明现代UI趋势| Glassmorphism,Dark,Blur Cyberpunk未来霓虹灯高科技Cyberpunk,Blue,Circuit Synthwave 80年代复古未来Synthwave,Sunset,Retro Grid | Paper Cutout |有图层和阴影的剪纸| Paper Cutout,Layered,Shadow | Ukiyo-e Pop日本复古流行艺术Ukiyo-e,City Pop,Halftone Low Poly几何3D抽象Low Poly,3D,Geometric Abstract Fluid流体渐变抽象Abstract,Fluid,Gradient
______________________________________________________________________
项目结构
Smart_Visual_Toolkit_MCP/
├── src/
│ ├── generators/
│ │ └── image_gen.py # 이미지 생성 로직 (Imagen 4.0 API)
│ ├── resources/
│ │ └── banana_styles.json # 나노바나나 스타일 템플릿 DB
│ └── main.py # MCP 서버 엔트리포인트 (Tools 정의)
├── output/
│ └── images/ # 생성된 이미지 저장 폴더
├── .env # 환경 변수 (API 키)
├── pyproject.toml # 프로젝트 설정 및 의존성
└── README.md # 문서______________________________________________________________________
如何安装和运行
安装
要求
- Python 3.10+
- uv(建议)或pip
安装方法
# 저장소 클론
git clone https://github.com/hyoseop1231/Smart_Visual_Toolkit_MCP.git
cd Smart_Visual_Toolkit_MCP
# uv를 사용한 설치 (권장)
uv sync
# 또는 pip 사용
pip install -e .API密钥设置
在项目根目录中 .env 创建文件并添加以下内容:
# Google Gemini API Key (이미지 생성용 - 필수)
GOOGLE_API_KEY=your_google_api_key_here
# Skywork 자격증명 (문서 생성용 - 선택)
SKYWORK_SECRET_ID=your_skywork_secret_id
SKYWORK_SECRET_KEY=your_skywork_secret_key执行
# MCP 서버 실행
uv run src/main.py______________________________________________________________________
MCP客户端设置
黑曜石智能作曲器
mcpServers 添加到设置:
{
"mcpServers": {
"smart-visual-toolkit": {
"command": "uv",
"args": ["run", "/path/to/Smart_Visual_Toolkit_MCP/src/main.py"]
}
}
}光标IDE
- 设置 > 模型 > 主控程序 移动
- 添加新的MCP服务器 单击
- 设置:
- 名字:智能可视化工具包 - 类型标准: stdio - 命令: uv run /path/to/Smart_Visual_Toolkit_MCP/src/main.py
______________________________________________________________________
使用示例
创建图像
"이 노트의 내용을 요약해서 'Clay 3D' 스타일로 귀여운 이미지를 만들어줘."
"Cyberpunk 스타일로 미래 도시 이미지 생성해줘."查看样式
"사용 가능한 이미지 스타일 목록 보여줘."创建文档(Skywork集成)
"이 노트를 바탕으로 발표 자료(PPT)를 만들어줘."
"프로젝트 보고서를 Word 문서로 만들어줘."创建Skywork设置
"내 SecretID는 foo, Key는 bar야. Skywork 설정 좀 만들어줘."______________________________________________________________________
技术堆栈
- 语言:Python 3.10+
- 框架:模型上下文协议(MCP)SDK
- 创建图像:谷歌图像4.0-FAST(
google-genai) - 创建文档:Skywork AI API(集成Proxy)
- 依赖性:
mcp,requests,python-dotenv,httpx,google-genai
______________________________________________________________________
许可证
MIT许可证
______________________________________________________________________
贡献
错误报告和功能建议 问题请在注册。
