Moonshot MCP Server Gateway

# Docker Setup for Moonshot MCP Server

This document explains how to run the Moonshot MCP Server using Docker.

## Prerequisites

- [Docker](https://docs.docker.com/get-docker/)
- [Docker Compose](https://docs.docker.com/compose/install/)

## Getting Started

### 1. Configuration

Before running the Docker container, make sure you have the following configuration files:

- `.env` - Environment variables (copy from `.env.example` if needed)
- `moonshot_config.toml` - MCP server configuration (copy from `moonshot_config.example.toml` if needed)

### 2. Building and Running with Docker Compose

```bash
# Build and start the container in detached mode
docker-compose up -d

# View logs
docker-compose logs -f

# Stop the container
docker-compose down
```

### 3. Building and Running with Docker

If you prefer to use Docker directly:

```bash
# Build the Docker image
docker build -t moonshot-mcp-server .

# Run the container
docker run -p 8000:8000 \
  -v $(pwd)/moonshot_config.toml:/app/moonshot_config.toml \
  -v $(pwd)/.env:/app/.env \
  -v $(pwd)/logs:/app/logs \
  --name moonshot-mcp-server \
  moonshot-mcp-server
```

## Configuration

### Port Configuration

The default port is 8000. If you want to change it:

1. Update the `port` in `moonshot_config.toml`
2. Update the port mapping in `docker-compose.yml`

Example in `docker-compose.yml`:
```yaml
ports:
  - "8090:8090"  # Changed from 8000:8000
```

### Volume Mounts

The Docker setup includes the following volume mounts:

- `./moonshot_config.toml:/app/moonshot_config.toml` - Configuration file
- `./src:/app/src` - Source code (for development)
- `./.env:/app/.env` - Environment variables
- `./logs:/app/logs` - Logs directory

## Troubleshooting

### Port Conflicts

If you encounter port conflicts, you can change the external port in `docker-compose.yml`:

```yaml
ports:
  - "8001:8000"  # Maps container port 8000 to host port 8001
```

### Permission Issues

If you encounter permission issues with the logs directory:

```bash
# Create the logs directory with proper permissions
mkdir -p logs
chmod 777 logs
```

### Container Not Starting

Check the logs for errors:

```bash
docker-compose logs
```