veo-mcp-server
CLI | 설치 확인 | 버전 확인 |
|
|
|
|
|
|
이것은 무엇인가요?
Gemini Media MCP는 Google의 가장 강력한 AI 미디어 생성 모델을 모든 MCP 호환 AI 어시스턴트에 도입하는 포괄적인 툴킷입니다. VEO 3.1로 4K 비디오를 생성하고, NanoBanana Pro 2로 멋진 이미지를 만들며, 내장된 기술로 전문적인 프롬프트를 작성할 수 있습니다. 이 모든 것이 단일 저장소에서 가능합니다.
포함된 기능
MCP 서버
서버 | 설명 | 도구 |
VEO 3.1 | AI 비디오 생성 (텍스트-비디오, 이미지-비디오, 확장, 보간) | 9개 도구 |
NanoBanana | NanoBanana Pro 2를 사용한 AI 이미지 생성 (Pro + Flash 모델) | 4개 도구 |
Claude Code 기술 (플러그인 마켓플레이스)
기술 | 설명 |
VEO 프롬프팅 | 영화 같은 VEO 3.1 비디오를 위한 7단계 프롬프트 엔지니어링 |
NanoBanana 프롬프팅 | 사실적인 NanoBanana Pro 2 이미지를 위한 7단계 프롬프트 엔지니어링 |
Claude Code를 통해 기술을 설치하세요:
/plugin marketplace add u2n4/gemini-media-mcp빠른 시작
이 저장소는 두 개의 독립적인 MCP 서버를 호스팅합니다. 필요한 서버를 설치하거나 둘 다 설치할 수 있습니다. 각 서버는 PyPI에 별도로 게시됩니다.
옵션 A — uvx (설치 불필요, 권장)
아래의 적절한 서버 블록을 사용하여 MCP 클라이언트 구성(Claude Desktop, Claude Code, Cursor, VS Code, Windsurf)에 블록을 추가하세요 (VEO 서버 / NanoBanana 서버 섹션 참조).
옵션 B — 복제 + 편집 가능한 설치
git clone https://github.com/u2n4/gemini-media-mcp.git
cd gemini-media-mcp
# Create a virtual environment (uv pip install requires one — or pass --system)
uv venv
source .venv/bin/activate # macOS / Linux
# .venv\Scripts\activate # Windows PowerShell
# Install one or both sub-packages
uv pip install -e servers/veo
uv pip install -e servers/nanobananaVEO 서버
uvx (설치 불필요):
{
"mcpServers": {
"veo": {
"command": "uvx",
"args": ["veo-mcp-server"],
"env": {
"GEMINI_API_KEY": "your_key",
"VIDEO_OUTPUT_DIR": "./videos"
}
}
}
}Claude Code:
claude mcp add veo -s user -e GEMINI_API_KEY=your_key -- uvx veo-mcp-serverpip 설치:
pip install veo-mcp-serverNanoBanana 서버
uvx (설치 불필요):
{
"mcpServers": {
"nanobanana": {
"command": "uvx",
"args": ["nanobanana-imagen-mcp"],
"env": {
"GEMINI_API_KEY": "your_key"
}
}
}
}Claude Code:
claude mcp add nanobanana -s user -e GEMINI_API_KEY=your_key -- uvx nanobanana-imagen-mcppip 설치:
pip install nanobanana-imagen-mcpVEO 서버
Google VEO 3.1 기반의 AI 비디오 생성입니다. 비동기 작업 패턴을 사용하여 백그라운드에서 생성이 시작되고 폴링을 위한 작업 ID를 반환하므로 타임아웃이 발생하지 않습니다.
도구
도구 | 설명 |
| 텍스트 프롬프트에서 비디오를 생성합니다. 720p/1080p/4K, 16:9 또는 9:16, 4/6/8초 지속 시간, 부정 프롬프트, 참조 이미지, 시드 제어 및 배치 생성(1-4개 비디오)을 지원합니다. |
| 모션 프롬프트로 참조 이미지에 애니메이션을 적용합니다. |
| 두 프레임(첫 번째 프레임 + 마지막 프레임) 사이의 부드러운 전환을 만듭니다. |
| 기존 VEO 비디오를 약 7초 연장합니다. 720p만 지원하며, 최대 148초까지 가능합니다. |
| 비동기 작업 상태를 확인합니다. 완료되거나 실패할 때까지 15-20초마다 호출하세요. |
| 모든 생성 작업과 현재 상태를 나열합니다. |
| API 키 상태(구성된 키, 활성 키, 남은 키)를 확인합니다. |
| 모든 해상도에서 표준 및 빠른 모델에 대한 초당 가격을 표시합니다. |
| 생성 통계(비디오 수, 총 크기, 파일 세부 정보, 작업 상태)를 표시합니다. |
VEO 구성
변수 | 설명 | 기본값 |
| 기본 API 키 (필수) | -- |
| 자동 교체를 위한 백업 키 | -- |
| 비디오 출력 디렉토리 |
|
VEO 모델
티어 | 모델 | 용도 |
표준 |
| 더 높은 품질의 출력 |
빠름 |
| 더 빠른 생성 |
NanoBanana 서버
NanoBanana Pro 2 기반의 AI 이미지 생성입니다. 기본 4K 해상도로 Pro(최대 품질) 및 Flash(빠름) 모델을 지원합니다.
도구
도구 | 설명 |
| NanoBanana Pro 2(Pro 또는 Flash)를 사용하여 이미지를 생성합니다. 종횡비, 해상도(최대 4K), 부정 프롬프트, 사고 수준, 접지 및 참조 이미지를 지원합니다. |
| 편집 또는 조건화를 위한 참조 이미지를 업로드합니다. |
| 생성 통계(이미지 수, 총 크기, 파일 세부 정보)를 표시합니다. |
| 서버 유지 관리 및 정리(캐시 지우기, 임시 파일 제거)를 수행합니다. |
모델
모델 | 엔진 | 용도 |
Pro | Gemini 3 Pro Image | 최대 품질, 복잡한 장면 |
Flash | Gemini 3.1 Flash Image | 빠른 생성, 단순한 장면 |
프롬프팅 기술
VEO 프롬프팅 기술
VEO 3.1을 위한 7단계 프롬프트 엔지니어링 시스템:
촬영 기법 (카메라, 샷 유형, 렌즈, 각도)
피사체 (캐릭터, 사물, 재질 단서)
동작 (힘 기반 동사, 타임스탬프 비트)
환경 (시간대, 날씨, 깊이 레이어)
조명 및 분위기 (물리적 광원, 색온도)
오디오 디자인 (대사, SFX, 앰비언트, 음악)
기술 제어 (부정 프롬프트, 스타일 앵커, 필름 스톡)
NanoBanana 프롬프팅 기술
NanoBanana Pro 2를 위한 7단계 프롬프트 엔지니어링 시스템:
스타일 및 예술적 방향 (시각적 DNA)
장면 설명 (환경, 분위기)
주요 피사체 (극도의 구체성을 가진 핵심 요소)
카메라 및 렌즈 (사실성을 위한 실제 카메라 사양)
조명 (자연광, 스튜디오, 색온도)
질감, 재질 및 색상 (촉각적 세부 정보)
부정 프롬프트 (품질 보호)
아키텍처
gemini-media-mcp/
├── servers/
│ ├── veo/ # VEO 3.1 MCP Server (PyPI: veo-mcp-server)
│ │ ├── pyproject.toml
│ │ ├── requirements.txt
│ │ └── src/
│ │ └── veo_mcp_server/
│ │ ├── __init__.py
│ │ ├── __main__.py
│ │ └── server.py
│ └── nanobanana/ # NanoBanana MCP Server (PyPI: nanobanana-imagen-mcp)
│ ├── pyproject.toml
│ ├── requirements.txt
│ └── nanobanana_mcp_server/ # Package
├── skills/
│ ├── veo-prompting/ # VEO prompting skill
│ │ └── SKILL.md
│ └── nanobanana-prompting/ # NanoBanana prompting skill
│ └── SKILL.md
├── plugins/ # Claude Code Plugin Marketplace
│ ├── veo-prompting/
│ │ ├── .claude-plugin/
│ │ │ └── plugin.json
│ │ └── skills/
│ │ └── veo-prompting/
│ │ └── SKILL.md
│ └── nanobanana-prompting/
│ ├── .claude-plugin/
│ │ └── plugin.json
│ └── skills/
│ └── nanobanana-prompting/
│ └── SKILL.md
├── .claude-plugin/
│ └── marketplace.json
├── .env.example
├── .gitignore
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── llms.txt
└── llms-install.md기여하기
CONTRIBUTING.md를 참조하세요.
라이선스
MIT -- LICENSE를 참조하세요.
크레딧
NanoBanana MCP 서버: MCP 커뮤니티 전반에서 사용되는 nano-banana 명명 규칙에서 영감을 받았습니다. 이는 독립적인 구현입니다.
VEO 3.1 by Google DeepMind
지원
이 도구가 유용하다면 이 저장소에 별을 눌러주세요!
사우디아라비아 동부 주에서 ❤️를 담아 제작되었습니다.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/u2n4/gemini-media-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server