使用MCP服务器打开WebUI
此项目提供了一个Docker Compose安装程序,用于运行 打开WebUI 使用模型上下文协议(MCP)服务器。它通过使用预构建的Docker镜像和提供可定制的配置简化了部署过程。
先决条件
- 码头工人 (建议使用20.10.0或更高版本)
- (建议使用2.0.0或更高版本)
- 至少2GB的可用RAM用于运行容器
安装
- 将此存储库克隆或下载到本地计算机
- 配置您的MCP服务器(可选):
- 复制 mcpo_config_example.json 向 mcpo_config.json 如果你还没有 - 根据需要更新API密钥和其他设置(请参阅 配置 部分)
用法
启动服务
运行以下命令以启动所有服务:
./runServer.sh此脚本使用Docker Compose以分离模式启动服务,并强制重新创建容器。
或者,您可以直接运行Docker Compose命令:
docker compose up -d --force-recreate访问Web UI
服务运行后,您可以在以下位置访问Open WebUI:
http://localhost:3721停止服务
要停止所有服务,请执行以下操作:
docker compose down组件
打开WebUI
- 容器名称:
open-webui - 图片:
ghcr.io/open-webui/open-webui:main - 港口:3721(从集装箱港口8080映射)
- 持续体积:
open-webui用于存储应用程序数据
Open WebUI是一个基于web的用户界面,通过MCP服务器提供对各种AI功能的访问。
MCPO(模型上下文协议编排器)
- 容器名称:
mcpo - 图片:
ghcr.io/open-webui/mcpo:main - 港口:3722(从集装箱港口8000映射)
- 配置:用途
mcpo_config.json从主机装载
MCPO管理和协调多个提供各种功能的MCP服务器:
- 内存服务器:提供存储和检索信息的内存功能
- 时间服务器:提供与时间相关的功能,支持上海时区
- 快速图表服务器:生成图表和可视化
- Excel服务器:处理Excel文件和数据
- AMap服务器:提供映射和定位服务(需要API密钥)
- 获取服务器:处理HTTP请求和响应
配置
这 mcpo_config.json 该文件定义了Open WebUI可用的MCP服务器。每个服务器都有自己的配置,包括命令、参数和环境变量。
配置示例
示例配置文件(mcpo_config_example.json)作为模板提供。要使用它:
cp mcpo_config_example.json mcpo_config.json然后编辑 mcpo_config.json 添加API密钥并自定义设置。
API密钥
一些MCP服务器需要API密钥才能正常工作:
- AMap服务器:需要AMap API密钥。替换
YOUR_API_KEY_HERE使用您的实际API密钥。
要获取AMap API密钥,请访问 AMap开发平台.
安全说明
- 永远不要承诺你的
mcpo_config.json具有公共存储库的实际API密钥的文件 - 考虑在生产部署中使用环境变量或机密管理器
- 示例配置文件(
mcpo_config_example.json)不应包含实际的API密钥
故障排除
常见问题
- 服务无法启动:
- 检查Docker日志: docker logs open-webui 或 docker logs mcpo - 确保端口3721和3722未被其他应用程序使用
- 无法连接到Web UI:
- 验证容器是否正在运行: docker ps - 检查服务是否可以在正确的端口上访问
- MCP服务器不工作:
- 验证API密钥是否在中正确设置 mcpo_config.json - 检查MCPO日志中的连接错误: docker logs mcpo
许可证
此项目使用可能有自己许可证的组件。请参考原始存储库以获取许可证信息:
