Skip to content

README.docker.md

Latest commit

 

History

History
92 lines (62 loc) · 1.96 KB

README.docker.md

File metadata and controls

92 lines (62 loc) · 1.96 KB
Raw

McGravity Docker Guide

Overview

McGravity is a tool that connects multiple MCP (Model Context Protocol) servers into one unified service. This document explains how to use McGravity with Docker.

Using the Docker Image

Pull the Docker Image

docker pull tigranbs/mcgravity

Run McGravity with Docker

Basic usage:

docker run -p 3001:3001 tigranbs/mcgravity http://mcp1.example.com http://mcp2.example.com

With custom host and port:

docker run -p 4000:4000 tigranbs/mcgravity --host 0.0.0.0 --port 4000 http://mcp1.example.com

Using a Configuration File

  1. Create a config.yaml file locally
  2. Mount it to the container:
docker run -p 3001:3001 -v $(pwd)/config.yaml:/app/config.yaml tigranbs/mcgravity --config /app/config.yaml

Building the Docker Image Locally

  1. Clone the repository:
git clone https://github.com/tigranbs/mcgravity.git
cd mcgravity
  1. Build the Docker image:
docker build -t mcgravity .
  1. Run your local build:
docker run -p 3001:3001 mcgravity

Docker Compose Example

services:
  mcgravity:
    image: tigranbs/mcgravity:latest
    ports:
      - '3001:3001'
    volumes:
      - ./config.yaml:/app/config.yaml
    command: --config /app/config.yaml
    restart: unless-stopped

Container Details

  • The McGravity Docker image is based on Alpine Linux for minimal size
  • The application is compiled to a single binary for optimal performance
  • Default port exposed: 3001
  • Default command: --help

Environment Variables

None currently supported. All configuration is done via command-line arguments or the config file.

Troubleshooting

If you encounter issues:

  1. Ensure ports are correctly mapped
  2. Check that your config file is correctly mounted
  3. Verify MCP server URLs are accessible from the container

For more details about McGravity itself, see the main README.md.