MCP Server Replicate

🚀 MCP Server Replicate

A fast MCP server implementation for the Replicate API, providing resource-based access to AI model inference, with a focus on image generation.

🚀 Quick Start

This project offers a fast MCP server implementation for the Replicate API, enabling resource - based access to AI model inference, especially for image generation.

✨ Features

• Fast Response: Optimized processing flow ensures low latency and high efficiency.
• Multi - model Support: Compatible with various AI models to meet different needs.
• Automated Management: Automatically handles resource allocation and task scheduling.
• Scalable Architecture: Supports horizontal scaling to adapt to high - load scenarios.

📦 Installation

1. Install via PyPI:

pip install mcp-server-replicate

2. Clone the repository and install dependencies:

git clone https://github.com/gerred/mcp-server-replicate.git
cd mcp-server-replicate
uv pip install --system ".[dev]"

3. Start the server:

python -m mcp_server_replicate.start

💻 Usage Examples

Basic Usage

Generate Images

• Natural Language Input:

Create a realistic image of a sunset over a snow - covered mountain, showing the snow - capped peaks.

• Generate Based on Templates:

Create a picture of a mountain scenery using the landscape template.

Browse and Manage

• View History:

Show all the images I recently generated.

• Search for Specific Content:

Find all images related to "landscape".

• Check Status:

How is the progress of the recent image generation?

📚 Documentation

• Implementation Plan
• Contribution Guide
• API Reference
• Resource System
• Template System

🔧 Technical Details

Troubleshooting

Server Not Displayed in Claude Desktop

1. Check the log file:

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

2. Validate the configuration:

• Ensure that the paths in claude_desktop_config.json are absolute paths.
• Confirm that UV is installed and in the PATH environment variable.
• Check if the Replicate API key is set.

3. Try restarting the Claude desktop:

restart claude-desktop

Development

1. Clone the repository:

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

2. Install development dependencies:

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

3. Install pre - commit hooks:

pre-commit install

4. Run tests:

pytest

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

🤝 Contribution

We welcome any contributions! Please refer to our Contribution Guide for more information.