added docker support

Author: antonkulaga

.github/workflows/docker-build.yml

@@ -0,0 +1,51 @@
+name: Docker Build and Push
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write # Needed to push to GitHub Container Registry
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/${{ github.repository }}
+          tags: |
+            # Use 'latest' for the main branch
+            type=raw,value=latest,enable=${{ github.ref == 'refs/heads/main' }}
+            # Use the git sha for other refs (like PRs)
+            type=sha,prefix=,suffix=,format=short
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: ${{ github.event_name != 'pull_request' }} # Only push on merge to main
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max 

Dockerfile

@@ -0,0 +1,16 @@
+FROM ghcr.io/astral-sh/uv:debian-slim
+
+# Set the working directory in the container
+WORKDIR /app
+
+COPY . .
+
+RUN uv sync
+
+RUN uv run pytest -vvv
+
+# Expose the port the app runs on (adjust if your server runs on a different port)
+EXPOSE 3001
+
+# Define the command to run the application
+CMD ["uv", "run", "server"] 

README.md

@@ -65,6 +65,37 @@ uv sync
 uv run server
 ```
 
+### Docker Deployment
+
+The easiest way to run the MCP server is using Docker. The project provides a pre-built Docker image available on GitHub Container Registry.
+
+1. Using Docker Compose (recommended):
+
+```bash
+# Clone the repository
+git clone git@github.com:longevity-genie/biothings-mcp.git
+cd biothings-mcp
+
+# Start the services
+docker-compose up
+```
+
+This will start:
+- The MCP server on port 3001
+- The MCP Inspector on port 6277
+
+2. Using Docker directly:
+
+```bash
+# Pull the latest image
+docker pull ghcr.io/longevity-genie/biothings-mcp:latest
+
+# Run the container
+docker run -p 3001:3001 -e MCP_PORT=3001 ghcr.io/longevity-genie/biothings-mcp:latest
+```
+
+The MCP server will be available at `http://localhost:3001/mcp`.
+
 ### Integration with AI Systems
 
 Configure your AI system to use the MCP server in one of two ways:
@@ -89,7 +120,7 @@ Configure your AI system to use the MCP server in one of two ways:
       "args": [
         "mcp-remote",
         "http://localhost:3001/mcp",
-        "8080"  // Optional port number for OAuth support
+        "6277"  // Optional port number for OAuth support
       ]
     }
   }

docker-compose.yml

@@ -0,0 +1,24 @@
+services:
+  app:
+    image: ghcr.io/longevity-genie/biothings-mcp:latest
+    ports:
+      - "3001:3001"
+    environment:
+      - MCP_PORT=3001
+    networks:
+      - mcp-network
+
+  inspector:
+    image: mcp/inspector
+    ports:
+      - "6277:6277"
+    environment:
+      - MCP_SERVER_URL=http://app:3001/mcp
+    depends_on:
+      - app
+    networks:
+      - mcp-network
+
+networks:
+  mcp-network:
+    driver: bridge