MCP Webui

项目管理器-使用MCP打开WebUI

打开WebUI与MCP（模型上下文协议）的集成，通过代理管理MongoDB数据。

快速开始

1.初始设置

# Copy environment template
cp env.template .env

# Edit .env with your MongoDB credentials
nano .env

2.运行服务

Raspberry Pi或没有GPU的系统

# Basic: Open WebUI + MCP only
docker-compose up -d

# With Ollama as Docker container (optional)
docker-compose --profile ollama up -d

# With Cloudflare Tunnel (optional)
docker-compose --profile cloudflared up -d

# With both Ollama and Cloudflare
docker-compose --profile ollama --profile cloudflared up -d

配备GPU的PC（NVIDIA）

# Basic: Open WebUI + MCP only
docker-compose -f docker-compose.gpu.yml up -d

# With Ollama as Docker container (optional)
docker-compose -f docker-compose.gpu.yml --profile ollama up -d

# With Cloudflare Tunnel (optional)
docker-compose -f docker-compose.gpu.yml --profile cloudflared up -d

# With both Ollama and Cloudflare
docker-compose -f docker-compose.gpu.yml --profile ollama --profile cloudflared up -d

💡 如果主机上安装了Ollama：

• 不要使用 ollama 个人资料
• 集 OLLAMA_BASE_URL=http://host.docker.internal:11434 在 .env （默认）

💡 如果主机上安装了Cloudflare：

• 不要使用 cloudflared 个人资料
• 直接在主机上配置Cloudflare

服务

打开webui

• 端口: 3000
• 版本: 0.6.38
• 图形处理器：已启用 docker-compose.gpu.yml，残疾 docker-compose.yml

主控程序

• 端口: 8000
• 描述：MongoDB的MCP代理
• 始终处于活动状态：是的

胶原蛋白（可选）

• 端口: 11434
• 描述：Olama服务，用于运行本地模型
• 作为容器：可选，使用 --profile ollama
• 在主机上：如果主机上安装了Ollama，请不要使用该配置文件。打开WebUI将连接到 http://host.docker.internal:11434
• 自动下载型号：使用时 ollama 配置文件、模型 OLLAMA_MODELS 自动下载

cloudflared（可选）

• 描述：Cloudflare隧道用于公共HTTPS访问
• 作为容器：可选，使用 --profile cloudflared
• 在主机上：如果主机上安装了Cloudflare，请不要使用配置文件

配置

环境变量

看 env.template 对于所有可用变量。关键变量：

• OLLAMA_BASE_URL：ollama URL（默认值： http://host.docker.internal:11434)
• OLLAMA_MODELS：要自动下载的模型（空格或逗号分隔）
• MONGODB_URI：MongoDB连接字符串
• MONGODB_READONLY：只读模式（false=读/写，true=只读）
• CLOUDFLARE_TUNNEL_TOKEN：Cloudflare隧道令牌（可选）

Ollama云模型

为了使用Ollama Cloud模型（例如。， gpt-oss:120b-cloud)，直接在Open WebUI中配置它们：

1. 首选 设置 → 连接 → API Ollama
2. 添加新连接：

- 统一资源定位符: https://ollama.com - 连接类型: 外部 - 授权: 持有者 - 钥匙：您的Ollama Cloud API密钥（从https://ollama.com/settings)

1. 保存配置

备注：本地模型使用默认的Ollama连接(http://host.docker.internal:11434 或 http://ollama:11434)，而云模型使用 https://ollama.com 连接。

Cloudflare隧道设置

使用令牌（推荐）

1. 在Cloudflare仪表板中生成令牌:

- 首选https://one.dash.cloudflare.com/ - 导航到： 零信任 → 网络 → 隧道 - 创建新隧道或选择现有隧道 - 复制生成的 令牌

1. 在中配置令牌 .env:

   CLOUDFLARE_TUNNEL_TOKEN=your_token_here

1. 启动服务:

   docker-compose --profile cloudflared up -d

项目结构

.
├── docker-compose.yml          # For Raspberry Pi (no GPU)
├── docker-compose.gpu.yml       # For PC with GPU
├── env.template                # Environment variables template
├── mcp/                        # MCP Proxy service
│   └── Dockerfile
├── scripts/                    # Utility scripts
│   └── ollama-entrypoint.sh    # Custom Ollama entrypoint
└── open-webui-config/          # Open WebUI configuration
    └── mcp/

下载Olama模型

自动（推荐）

使用时 ollama profile，模型在容器启动时自动下载：

1. 在中配置模型 .env:

   OLLAMA_MODELS=llama3.2 mistral qwen2.5

1. 从OLAMA档案开始:

   docker-compose --profile ollama up -d

1. 检查下载:

   docker-compose logs ollama

推荐型号：

• llama3.2 -平衡模型
• mistral -性能好
• qwen2.5 -西班牙语很棒
• phi3 -小而快

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。