MCPO Docker
An example Docker image for mcpo（with npm,curl,nodejs,uv Pre-Built;Pre-Built MCP:amap;baidumap;server-brave-search; tavily;fetch）, a tool that exposes MCP (Model Context Protocol) servers as OpenAPI-compatible HTTP endpoints for OpenWebUI.
What is MCPO Docker?
MCPO Docker is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to example docker image for mcpo（with npm,curl,nodejs,uv pre-built;pre-built mcp:amap;baidumap;server-brave-search; tavily;fetch）, a tool that exposes mcp (model context protocol) servers as openapi-comp...
An example Docker image for mcpo（with npm,curl,nodejs,uv Pre-Built;Pre-Built MCP:amap;baidumap;server-brave-search; tavily;fetch）, a tool that exposes MCP (Model Context Protocol) servers as OpenAPI-compatible HTTP endpoints for OpenWebUI.
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- An example Docker image for mcpo（with npm,curl,nodejs,uv Pre
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcpo-docker-useConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCPO Docker
MCPO Docker is a pre-built Docker image that packages the mcpo tool alongside Node.js, npm, curl, and uv, making it easy to expose multiple MCP servers as OpenAPI-compatible HTTP endpoints for OpenWebUI and other API consumers. The image includes pre-configured integrations for popular services such as Amap, Baidu Maps, Brave Search, Tavily, and a general fetch tool. It is ideal for teams wanting to self-host a battery of MCP capabilities behind a single Docker Compose stack without manually managing per-tool dependencies.
Prerequisites
- Docker and Docker Compose installed on the host machine
- API keys for any services you intend to enable (e.g. AMAP_MAPS_API_KEY for Amap, Brave Search API key for Brave Search)
- A running instance of OpenWebUI or another client that can consume OpenAPI endpoints
- Basic familiarity with editing .env files and docker-compose.yml
Clone the repository
Clone the mcpo_docker_use repository to get the Docker Compose setup, config templates, and startup scripts.
git clone https://github.com/flyfox666/mcpo_docker_use.git
cd mcpo_docker_useCreate and configure the .env file
Copy the example .env file and fill in your credentials. The MCPO_API_KEY secures the HTTP endpoint; additional keys enable specific MCP integrations.
cp .env.example .env
# Edit .env and set:
# MCPO_API_KEY=your_secret_key
# AMAP_MAPS_API_KEY=your_amap_key (if using Amap)
# BRAVE_API_KEY=your_brave_key (if using Brave Search)
# TAVILY_API_KEY=your_tavily_key (if using Tavily)Review config.json to choose your MCP servers
The config.json file lists which MCP servers will be started automatically at container boot. Add or remove server entries to match the integrations you need.
# Example config.json entry for Tavily:
# {
# "type": "npx",
# "package": "@modelcontextprotocol/server-tavily"
# }Build the Docker image
Build the image locally. Use --no-cache if you need a completely fresh build (e.g. after updating config.json).
docker-compose build --no-cacheStart the service
Launch the container in the background. The startup script dynamically installs each configured MCP server's dependencies before starting mcpo.
docker-compose up -dConnect OpenWebUI to the endpoint
In OpenWebUI settings, add the mcpo HTTP endpoint (default port 8000) as an OpenAPI tool provider and supply the MCPO_API_KEY you set in .env.
# OpenWebUI tool endpoint: http://localhost:8000
# Authorization header: Bearer <MCPO_API_KEY>MCPO Docker Examples
Docker Compose service definition
Minimal docker-compose.yml showing how the mcpo service is wired together with an env_file and volume mount for persistent config.
{
"mcpServers": {
"mcpo-docker": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "MCPO_API_KEY=your_key", "mcpo_docker_use_app"]
}
}
}Prompts to try
Once connected through OpenWebUI, you can use natural language to invoke any of the pre-built MCP integrations.
- "Search the web for the latest news on AI agents using Brave Search"
- "Fetch the content of https://example.com and summarize it"
- "Find restaurants near Tiananmen Square using Amap"Troubleshooting MCPO Docker
Container fails to start with 'MCPO_API_KEY not set' error
Ensure your .env file exists in the same directory as docker-compose.yml and contains MCPO_API_KEY=<value>. Run `docker-compose config` to verify the variable is picked up.
A specific MCP server (e.g. Tavily) does not respond after startup
Check that the relevant API key (TAVILY_API_KEY) is set in .env and that the server is listed in config.json. View logs with `docker-compose logs -f` to see installation errors during startup.
Permission errors when writing to cache directories inside the container
The container runs as a non-root user (appuser). Ensure volume mounts for .uv_cache and .npm point to directories the host user owns, or remove the explicit volume mounts to use container-local paths.
Frequently Asked Questions about MCPO Docker
What is MCPO Docker?
MCPO Docker is a Model Context Protocol (MCP) server that example docker image for mcpo（with npm,curl,nodejs,uv pre-built;pre-built mcp:amap;baidumap;server-brave-search; tavily;fetch）, a tool that exposes mcp (model context protocol) servers as openapi-compatible http endpoints for openwebui. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCPO Docker?
Follow the installation instructions on the MCPO Docker GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCPO Docker?
MCPO Docker works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCPO Docker free to use?
Yes, MCPO Docker is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCPO Docker Alternatives — Similar Cloud Services Servers
Looking for alternatives to MCPO Docker? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCPO Docker in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCPO Docker?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.