MCP Web UI

MCP Web UI

site icon
2025.04.17 43
GoLLM 交互上下文管理实时聊天开发效率交流协作
MCP Web UI 是一个基于 Web 的用户界面,作为模型上下文协议(MCP)架构中的主机,提供了一个强大且用户友好的界面,用于与大型语言模型(LLMs)交互,同时管理客户端和服务器之间的上下文聚合和协调。
View on GitHub

Overview

基本能力

产品定位

MCP Web UI 是一个基于 Web 的用户界面,用于与大型语言模型(LLMs)交互,管理上下文聚合和协调。

核心功能

  • 多提供商 LLM 集成:支持 Anthropic、OpenAI、Ollama 和 OpenRouter 等多种 LLM 提供商。
  • 直观的聊天界面:提供用户友好的聊天体验。
  • 实时响应流:通过服务器发送事件(SSE)实现实时响应流。
  • 动态配置管理:灵活配置和管理模型。
  • 高级上下文聚合:强大的上下文处理能力。
  • 持久化聊天历史:使用 BoltDB 存储聊天历史。
  • 灵活的模型选择:支持多种模型选择。

适用场景

  • 开发人员需要与多种 LLM 提供商交互的场景。
  • 需要实时聊天和上下文管理的应用。
  • 需要灵活配置和管理模型的项目。

工具列表

  • BoltDB:用于持久化聊天历史。
  • Docker:用于容器化部署。
  • Go:用于本地开发和运行。

常见问题解答

  • 如何配置 API 密钥?通过环境变量设置 API 密钥。
  • 如何自定义模型行为?通过 config.yaml 文件中的 parameters 部分进行配置。

使用教程

使用依赖

  • Go 1.23+bash sudo apt-get install golang
  • Docker(可选)bash sudo apt-get install docker.io

安装教程

  1. 克隆仓库: bash git clone https://github.com/MegaGrindStone/mcp-web-ui.git cd mcp-web-ui
  2. 配置环境: bash mkdir -p $HOME/.config/mcpwebui cp config.example.yaml $HOME/.config/mcpwebui/config.yaml
  3. 设置 API 密钥: bash export ANTHROPIC_API_KEY=your_anthropic_key export OPENAI_API_KEY=your_openai_key export OPENROUTER_API_KEY=your_openrouter_key

运行应用

本地开发:

go mod download
go run ./cmd/server/main.go

Docker 部署:

docker build -t mcp-web-ui .
docker run -p 8080:8080 \
  -v $HOME/.config/mcpwebui/config.yaml:/app/config.yaml \
  -e ANTHROPIC_API_KEY \
  -e OPENAI_API_KEY \
  -e OPENROUTER_API_KEY \
  mcp-web-ui

调试方式

  • 检查日志: bash tail -f /var/log/mcp-web-ui.log
  • 检查端口: bash netstat -tuln | grep 8080

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。