Skip to content

feat: mcpo documentation is dead in the water with no quick prebuilt docker path #627

@jamesyc

Description

@jamesyc

Check Existing Issues

  • I have searched the existing issues and discussions.

Problem Description

NOTE: THIS IS A DOCUMENTATION COMPLAINT NOT A CODE COMPLAINT

Openwebui is considered far behind in the MCP category due to how it handles MCP. This is often repeated on web forums.

https://docs.openwebui.com/openapi-servers/mcp/

https://github.com/open-webui/mcpo

The MCP documentation is... very slow to figure out a solution that doesn't impact the rest of my dev machine. I don't want to build a docker container locally! If you're making all your users run pip install natively or build a docker container to use MCP, that's a bad strategy.

If I already have a MCP server working with claude code, the user would want to do a minimum to get it working with openwebui

Desired Solution you'd like

  • Update the documentation to have a single docker command/docker compose command which instantly runs the proxy. This also means no impact to the rest of the machine, as the container would be easily removed with a docker compose down command.
    • Note: the docker-compose.yml file would be the configuration file to point to the correct MCP server

This documentation makes setup easy. Make a new folder for the proxy, copy the docker-compose.yml file there and edit it to point to the correct MCP server, run docker compose up, and that's it. The user can see what proxies are running via docker ps.

Alternatives Considered

No response

Additional Context

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationhelp wantedExtra attention is needed

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions