[GH-ISSUE #627] feat: mcpo documentation is dead in the water with no quick prebuilt docker path #89

New issue

Open

opened 2026-10-18 14:08:53 +00:00 by bsakaguchi · 1 comment

bsakaguchi commented

2026-10-18 14:08:53 +00:00

Owner

Originally created by @jamesyc on GitHub (Jul 16, 2025).
Original GitHub issue: https://github.com/open-webui/docs/issues/627

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

Originally created by @jamesyc on GitHub (Jul 16, 2025). Original GitHub issue: https://github.com/open-webui/docs/issues/627 ### 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_

bsakaguchi added the

help wanted

documentation

labels

2026-10-18 14:08:53 +00:00

bsakaguchi commented

2026-10-18 14:08:54 +00:00

Author

Owner

@jamesyc commented on GitHub (Jul 16, 2025):

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 commented on GitHub (Jul 16, 2025): 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.

bsakaguchi referenced this issue

2026-10-18 14:10:26 +00:00

[PR #89] [MERGED] Add tutorial: Local LLM Setup with IPEX-LLM on Intel GPU #237