MongoDB数据管理WebUI

通过MCP代理管理MongoDB数据的Open WebUI集成工具,支持本地模型和云服务扩展。

  • by DevStarlight
  • Shell
  • 本地部署
  • 更新于
在 GitHub 查看 DevStarlight/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)
  3. 保存配置

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

Cloudflare隧道设置

使用令牌(推荐)

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

    • 首选https://one.dash.cloudflare.com/
    • 导航到: 零信任 → 网络 → 隧道
    • 创建新隧道或选择现有隧道
    • 复制生成的 令牌
  2. 在中配置令牌 .env:

    CLOUDFLARE_TUNNEL_TOKEN=your_token_here
    
  3. 启动服务:

    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
    
  2. 从OLAMA档案开始:

    docker-compose --profile ollama up -d
    
  3. 检查下载:

    docker-compose logs ollama
    

推荐型号:

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

许可证

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