mcpo-docker

What is mcpo-docker?

mcpo-docker is an example Docker image for mcpo, a tool that exposes MCP (Model Context Protocol) servers as OpenAPI-compatible HTTP endpoints specifically for use with OpenWebUI.

How to use mcpo-docker?

Clone the repository, copy the example configuration files (config.example.json and docker-compose.example.yml), edit them as needed, then run docker compose up -d. Alternatively, build the Docker image from source using docker build -t mcpo .. After starting, connect OpenWebUI to the desired endpoint (e.g., http://localhost:8000/memory).

Key features of mcpo-docker

• Docker containerized deployment of mcpo
• Exposes MCP servers as OpenAPI HTTP endpoints
• Each configured MCP server gets a separate endpoint (e.g., /memory, /time)
• Designed for integration with OpenWebUI tools
• Supports standard MCP configuration files

Use cases of mcpo-docker

• Enabling OpenWebUI to use MCP-based tools via HTTP
• Running multiple MCP servers concurrently with individual endpoints
• Prototyping or deploying MCP-based toolchains in a containerized environment

FAQ from mcpo-docker

How do I configure which MCP servers are exposed?

Use a standard MCP configuration file. The repository includes config.example.json as a reference.

Can I run multiple MCP servers?

Yes, each MCP server gets a distinct endpoint (e.g., http://localhost:8000/sequential-thinking, http://localhost:8000/memory).

How do I connect this to OpenWebUI?

In OpenWebUI, go to Settings > Tools, add a connection pointing to the server’s endpoint (e.g., http://localhost:8000/memory), then check available tools on the chat page.

What are the runtime requirements?

A Docker environment capable of running docker compose (or Docker Engine for building). No other dependencies are specified.

Is this the official mcpo Docker image?

No, the README notes that this is an example image created while waiting for the official mcpo Docker image.