local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Serves as a FastMCP server implementation for the Replicate API, providing resource-based access to AI model inference with a focus on image generation.

MCP 서버 복제

Replicate API를 위한 FastMCP 서버 구현으로, 이미지 생성에 중점을 두고 AI 모델 추론에 대한 리소스 기반 액세스를 제공합니다.

특징

🖼️ 리소스 기반 이미지 생성 및 관리
🔄 구독을 통한 실시간 업데이트
📝 템플릿 기반 매개변수 구성
🔍 포괄적인 모델 발견 및 선택
🪝 외부 알림을 위한 Webhook 통합
🎨 최적의 결과를 위한 품질 및 스타일 사전 설정
📊 진행 상황 추적 및 상태 모니터링
🔒 안전한 API 키 관리

사용 가능한 프롬프트

서버는 다양한 작업에 대해 여러 가지 특수 프롬프트를 제공합니다.

텍스트를 이미지로(기본)

가장 철저하게 검증되고 강력한 프롬프트입니다. 텍스트 설명에서 고품질 이미지를 생성하도록 최적화되었으며, 다음과 같은 기능을 제공합니다.

세부적인 스타일 제어
품질 사전 설정(초안, 균형, 품질, 극한)
크기 및 종횡비 사용자 정의
진행 상황 추적 및 실시간 업데이트

예:

지엑스피1

다른 프롬프트

이미지 대 이미지 : 기존 이미지 변환(곧 제공)
모델 선택 : 작업에 적합한 모델을 선택하는 데 도움을 받으세요
매개변수 도움말 : 모델 매개변수 이해 및 구성

필수 조건

Python 3.11 이상
Replicate API 키( https://replicate.com/account 에서 받으세요)
종속성 관리를 위한 UV

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 MCP Server Replicate를 자동으로 설치하려면:

npx -y @smithery/cli install @gerred/mcp-server-replicate --client claude

수동 설치

PyPI에서 직접 패키지를 설치할 수 있습니다.

# Using UV (recommended)
uv pip install mcp-server-replicate

# Using UVX for isolated environments
uvx install mcp-server-replicate

# Using pip
pip install mcp-server-replicate

Claude 데스크톱 통합

최신 버전의 Claude Desktop이 설치되어 있는지 확인하세요.
Claude Desktop 구성을 엽니다.

# macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
code %APPDATA%\Claude\claude_desktop_config.json

다음 옵션 중 하나를 사용하여 서버 구성을 추가합니다.

{
  "globalShortcut": "Shift+Alt+A",
  "mcpServers": {
    "replicate": {
      "command": "uv",
      "args": ["tool", "run", "mcp-server-replicate"],
      "env": {
        "REPLICATE_API_TOKEN": "APITOKEN"
      },
      "cwd": "$PATH_TO_REPO"
    }
  }
}

복제 API 키를 설정하세요:

# Option 1: Set in your environment
export REPLICATE_API_TOKEN=your_api_key_here

# Option 2: Create a .env file in your home directory
echo "REPLICATE_API_TOKEN=your_api_key_here" > ~/.env

Claude Desktop을 완전히 다시 시작하세요

이제 Claude Desktop에 🔨 아이콘이 표시되어 MCP 서버를 사용할 수 있음을 나타냅니다.

용법

Claude Desktop에 연결하면 다음을 수행할 수 있습니다.

자연어로 이미지 생성:
Create a photorealistic mountain landscape at sunset with snow-capped peaks
세대를 탐색해보세요:
Show me my recent image generations
세대별로 검색:
Find my landscape generations
생성 상태 확인:
What's the status of my last generation?

문제 해결

Claude Desktop에 서버가 표시되지 않습니다.

Claude Desktop 로그를 확인하세요.

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

구성을 확인하세요:

claude_desktop_config.json 의 경로가 절대 경로인지 확인하세요.
UV가 설치되었고 PATH에 있는지 확인하세요.
Replicate API 키가 설정되었는지 확인하세요.

Claude Desktop을 다시 시작해 보세요.

더 자세한 문제 해결 방법은 디버깅 가이드를 참조하세요.

선적 서류 비치

개발

저장소를 복제합니다.

git clone https://github.com/gerred/mcp-server-replicate.git
cd mcp-server-replicate

개발 종속성 설치:

uv pip install --system ".[dev]"

사전 커밋 후크 설치:

pre-commit install

테스트 실행:

pytest

기여하다

기여를 환영합니다! 자세한 내용은 기여 가이드를 참조하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

View all tools

Replicate API를 통한 이미지 생성에 중점을 두고 AI 모델 추론에 대한 리소스 기반 액세스를 용이하게 하는 FastMCP 서버 구현으로, 실시간 업데이트, 웹훅 통합, 안전한 API 키 관리와 같은 기능을 제공합니다.

Related Resources

Reddit Discussion about this server