MCP-сервер Jimeng

Сервер Model Context Protocol (MCP) для Jimeng AI — предоставляет мощные возможности генерации изображений и видео через Claude и другие LLM-приложения

О проекте

MCP-сервер Jimeng — это профессиональный MCP-сервер для генерации изображений и видео с помощью ИИ, построенный на основе开源-проекта jimeng-free-api-all. Он предоставляет мощные возможности AI-творчества через MCP-клиенты, такие как Claude Desktop, Cherry Studio и Claude Code.

Основные зависимости

Проект построен на основе开源-проекта jimeng-free-api-all, который реализует реверс-инжиниринг API Jimeng AI и поддерживает генерацию изображений по тексту, генерацию видео из изображений и другие возможности AI-генерации.

Ключевые возможности

• Генерация изображений по тексту: использование Jimeng 4.5 для создания высококачественных изображений по текстовому описанию

• Композиция изображений: интеллектуальное слияние нескольких изображений на основе текстовых инструкций

• Генерация видео по тексту: создание коротких видеоклипов по текстовому описанию с помощью Jimeng Video 3.0

• Генерация видео из изображений: добавление анимации к статичным изображениям

• Поддержка протокола MCP: стандартный протокол MCP, поддержка нескольких режимов связи

• Совместимость с несколькими клиентами: поддержка Claude Desktop, Cherry Studio, Claude Code и других

Related MCP server: Jimeng MCP Server

Журнал обновлений

v0.2.0 (2024-12-14) — синхронизация формата параметров

• Синхронизация с обновлением upstream v4.7: адаптация к новейшему формату параметров API jimeng-free-api-all

• Изменения параметров API изображений:

  • Удалены параметры width, height

  • Добавлен параметр ratio: поддерживаются 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9

  • Добавлен параметр resolution: поддерживаются 1k, 2k (по умолчанию), 4k

• Изменения параметров API видео:

  • Удалены параметры width, height

  • Добавлен параметр ratio: поддерживаются 1:1 (по умолчанию), 4:3, 3:4, 16:9, 9:16

  • Параметр resolution: поддерживаются 480p, 720p (по умолчанию), 1080p

  • Добавлен параметр duration: длительность видео, 5 или 10 секунд

• Обновление модели по умолчанию: модель изображений по умолчанию обновлена с jimeng-4.0 до jimeng-4.5

Список функций

Техническая архитектура

Описание архитектуры

┌─────────────────────────────────────────────────┐
│            Claude Desktop / MCP Client           │
└────────────────────┬────────────────────────────┘
                     │ MCP Protocol
                     ↓
┌─────────────────────────────────────────────────┐
│          jimengmcp (本 MCP 服务器)               │
│    ┌──────────────────────────────────────┐     │
│    │  MCP Protocol Handler (stdio/sse)   │     │
│    └───────────────┬──────────────────────┘     │
│                    ↓                             │
│    ┌──────────────────────────────────────┐     │
│    │     Tool Implementations             │     │
│    │  - text_to_image                     │     │
│    │  - image_composition                 │     │
│    │  - text_to_video                     │     │
│    │  - image_to_video                    │     │
│    └───────────────┬──────────────────────┘     │
└────────────────────┼────────────────────────────┘
                     │ HTTP API Calls
                     ↓
┌─────────────────────────────────────────────────┐
│       jimeng-free-api-all 逆向接口服务            │
│  (https://github.com/wwwzhouhui/                │
│         jimeng-free-api-all)                    │
│    ┌──────────────────────────────────────┐     │
│    │    OpenAI Compatible API Endpoints   │     │
│    │  - POST /v1/images/generations       │     │
│    │  - POST /v1/images/compositions      │     │
│    │  - POST /v1/videos/generations       │     │
│    └───────────────┬──────────────────────┘     │
└────────────────────┼────────────────────────────┘
                     │ 逆向调用
                     ↓
