Skip to content

2.3.43-Satellite-mcpo.md

Latest commit

 

History

History
63 lines (42 loc) · 2.54 KB

2.3.43-Satellite-mcpo.md

File metadata and controls

63 lines (42 loc) · 2.54 KB
Raw

mcpo

Handle: mcpo
URL: http://localhost:34431

example of mcpo in open webui

Expose any MCP tool as an OpenAPI-compatible HTTP server—instantly.

mcpo is a dead-simple proxy that takes an MCP server command and makes it accessible via standard RESTful OpenAPI, so your tools "just work" with LLM agents and apps expecting OpenAPI servers.

No custom protocol. No glue code. No hassle.

Starting

# [Optional] pre-pull the image
harbor pull mcpo

# Start the service
harbor up mcpo
  • mcpo is designed to turn MCP servers into OpenAPI-compatible HTTP servers, thus making them available to any OpenAPI-compatible client, including Open WebUI.
  • Harbor will connect webui to mcpo and mcpo to metamcp automatically when started together
    • It means that you can start harbor up webui metamcp mcpo and use MCP tools in Open WebUI

Configuration

In addition to metamcp, you can specify any other MCP servers for mcpo to proxy. To do so you can manually edit included MCPO config:

# Open in your favorite editor
open $(harbor home)/services/mcpo/configs/mcpo.override.json

mcpo image has necessary dependencies to run most MCP servers, such as uvx, npx, Python, Node.js, etc. Additionally, there's also supergateway included which can help to translate between SSE and STDIO MCP protocols where needed.

Additionally, if you want to have an experience similar to Harbor services - deciding what to run on the fly:

# 1. Create a new server config
cp $(harbor home)/services/mcpo/configs/mcpo.mcp-server-time.json $(harbor home)/services/mcpo/configs/my-mcp-server.json

# 2. Edit the config
# You can use same configuration options as supported by MCPO (Claude Desktop-style MCP config)
open $(harbor home)/services/mcpo/configs/my-mcp-server.json

# 3. Add cross-file for your server
cp $(harbor home)/services/compose.x.mcpo.mcp-server-time.yml $(harbor home)/services/compose.x.mcpo.my-mcp-server.yml

# 4. In the cross-file - change the config from "mcp-server-time" to "my-mcp-server"
# 5. You can now optionally start this server with `harbor up mcpo my-mcp-server`

Following options can be set via harbor config:

# Port on the host where the mcpo service will be available
HARBOR_MCPO_HOST_PORT                 34431

Finally, you can also use harbor env to set environment variables that are supported by the service.