jimeng-ai-mcp

# jimeng-mcp **即梦 AI 的 MCP 服务** — 让 Claude、Cursor 等 AI 助手直接调用即梦的图片/视频生成能力。 [English](README_EN.md) | 中文 --- ## 这是什么 [MCP（Model Context Protocol）](https://modelcontextprotocol.io/) 是 Anthropic 推出的开放协议，允许 AI 模型通过标准化接口调用外部工具和服务。 **jimeng-mcp** 将字节跳动旗下[即梦 AI](https://jimeng.jianying.com/) 的官方 Volcengine API 封装为 MCP 服务。接入后，你可以在 Claude、Cursor 等支持 MCP 的客户端里，用自然语言直接驱动即梦生成图片和视频——无需打开浏览器，无需手动上传，生成结果自动保存到本地。 ## 能做什么 ### 图片能力 | 工具 | 能力 | 底层模型 | |---|---|---| | `generate_image` | 文生图，支持 4.0 / 4.6 / 3.x 多模型 | 即梦图片系列 | | `image_to_image` | 图生图，智能参考原图风格/内容进行编辑 | jimeng_i2i 3.0 | | `inpaint_image` | 局部重绘：涂抹修改或消除画面元素 | inpaint | | `upscale_image` | 智能超清：低清图片放大到 4K / 8K | Seedream SR | ### 视频能力 | 工具 | 能力 | 底层模型 | |---|---|---| | `generate_video` | 文生视频，720P / 1080P / Pro 三档 | 即梦视频 3.0 | | `image_to_video` | 图生视频：首帧、首尾帧、重新运镜、Pro 模式 | 即梦视频 3.0 | | `imitate_motion` | 动作模仿：将参考视频的动作迁移到目标人物 | DreamActor 2.0 | | `generate_digital_human` | 数字人：图片 + 音频 → 口型同步说话视频 | OmniHuman 1.5 | | `translate_video` | 视频翻译：保留音色，口型同步换语言 | 翻译 2.0 | ## 使用场景 - **内容创作者**：对话式生成配图和视频素材，不切换工具 - **产品/设计**：在 Cursor 里边改需求文档边生成原型图 - **营销团队**：批量生成不同风格的创意图，描述即出图 - **开发者**：在自己的 AI 应用中集成即梦能力，无需关心鉴权细节 ## 快速上手 ### 第一步：开通服务 1. 登录[火山引擎控制台](https://console.volcengine.com/ai/ability/detail/2)，开通**即梦 AI** 服务 2. 在[访问控制 → API 访问密钥](https://console.volcengine.com/iam/keymanage/)获取 Access Key ID 和 Secret Access Key ### 第二步：安装 推荐使用 `uvx`（无需手动安装，运行时自动拉取）： ```bash uvx jimeng-ai-mcp ``` 也可以用 pip 全局安装： ```bash pip install jimeng-ai-mcp ``` ### 第三步：配置 MCP 客户端 #### Claude Desktop 配置文件路径： - **macOS**：`~/Library/Application Support/Claude/claude_desktop_config.json` - **Windows**：`%APPDATA%\Claude\claude_desktop_config.json` ```json { "mcpServers": { "jimeng": { "command": "uvx", "args": ["jimeng-ai-mcp"], "env": { "JIMENG_ACCESS_KEY_ID": "填入你的 Access Key ID", "JIMENG_SECRET_ACCESS_KEY": "填入你的 Secret Access Key" } } } } ``` #### Cursor 配置文件路径：`~/.cursor/mcp.json` `…