┌─────────────────────────────────────────────────┐
│           即梦 AI 官方服务                        │
│       (https://jimeng.duckcloud.fun)            │
└─────────────────────────────────────────────────┘

Инструкция по установке

Требования к окружению

• Python 3.10+

• Развёрнутый сервис jimeng-free-api-all

• Получение SessionID API Jimeng с duckcloud.fun

Шаг 1: Развёртывание сервиса jimeng-free-api-all

Для работы этого MCP-сервера необходимо сначала развернуть базовый API-сервис.

Способ 1: Развёртывание через Docker (рекомендуется)

# 拉取镜像
docker pull wwwzhouhui569/jimeng-free-api-all:latest

# 运行容器
docker run -it -d --init --name jimeng-free-api-all \
  -p 8001:8000 \
  -e TZ=Asia/Shanghai \
  wwwzhouhui569/jimeng-free-api-all:latest

Способ 2: Развёртывание из исходного кода

# 克隆 jimeng-free-api-all 项目
git clone https://github.com/wwwzhouhui/jimeng-free-api-all.git
cd jimeng-free-api-all

# 使用 Docker Compose 启动
docker-compose up -d

Получение SessionID:

1. Перейдите на официальный сайт Jimeng и войдите в систему

2. Нажмите F12, чтобы открыть инструменты разработчика браузера

3. Перейдите в раздел Application > Cookies

4. Найдите и скопируйте значение sessionid

5. Используйте в последующей настройке: Authorization: Bearer [your_sessionid]

Проверка развёртывания:

# 测试 API 是否正常运行
curl http://localhost:8001/v1/models

Шаг 2: Установка MCP-сервера jimengmcp

# 克隆此仓库
git clone https://github.com/wwwzhouhui/jimeng-mcp-server
cd jimeng-mcp-server

Базовая установка (режим stdio)

pip install -e .

Режим SSE

pip install -e ".[sse]"

Режим HTTP

pip install -e ".[http]"

Полная установка (все режимы)

pip install -e ".[all]"

Настройка переменных окружения

cp .env.example .env

Отредактируйте файл .env:

# 必需: 您的即梦 SessionID (从浏览器 Cookie 中获取)
JIMENG_API_KEY=your_sessionid_here

# 必需: jimeng-free-api-all 服务地址
JIMENG_API_URL=http://localhost:8001

# 可选: 默认使用的模型
JIMENG_MODEL=jimeng-4.5

Инструкция по использованию

Настройка Claude Code

Настройка с помощью cc-switch:

После завершения настройки нажмите «Сохранить».

Просмотр с помощью mcp list:

Использование в Claude Code

Пример генерации изображения по тексту:

请使用jimeng-mcp-server 生成一张图像:小猪和小狗踢球

Пример композиции изображений:

请使用jimeng-mcp-server 将这两张图像合成在一起:
- 图像1: https://p3-dreamina-sign.byteimg.com/tos-cn-i-tb4s082cfz/bab623359bd9410da0c1f07897b16fec~tplv-tb4s082cfz-resize:0:0.image
- 图像2: https://p3-dreamina-sign.byteimg.com/tos-cn-i-tb4s082cfz/6acf16d07c47413898aea2bdd1ad339e~tplv-tb4s082cfz-resize:0:0.image
创建一个艺术风格的无缝融合

Пример генерации видео по тексту:

请使用jimeng-mcp-server 创建一个视频:小马过河

Режимы работы

Этот MCP-сервер поддерживает три режима связи:

1. Режим stdio (по умолчанию)

Режим stdio осуществляет связь через стандартный ввод/вывод и подходит для интеграции с MCP-клиентами, такими как Claude Desktop.

python -m jimeng_mcp.server
# 或
python -m jimeng_mcp.server --mode stdio

2. Режим SSE (Server-Sent Events)

Режим SSE предоставляет поток событий на основе HTTP и подходит для интеграции с веб-приложениями.

python -m jimeng_mcp.server --mode sse --host 0.0.0.0 --port 8000

Конечная точка подключения: http://localhost:8000/sse

3. Режим HTTP REST API

Режим HTTP предоставляет стандартный интерфейс RESTful API и подходит для вызова из различных языков программирования.

python -m jimeng_mcp.server --mode http --host 0.0.0.0 --port 8000

Доступные конечные точки:

• GET /health — проверка работоспособности

• GET /tools — получение списка доступных инструментов

• POST /text-to-image — генерация изображения по тексту

• POST /image-composition — композиция изображений

• POST /text-to-video — генерация видео по тексту

• POST /image-to-video — генерация видео из изображения

Описание конфигурации

Настройка переменных окружения

Настройка Cherry Studio

Добавьте этот сервер в файл конфигурации Cherry Studio:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "jimeng": {
      "command": "python",
      "args": ["-m", "jimeng_mcp.server"],
      "env": {
        "JIMENG_API_KEY": "您的API密钥"
      }
    }
  }
}

