Image MCP Servers

🚀 Image MCP Server

This project implements an MCP server based on SSE, offering tools to interact with HuggingFace and Replicate APIs. It focuses on image generation and model management. Built with the MCP core framework, it provides standardized interfaces for AI model interactions. Here's a guide to deploying this project on your own!

✨ Features

HuggingFace Integration

Replicate Integration

🚀 Quick Start

Prerequisites

• Rust (version 2024)
• Docker (optional, for containerized deployment)

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/image-mcp-servers.git
   cd image-mcp-servers
   

2. Create a .env file based on .env.example:

   cp .env.example .env
   

3. Add your API tokens to the .env file:

   HF_API_TOKEN="your_huggingface_token"
   REPLICATE_API_TOKEN="your_replicate_token"
   

4. Build the project:

   cargo build
   

Running the Server

cargo run

The server will run on the port specified by the SERVER_PORT environment variable (default: 3000).

Using Docker

This project includes Docker support for easy deployment:

# Start the service
just docker-up service

# Stop the service
just docker-down service

📚 Documentation

Configuration

The server can be configured via environment variables:

Feature Sets

This project supports two main feature sets, which can be enabled or disabled:

• huggingface: Enable HuggingFace API integration
• replicate: Enable Replicate API integration

By default, no features are enabled. You can build a version with specific features as needed:

# Build with only HuggingFace
cargo build --no-default-features --features huggingface

# Build with only Replicate
cargo build --no-default-features --features replicate

📄 License

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

🙏 Acknowledgments

• MCP Core - The framework used to build this server
• HuggingFace - Provider of image generation models
• Replicate - Provider of the image generation API