0.0.9

.github/workflows/docker-build.yaml

@@ -0,0 +1,165 @@
+name: Create and publish Docker images with specific build args
+
+on:
+    workflow_dispatch:
+    push:
+        branches:
+            - main
+            - dev
+        tags:
+            - v*
+
+env:
+    REGISTRY: ghcr.io
+
+jobs:
+    build-main-image:
+        runs-on: ${{ matrix.platform == 'linux/arm64' && 'ubuntu-24.04-arm' || 'ubuntu-latest' }}
+        permissions:
+            contents: read
+            packages: write
+        strategy:
+            fail-fast: false
+            matrix:
+                platform:
+                    - linux/amd64
+                    - linux/arm64
+
+        steps:
+            # GitHub Packages requires the entire repository name to be in lowercase
+            # although the repository owner has a lowercase username, this prevents some people from running actions after forking
+            - name: Set repository and image name to lowercase
+              run: |
+                  echo "IMAGE_NAME=${IMAGE_NAME,,}" >>${GITHUB_ENV}
+                  echo "FULL_IMAGE_NAME=ghcr.io/${IMAGE_NAME,,}" >>${GITHUB_ENV}
+              env:
+                  IMAGE_NAME: "${{ github.repository }}"
+
+            - name: Prepare
+              run: |
+                  platform=${{ matrix.platform }}
+                  echo "PLATFORM_PAIR=${platform//\//-}" >> $GITHUB_ENV
+
+            - name: Checkout repository
+              uses: actions/checkout@v4
+
+            - name: Set up QEMU
+              uses: docker/setup-qemu-action@v3
+
+            - name: Set up Docker Buildx
+              uses: docker/setup-buildx-action@v3
+
+            - name: Log in to the Container registry
+              uses: docker/login-action@v3
+              with:
+                  registry: ${{ env.REGISTRY }}
+                  username: ${{ github.actor }}
+                  password: ${{ secrets.GITHUB_TOKEN }}
+
+            - name: Extract metadata for Docker images (default latest tag)
+              id: meta
+              uses: docker/metadata-action@v5
+              with:
+                  images: ${{ env.FULL_IMAGE_NAME }}
+                  tags: |
+                      type=ref,event=branch
+                      type=ref,event=tag
+                      type=sha,prefix=git-
+                      type=semver,pattern={{version}}
+                      type=semver,pattern={{major}}.{{minor}}
+                  flavor: |
+                      latest=${{ github.ref == 'refs/heads/main' }}
+
+            - name: Extract metadata for Docker cache
+              id: cache-meta
+              uses: docker/metadata-action@v5
+              with:
+                  images: ${{ env.FULL_IMAGE_NAME }}
+                  tags: |
+                      type=ref,event=branch
+                      ${{ github.ref_type == 'tag' && 'type=raw,value=main' || '' }}
+                  flavor: |
+                      prefix=cache-${{ matrix.platform }}-
+                      latest=false
+
+            - name: Build Docker image (latest)
+              uses: docker/build-push-action@v5
+              id: build
+              with:
+                  context: .
+                  push: true
+                  platforms: ${{ matrix.platform }}
+                  labels: ${{ steps.meta.outputs.labels }}
+                  outputs: type=image,name=${{ env.FULL_IMAGE_NAME }},push-by-digest=true,name-canonical=true,push=true
+                  cache-from: type=registry,ref=${{ steps.cache-meta.outputs.tags }}
+                  cache-to: type=registry,ref=${{ steps.cache-meta.outputs.tags }},mode=max
+                  build-args: |
+                      BUILD_HASH=${{ github.sha }}
+
+            - name: Export digest
+              run: |
+                  mkdir -p /tmp/digests
+                  digest="${{ steps.build.outputs.digest }}"
+                  touch "/tmp/digests/${digest#sha256:}"
+
+            - name: Upload digest
+              uses: actions/upload-artifact@v4
+              with:
+                  name: digests-main-${{ env.PLATFORM_PAIR }}
+                  path: /tmp/digests/*
+                  if-no-files-found: error
+                  retention-days: 1
+
+    merge-main-images:
+        runs-on: ubuntu-latest
+        needs: [build-main-image]
+        steps:
+            # GitHub Packages requires the entire repository name to be in lowercase
+            # although the repository owner has a lowercase username, this prevents some people from running actions after forking
+            - name: Set repository and image name to lowercase
+              run: |
+                  echo "IMAGE_NAME=${IMAGE_NAME,,}" >>${GITHUB_ENV}
+                  echo "FULL_IMAGE_NAME=ghcr.io/${IMAGE_NAME,,}" >>${GITHUB_ENV}
+              env:
+                  IMAGE_NAME: "${{ github.repository }}"
+
+            - name: Download digests
+              uses: actions/download-artifact@v4
+              with:
+                  pattern: digests-main-*
+                  path: /tmp/digests
+                  merge-multiple: true
+
+            - name: Set up Docker Buildx
+              uses: docker/setup-buildx-action@v3
+
+            - name: Log in to the Container registry
+              uses: docker/login-action@v3
+              with:
+                  registry: ${{ env.REGISTRY }}
+                  username: ${{ github.actor }}
+                  password: ${{ secrets.GITHUB_TOKEN }}
+
+            - name: Extract metadata for Docker images (default latest tag)
+              id: meta
+              uses: docker/metadata-action@v5
+              with:
+                  images: ${{ env.FULL_IMAGE_NAME }}
+                  tags: |
+                      type=ref,event=branch
+                      type=ref,event=tag
+                      type=sha,prefix=git-
+                      type=semver,pattern={{version}}
+                      type=semver,pattern={{major}}.{{minor}}
+                  flavor: |
+                      latest=${{ github.ref == 'refs/heads/main' }}
+
+            - name: Create manifest list and push
+              working-directory: /tmp/digests
+              run: |
+                  docker buildx imagetools create $(jq -cr '.tags | map("-t " + .) | join(" ")' <<< "$DOCKER_METADATA_OUTPUT_JSON") \
+                    $(printf '${{ env.FULL_IMAGE_NAME }}@sha256:%s ' *)
+
+            - name: Inspect image
+              run: |
+                  docker buildx imagetools inspect ${{ env.FULL_IMAGE_NAME }}:${{ steps.meta.outputs.version }}

CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.9] - 2025-04-06
+
+### Added
+
+- 🧭 **Clearer Docs Navigation with Path Awareness**: Optimized the /docs and /[tool]/docs pages to clearly display full endpoint paths when using mcpo --config, making it obvious where each tool is hosted—no more guessing or confusion when running multiple tools under different routes.
+- 🛤️ **New --path-prefix Option for Precise Routing Control**: Introduced optional --path-prefix flag allowing you to customize the route prefix for all mounted tools—great for integrating mcpo into existing infrastructures, reverse proxies, or multi-service APIs without route collisions.
+- 🐳 **Official Dockerfile for Easy Deployment**: Added a first-party Dockerfile so you can containerize mcpo in seconds—perfect for deploying to production, shipping models with standardized dependencies, and running anywhere with a consistent environment.
+
 ## [0.0.8] - 2025-04-03
 
 ### Added

Dockerfile

@@ -0,0 +1,42 @@
+FROM python:3.12-slim-bookworm
+
+# Install uv (from official binary), nodejs, npm, and git
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git \
+    curl \
+    ca-certificates \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install Node.js and npm via NodeSource 
+RUN curl -fsSL https://deb.nodesource.com/setup_22.x | bash - \
+    && apt-get install -y nodejs \
+    && rm -rf /var/lib/apt/lists/*
+
+# Confirm npm and node versions (optional debugging info)
+RUN node -v && npm -v
+
+# Copy your mcpo source code (assuming in src/mcpo)
+COPY . /app
+WORKDIR /app
+
+# Create virtual environment explicitly in known location
+ENV VIRTUAL_ENV=/app/.venv
+RUN uv venv "$VIRTUAL_ENV"
+ENV PATH="$VIRTUAL_ENV/bin:$PATH"
+
+# Install mcpo (assuming pyproject.toml is properly configured)
+RUN uv pip install . && rm -rf ~/.cache
+
+# Verify mcpo installed correctly
+RUN which mcpo
+
+# Expose port (optional but common default)
+EXPOSE 8000
+
+# Entrypoint set for easy container invocation
+ENTRYPOINT ["mcpo"]
+
+# Default help CMD (can override at runtime)
+CMD ["--help"]

README.md

@@ -40,6 +40,12 @@ pip install mcpo
 mcpo --port 8000 --api-key "top-secret" -- your_mcp_server_command
 ```
 
+You can also run mcpo via Docker with no installation:
+
+```bash
+docker run -p 8000:8000 ghcr.io/open-webui/mcpo:main --api-key "top-secret" -- your_mcp_server_command
+```
+
 Example:
 
 ```bash

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mcpo"
-version = "0.0.8"
+version = "0.0.9"
 description = "A simple, secure MCP-to-OpenAPI proxy server"
 authors = [
     { name = "Timothy Jaeryang Baek", email = "[email protected]" }
@@ -12,6 +12,7 @@ dependencies = [
     "fastapi>=0.115.12",
     "mcp>=1.6.0",
     "passlib[bcrypt]>=1.7.4",
+    "pydantic>=2.11.1",
     "pyjwt[crypto]>=2.10.1",
     "typer>=0.15.2",
     "uvicorn>=0.34.0",

src/mcpo/__init__.py

@@ -45,7 +45,10 @@ def main(
         Optional[str], typer.Option("--ssl-certfile", "-t", help="SSL certfile")
     ] = None,
     ssl_keyfile: Annotated[
-        Optional[str], typer.Option("--ssl-keyfile", "-k",  help="SSL keyfile")
+        Optional[str], typer.Option("--ssl-keyfile", "-k", help="SSL keyfile")
+    ] = None,
+    path_prefix: Annotated[
+        Optional[str], typer.Option("--path-prefix", help="URL prefix")
     ] = None,
 ):
     server_command = None
@@ -81,6 +84,17 @@ def main(
     for key, value in env_dict.items():
         os.environ[key] = value
 
+    # Whatever the prefix is, make sure it starts and ends with a /
+    if path_prefix is None:
+        # Set default value
+        path_prefix = "/"
+    # if prefix doesn't end with a /, add it
+    if not path_prefix.endswith("/"):
+        path_prefix = f"{path_prefix}/"
+    # if prefix doesn't start with a /, add it
+    if not path_prefix.startswith("/"):
+        path_prefix = f"/{path_prefix}"
+
     # Run your async run function from mcpo.main
     asyncio.run(
         run(
@@ -95,6 +109,7 @@ def main(
             server_command=server_command,
             ssl_certfile=ssl_certfile,
             ssl_keyfile=ssl_keyfile,
+            path_prefix=path_prefix,
         )
     )