Настройка SSE:

Параметры инструментов API

text_to_image (генерация изображения по тексту)

image_composition (композиция изображений)

text_to_video (генерация видео по тексту)

image_to_video (генерация видео из изображения)

Руководство для разработчиков

Запуск тестов

pytest

Непосредственный запуск сервера

python -m jimeng_mcp.server

Часто задаваемые вопросы

О: Убедитесь, что JIMENG_API_KEY в файле .env задан правильно, проверьте, действителен ли ваш ключ API и достаточно ли у него квоты.

О: Проверьте сетевое подключение, убедитесь, что базовый URL API доступен, проверьте наличие ограничений брандмауэра.

О: Генерация видео может занять несколько минут. Сервер автоматически устанавливает длительный тайм-аут (10 минут) для видеоопераций. Рассмотрите возможность генерации более коротких видео или более низкого разрешения.

О: Убедитесь, что Docker установлен и запущен, проверьте, не занят ли порт 8001, просмотрите журналы контейнера для устранения неполадок.

О: Убедитесь, что файл .env настроен правильно, используйте команду mcp list для проверки состояния MCP-сервера, подтвердите, что переменные окружения загружены корректно.

Группа технического общения

Присоединяйтесь к группе технического общения, делитесь своим опытом использования и отзывами:

Контакты автора

• WeChat: laohaibao2025

• Электронная почта: 75271002@qq.com

Пожертвования

Если этот проект оказался для вас полезным, вы можете угостить меня чашечкой кофе ☕

WeChat Pay

Star History

Если проект вам понравился, поставьте звёздочку ⭐

Лицензия

Лицензия MIT

Отказ от ответственности

Данный проект предназначен исключительно для обучения и исследований и построен на основе проекта jimeng-free-api-all.

Важные замечания:

• ⚠️ В данном проекте используется реверс-инжиниринг API, только для личного обучения и исследований

• ⚠️ Запрещается использовать данный проект в коммерческих целях или предоставлять его как внешний сервис

• ⚠️ Реверс-инжиниринг API может перестать работать после обновлений официального сервиса, следите за обновлениями проекта

• ⚠️ При использовании соблюдайте условия обслуживания и ограничения официального сервиса Jimeng AI

• ⚠️ Для производственного развёртывания рекомендуется использовать официальный API

Связанные проекты

Данный проект зависит от следующих开源-проектов и выражает им благодарность:

Основные зависимости

• jimeng-free-api-all — реализация реверс-инжиниринга API Jimeng AI

  • Предоставляет полный API для генерации изображений и видео

  • Интерфейс, совместимый с OpenAI

  • Поддержка однокомандного развёртывания через Docker

  • Лицензия: GPL-3.0

Технологические фреймворки

• Model Context Protocol (MCP) — единый стандарт протокола инструментов AI

• Python MCP SDK — реализация MCP на Python

• Jimeng AI — базовый сервис AI-генерации

Особая благодарность

• wwwzhouhui — автор проекта jimeng-free-api-all, предоставил стабильный и надёжный реверс-инжиниринг API Jimeng AI

• Anthropic — разработали мощный Claude AI и протокол MCP

• Команда Jimeng AI — предоставили отличные возможности генерации изображений и видео