docs icon indicating copy to clipboard operation
docs copied to clipboard

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

Open jamesyc opened this issue 6 months ago • 1 comments

Check Existing Issues

  • [x] 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

jamesyc avatar Jul 16 '25 09:07 jamesyc

In summary: Yes, I am capable of figuring out how to set up the docker instance myself. No, I do not enjoy spending 15 mins doing that and building a dockerfile, and that's bad user experience. That's too much friction.

jamesyc avatar Jul 16 '25 09:07 jamesyc