MCP Web Ui

🚀 MCP Web 網頁項目

MCP Web 網頁項目基於模型上下文協議（Model Context Protocol），打造了一個用戶友好的網頁應用。它能讓用戶輕鬆與各類機器學習模型和服務展開交互，極大提升了使用體驗。

🚀 快速開始

MCP Web 網頁項目是一個強大的基於模型上下文協議的網頁應用。在開始使用前，請確保滿足先決條件，然後按照安裝指南完成項目的安裝與啟動。

✨ 主要特性

• 多模型支持：集成多種不同的機器學習模型和服務器。
• 靈活配置：通過 YAML 格式的配置文件，輕鬆管理不同模型的服務參數。
• 日誌記錄：提供詳細的日誌記錄功能，便於調試和監控系統運行狀態。
• 擴展性好：支持自定義擴展，允許用戶添加新的模型和服務。

📦 安裝指南

先決條件

1. 安裝 Go 語言環境（版本 1.20 或以上）。
2. 確保已安裝 Node.js 和 npm，用於構建靜態資源。
3. 安裝 Docker 和 Docker Compose，用於容器化部署。

安裝步驟

下載代碼

使用 Git 克隆項目倉庫：

git clone https://github.com/yourusername/mcp-web.git
cd mcp-web

依賴管理

安裝項目所需的 Go 模塊：

go mod tidy

構建項目

運行以下命令構建可執行文件：

go build -o mcp-web .

啟動應用

啟動 MCP Web 網頁項目的命令如下：

./mcp-web --config ./configs/default.yaml

默認配置文件位於 configs/default.yaml。

📚 詳細文檔

配置文件說明

項目的配置文件使用 YAML 格式，主要包含以下內容：

核心配置

• 端口設置：指定應用運行的監聽端口。

  port: 8080
  

• 日誌級別：控制輸出的日誌詳細程度。

  logLevel: info
  

模型服務配置

主模型配置

llm:
  provider: anthropic  # 可選值：anthropic, openai, custom
  model: claude-3-5-sonnet-20241022
  parameters:
    temperature: 0.7

標題生成配置

genTitleLLM:
  provider: openai
  model: gpt-3.5-turbo

MCP 服務器配置

SSE 服務器配置

mcpSSEServers:
  filesystem:
    url: https://yoursseserver.com
    maxPayloadSize: 1048576 # 單位：字節，默認為1MB

標準輸入輸出服務器配置

mcpStdIOServers:
  filesystem:
    command: npx
    args:
      - -y
      - "@modelcontextprotocol/server-filesystem"
      - "/path/to/your/files"

示例配置文件

port: 8080
logLevel: info

llm:
  provider: anthropic
  model: claude-3-5-sonnet-20241022
  parameters:
    temperature: 0.7

genTitleLLM:
  provider: openai
  model: gpt-3.5-turbo

項目結構

mcp-web/
├── cmd/               # 應用入口文件
├── internal/         # 核心業務邏輯包
│   ├── handlers/     # Web 請求處理函數
│   ├── models/       # 數據模型定義
│   └── services/     # 第三方服務集成（如模型接口）
├── static/           # 靜態資源文件（CSS、JS 等）
└── templates/        # HTML 模板文件

貢獻指南

1. ** Fork 項目倉庫。
2. 在你的分支上進行代碼修改。
3. 提交併推送修改內容。
4. 創建 Pull Request 提交到主分支。

📄 許可證

本項目遵循 MIT 許可證協議。