즉멍(Jimeng) MCP 서버

즉멍 AI용 모델 컨텍스트 프로토콜(MCP) 서버 - Claude 및 기타 LLM 애플리케이션을 통해 강력한 이미지 및 비디오 생성 기능 제공

프로젝트 소개

즉멍 MCP 서버는 전문적인 AI 이미지 및 비디오 생성 MCP 서버로, jimeng-free-api-all 오픈소스 프로젝트를 기반으로 구축되었으며, Claude Desktop, Cherry Studio, Claude Code 등의 MCP 클라이언트를 통해 강력한 AI 창작 기능을 제공합니다.

핵심 의존성

본 프로젝트는 jimeng-free-api-all 오픈소스 프로젝트를 기반으로 구축되었으며, 해당 프로젝트는 즉멍 AI의 리버스 인터페이스 구현을 제공하여 텍스트-이미지 생성, 이미지-비디오 생성 등 다양한 AI 생성 기능을 지원합니다.

핵심 기능

• 텍스트-이미지 생성: 즉멍 4.5를 사용하여 텍스트 설명으로 고품질 이미지 생성

• 이미지 합성: 텍스트 명령을 기반으로 여러 이미지를 지능적으로 융합

• 텍스트-비디오 생성: 즉멍 비디오 3.0을 사용하여 텍스트 설명으로 짧은 비디오 클립 생성

• 이미지-비디오 생성: 정적 이미지에 애니메이션 효과 추가

• MCP 프로토콜 지원: 표준 MCP 프로토콜, 다양한 통신 모드 지원

• 다중 클라이언트 호환: Claude Desktop, Cherry Studio, Claude Code 등 지원

Related MCP server: Jimeng MCP Server

업데이트 로그

v0.2.0 (2024-12-14) - 파라미터 형식 동기화 업데이트

• 상위 v4.7 업데이트 동기화: jimeng-free-api-all 최신 API 파라미터 형식에 맞춤

• 이미지 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 서비스 배포

• duckcloud.fun에서 즉멍 API SessionID 획득

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. 즉멍 공식 사이트에 접속하여 로그인

2. F12를 눌러 브라우저 개발자 도구 열기

3. Application > Cookies로 이동

4. sessionid 값을 찾아 복사

5. 이후 구성에서 사용: Authorization: Bearer [your_sessionid]

배포 확인:

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

2단계: jimengmcp MCP 서버 설치

# 克隆此仓库
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 모드는 표준 입력/출력을 통해 통신하며, Claude Desktop 등의 MCP 클라이언트와의 통합에 적합합니다.

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

자주 묻는 질문

A: .env 파일의 JIMENG_API_KEY가 올바르게 설정되었는지 확인하고, API 키가 유효하며 충분한 할당량이 있는지 검증하세요.

A: 네트워크 연결을 확인하고, API 기본 URL에 접근 가능한지 검증하며, 방화벽 제한이 있는지 확인하세요.

A: 비디오 생성은 몇 분이 소요될 수 있습니다. 서버는 비디오 작업에 대해 자동으로 긴 타임아웃(10분)을 설정해 두었습니다. 더 짧은 비디오나 더 낮은 해상도 생성을 고려해 보세요.

A: Docker가 설치되어 실행 중인지 확인하고, 포트 8001이 점유되었는지 확인하며, 컨테이너 로그를 확인하여 문제를 해결하세요.

A: .env 파일이 올바르게 구성되었는지 확인하고, mcp list 명령으로 MCP 서버 상태를 확인하며, 환경 변수가 올바르게 로드되었는지 확인하세요.

기술 교류 그룹

기술 교류 그룹에 참여하여 사용 경험과 피드백을 공유해 주세요:

작성자 연락처

• 위챗: laohaibao2025

• 이메일: 75271002@qq.com

후원

이 프로젝트가 도움이 되셨다면, 커피 한 잔 사주시면 감사하겠습니다 ☕

위챗페이

Star History

프로젝트가 마음에 드신다면 Star ⭐를 눌러주세요

License

MIT License

면책 조항

본 프로젝트는 학습 및 연구 목적으로만 제공되며, jimeng-free-api-all 프로젝트를 기반으로 구축되었습니다.

중요 공지:

• ⚠️ 본 프로젝트는 리버스 인터페이스를 사용하며, 개인 학습 및 연구 목적으로만 사용할 수 있습니다

• ⚠️ 본 프로젝트를 상업적 용도로 사용하거나 외부에 서비스를 제공하는 것을 금지합니다

• ⚠️ 리버스 인터페이스는 공식 업데이트에 따라 작동하지 않을 수 있으므로 프로젝트 업데이트를 확인하세요

• ⚠️ 사용 시 즉멍 AI 공식 서비스 약관 및 사용 제한을 준수하세요

• ⚠️ 프로덕션 환경 배포에는 공식 API 사용을 권장합니다

관련 프로젝트

본 프로젝트는 다음 오픈소스 프로젝트에 의존하며 감사드립니다:

핵심 의존성

• jimeng-free-api-all - 즉멍 AI 리버스 인터페이스 구현

  • 완전한 이미지 및 비디오 생성 API 제공

  • OpenAI 호환 인터페이스 설계

  • Docker 원클릭 배포 지원

  • 오픈소스 라이선스: GPL-3.0

기술 프레임워크

• 모델 컨텍스트 프로토콜 (MCP) - 통합 AI 도구 프로토콜 표준

• Python MCP SDK - MCP의 Python 구현

• 즉멍 AI - 하위 AI 생성 서비스

특별 감사

• wwwzhouhui - jimeng-free-api-all 프로젝트 작성자, 안정적이고 신뢰할 수 있는 즉멍 AI 리버스 인터페이스 제공

• Anthropic - 강력한 Claude AI 및 MCP 프로토콜 개발

• 즉멍 AI 팀 - 우수한 이미지 및 비디오 생성 기능 제공