MCP Web Ui

🚀 MCP Web Web Project

The MCP Web project is a web application based on the Model Context Protocol. It offers a user - friendly interface for interacting with various machine learning models and services.

🚀 Quick Start

The MCP Web project is a web application built upon the Model Context Protocol. It provides an intuitive interface that enables users to interact with diverse machine learning models and services.

✨ Features

• Multi - model Support: Integrates multiple different machine learning models and servers.
• Flexible Configuration: Easily manage service parameters of different models through YAML - formatted configuration files.
• Logging: Offers detailed logging functionality, facilitating debugging and monitoring of the system's running status.
• Good Scalability: Supports custom extensions, allowing users to add new models and services.

📦 Prerequisites

1. Install the Go programming language environment (version 1.20 or higher).
2. Ensure that Node.js and npm are installed for building static resources.
3. Install Docker and Docker Compose for containerized deployment.

📦 Installation

Download the Code

Clone the project repository using Git:

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

Dependency Management

Install the required Go modules for the project:

go mod tidy

Build the Project

Run the following command to build the executable file:

go build -o mcp-web .

Start the Application

Start the MCP Web project with the following command:

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

The default configuration file is located at configs/default.yaml.

📚 Documentation

Configuration File Explanation

The project's configuration file uses the YAML format and mainly includes the following content:

Core Configuration

• Port Settings: Specify the listening port for the application to run.

  port: 8080
  

• Log Level: Control the detail level of the output logs.

  logLevel: info
  

Model Service Configuration

Main Model Configuration

llm:
  provider: anthropic  # Optional values: anthropic, openai, custom
  model: claude-3-5-sonnet-20241022
  parameters:
    temperature: 0.7

Title Generation Configuration

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

MCP Server Configuration

SSE Server Configuration

mcpSSEServers:
  filesystem:
    url: https://yoursseserver.com
    maxPayloadSize: 1048576 # Unit: bytes, default is 1MB

Standard Input - Output Server Configuration

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

Example Configuration File

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

Project Structure

mcp-web/
├── cmd/               # Application entry files
├── internal/         # Core business logic packages
│   ├── handlers/     # Web request handling functions
│   ├── models/       # Data model definitions
│   └── services/     # Third - party service integrations (e.g., model interfaces)
├── static/           # Static resource files (CSS, JS, etc.)
└── templates/        # HTML template files

Contribution Guidelines

1. Fork the project repository.
2. Make code modifications on your branch.
3. Commit and push the modified content.
4. Create a Pull Request and submit it to the main branch.

📄 License

This project is licensed under the MIT License.