Add docker and dc (#22)

* Add docker compose

* Fix

* Delete .vscode/settings.json

* Update README.md

* fix: using port 8000 for consistency

* chore: using mock mcp server to avoid using a third party for security reasons

* feat: updating mock weather mcp server to make it easier to work with docker

* fix: updating tests

* docs: updating README.md related to mock mcp server stuff

* docs: updating README.md with new docker-compose way to run

* chore: adding new line

---------

Co-authored-by: Denis <chentsov@restream.rt.ru>
Co-authored-by: Jonathan Gastón Löwenstern <jonigl@gmail.com>

Author: 3 people

.gitignore

@@ -11,3 +11,4 @@ wheels/
 
 # Dynamic package version
 _version.py
+.vscode

Dockerfile

@@ -0,0 +1,16 @@
+FROM python:3.10.15-slim
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN pip install uv
+ENV SETUPTOOLS_SCM_PRETEND_VERSION_FOR_OLLAMA_MCP_BRIDGE=0.1.0
+
+COPY . ./
+
+RUN uv sync
+
+EXPOSE 8000
+
+CMD ["uv", "run", "ollama-mcp-bridge"]

README.md

@@ -22,6 +22,8 @@
 - [Installation](#installation)
   - [Quick Start](#quick-start)
   - [Or, install from PyPI with pip](#or-install-from-pypi-with-pip)
+  - [Or, run with Docker Compose](#or-run-with-docker-compose)
+  - [Or, run with Docker only](#or-run-with-docker-only)
   - [Or, install from source](#or-install-from-source)
 - [How It Works](#how-it-works)
 - [Configuration](#configuration)
@@ -77,6 +79,19 @@ uvx ollama-mcp-bridge
 pip install --upgrade ollama-mcp-bridge
 ```
 
+### Or, run with Docker Compose
+
+```bash
+docker-compose up
+```
+
+This uses the included [docker-compose.yml](./docker-compose.yml) file which:
+- Builds the bridge from source using this Dockerfile [Dockerfile](./Dockerfile)
+- Connects to Ollama running on the host machine (`host.docker.internal:11434`)
+- Maps the configuration file from [./mcp-config.json](./mcp-config.json) (includes mock [weather server for demo](./mock-weather-mcp-server))
+- Allows all CORS origins (configurable via `CORS_ORIGINS` environment variable)
+
+
 ### Or, install from source
 
 ```bash
@@ -121,7 +136,7 @@ ollama-mcp-bridge
 
 ### MCP Servers Configuration
 
-Create an MCP configuration file at `mcp-servers-config/mcp-config.json` with your servers:
+Create an MCP configuration file at `mcp-config.json` with your servers:
 
 ```json
 {
@@ -130,9 +145,9 @@ Create an MCP configuration file at `mcp-servers-config/mcp-config.json` with yo
       "command": "uv",
       "args": [
         "--directory",
-        ".",
+        "./mock-weather-mcp-server",
         "run",
-        "mock-weather-mcp-server.py"
+        "main.py"
       ],
       "env": {
         "MCP_LOG_LEVEL": "ERROR"
@@ -179,13 +194,13 @@ CORS_ORIGINS="http://localhost:3000,http://localhost:8080,https://app.example.co
 > Using `CORS_ORIGINS="*"` allows all origins and is not recommended for production. Always specify exact origins for security.
 
 > [!NOTE]
-> An example MCP server script is provided at `mcp-servers-config/mock-weather-mcp-server.py`.
+> An example MCP server script is provided at [mock-weather-mcp-server/main.py](mock-weather-mcp-server/main.py).
 
 ## Usage
 
 ### Start the Server
 ```bash
-# Start with default settings (config: mcp-servers-config/mcp-config.json, host: 0.0.0.0, port: 8000)
+# Start with default settings (config: ./mcp-config.json, host: 0.0.0.0, port: 8000)
 ollama-mcp-bridge
 
 # Start with custom configuration file

docker-compose.yml

@@ -0,0 +1,14 @@
+services:
+  ollama-mcp-bridge:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    ports:
+      - "8000:8000"
+    environment:
+      - OLLAMA_URL=http://host.docker.internal:11434
+      - CORS_ORIGINS=*
+    volumes:
+      - ./mcp-config.json:/root/mcp-config.json
+    restart: unless-stopped
+    command: uv run ollama-mcp-bridge --ollama-url=http://host.docker.internal:11434

mcp-servers-config/mcp-config.json mcp-config.jsonmcp-servers-config/mcp-config.json renamed to mcp-config.json

@@ -4,9 +4,9 @@
       "command": "uv",
       "args": [
         "--directory",
-        ".",
+        "./mock-weather-mcp-server",
         "run",
-        "mock-weather-mcp-server.py"
+        "main.py"
       ],
       "env": {
         "MCP_LOG_LEVEL": "ERROR"

mock-weather-mcp-server/README.md

@@ -0,0 +1,3 @@
+# Mock Weather MCP Server
+
+This is just a mock implementation of a weather MCP server for testing purposes.

…ervers-config/mock-weather-mcp-server.py mock-weather-mcp-server/main.pymcp-servers-config/mock-weather-mcp-server.py renamed to mock-weather-mcp-server/main.py mcp-servers-config/mock-weather-mcp-server.py renamed to mock-weather-mcp-server/main.py

@@ -0,0 +1,9 @@
+[project]
+name = "mock-weather-mcp-server"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "mcp>=1.9.4",
+]

mock-weather-mcp-server/pyproject.toml

@@ -116,7 +116,7 @@ def test_imports():
 
 def test_example_config_structure():
     """Test that the example config file has the correct structure"""
-    config_path = Path(__file__).parent.parent / "mcp-servers-config" / "mcp-config.json"
+    config_path = Path(__file__).parent.parent / "mcp-config.json"
 
     if config_path.exists():
         with open(config_path, 'r', encoding='utf-8') as f: