Add architecture

Author: iFurySt

docs/development/architecture.md

@@ -0,0 +1,43 @@
+# MCP 网关架构总览
+
+概述了 MCP Gateway 系统的整体架构，包括网关本身、管理后台、配套 API、存储机制以及与外部服务的集成方式。
+
+---
+
+## 架构图
+
+![MCP Gateway Architecture](https://www.mermaidchart.com/raw/32023f97-aaa9-4563-a4fe-2f0f4da28916?theme=light&version=v0.1&format=svg)
+
+---
+
+## 模块说明
+
+### MCP 网关（mcp-gateway）
+- **入口**：`/*` 统一监听所有 HTTP 请求，在应用层根据配置去动态分发
+- **路由层**：根据路由前缀和后缀 `/sse`、`/message`、`/mcp` 进行分发
+- **协议解析**：对 JSON-RPC 格式进行解析，提取方法与参数
+- **Tool分发**：解析工具名称，构造调用参数
+- **外部服务调用**：针对外部服务发起调用并解析结果
+- **配置存储（读取）**：加载配置信息
+
+### 管理后台（web）
+- **代理配置模块**：用于配置 MCP 网关代理/工具
+- **对话实验台**：用于测试MCP的简易Chat，主要提供给开发者和需要集成到自研系统中的用户参考
+- **用户管理模块**：用户权限、信息维护
+
+### 管理后台后端服务（apiserver）
+- **主服务模块**：提供配置管理、用户接口、聊天记录查询等 API
+- **配置存储（写入）**：将修改写入数据库
+- **通知器（发送端）**：当配置变化时通知 MCP 网关进行热更新
+
+### 配置存储
+- 存储所有 MCP 服务、工具、路由等配置
+- 支持多种实现：磁盘（yaml）、SQLite、PostgreSQL、MySQL 等
+
+### Web 数据存储
+- 存储用户数据、会话记录等
+- 支持多种实现：SQLite、PostgreSQL、MySQL 等
+
+### 外部服务
+- 工具调用所依赖的后端服务系统
+

i18n/de/docusaurus-plugin-content-docs/current/development/architecture.md

@@ -0,0 +1,42 @@
+# MCP Gateway Architekturübersicht
+
+Bietet einen Überblick über die MCP Gateway-Systemarchitektur, einschließlich des Gateways selbst, des Management-Backends, unterstützender APIs, Speichermechanismen und Integrationsmethoden mit externen Diensten.
+
+---
+
+## Architekturdiagramm
+
+![MCP Gateway Architecture](https://www.mermaidchart.com/raw/32023f97-aaa9-4563-a4fe-2f0f4da28916?theme=light&version=v0.1&format=svg)
+
+---
+
+## Modulbeschreibung
+
+### MCP Gateway (mcp-gateway)
+- **Einstiegspunkt**: `/*` Einheitlicher HTTP-Anfragen-Listener, dynamisches Routing basierend auf der Konfiguration auf Anwendungsebene
+- **Routing-Schicht**: Routing basierend auf Präfixen und Suffixen `/sse`, `/message`, `/mcp`
+- **Protokoll-Analyse**: Analysiert JSON-RPC-Format, extrahiert Methoden und Parameter
+- **Tool-Verteilung**: Analysiert Tool-Namen, konstruiert Aufrufparameter
+- **Externe Dienstaufrufe**: Initiiert Aufrufe an externe Dienste und analysiert Ergebnisse
+- **Konfigurationsspeicher (Lesen)**: Lädt Konfigurationsinformationen
+
+### Management-Backend (web)
+- **Proxy-Konfigurationsmodul**: Wird zur Konfiguration von MCP Gateway-Proxies/Tools verwendet
+- **Chat-Labor**: Einfacher Chat zum Testen von MCP, hauptsächlich für Entwickler und Benutzer, die es in selbst entwickelte Systeme integrieren müssen
+- **Benutzerverwaltungsmodul**: Wartung von Benutzerberechtigungen und -informationen
+
+### Management-Backend-Service (apiserver)
+- **Hauptdienstmodul**: Stellt APIs für Konfigurationsverwaltung, Benutzeroberfläche, Chat-Verlauf-Abfrage usw. bereit
+- **Konfigurationsspeicher (Schreiben)**: Schreibt Änderungen in die Datenbank
+- **Benachrichtiger (Sender)**: Benachrichtigt MCP Gateway über Hot-Updates bei Konfigurationsänderungen
+
+### Konfigurationsspeicher
+- Speichert alle MCP-Dienste, Tools, Routen und andere Konfigurationen
+- Unterstützt mehrere Implementierungen: Festplatte (yaml), SQLite, PostgreSQL, MySQL usw.
+
+### Web-Datenspeicher
+- Speichert Benutzerdaten, Sitzungsaufzeichnungen usw.
+- Unterstützt mehrere Implementierungen: SQLite, PostgreSQL, MySQL usw.
+
+### Externe Dienste
+- Backend-Dienstsysteme, die für Tool-Aufrufe erforderlich sind 

i18n/en/docusaurus-plugin-content-docs/current/development/architecture.md

@@ -0,0 +1,42 @@
+# MCP Gateway Architecture Overview
+
+Provides an overview of the MCP Gateway system architecture, including the gateway itself, management backend, supporting APIs, storage mechanisms, and integration methods with external services.
+
+---
+
+## Architecture Diagram
+
+![MCP Gateway Architecture](https://www.mermaidchart.com/raw/32023f97-aaa9-4563-a4fe-2f0f4da28916?theme=light&version=v0.1&format=svg)
+
+---
+
+## Module Description
+
+### MCP Gateway (mcp-gateway)
+- **Entry Point**: `/*` Unified HTTP request listener, dynamically routes based on configuration at the application layer
+- **Routing Layer**: Routes based on prefixes and suffixes `/sse`, `/message`, `/mcp`
+- **Protocol Parsing**: Parses JSON-RPC format, extracts methods and parameters
+- **Tool Distribution**: Parses tool names, constructs call parameters
+- **External Service Calls**: Initiates calls to external services and parses results
+- **Configuration Storage (Read)**: Loads configuration information
+
+### Management Backend (web)
+- **Proxy Configuration Module**: Used for configuring MCP gateway proxies/tools
+- **Chat Lab**: Simple Chat for testing MCP, mainly for developers and users who need to integrate into self-developed systems
+- **User Management Module**: User permissions and information maintenance
+
+### Management Backend Service (apiserver)
+- **Main Service Module**: Provides APIs for configuration management, user interface, chat history query, etc.
+- **Configuration Storage (Write)**: Writes modifications to the database
+- **Notifier (Sender)**: Notifies MCP gateway for hot updates when configuration changes
+
+### Configuration Storage
+- Stores all MCP services, tools, routes, and other configurations
+- Supports multiple implementations: disk (yaml), SQLite, PostgreSQL, MySQL, etc.
+
+### Web Data Storage
+- Stores user data, session records, etc.
+- Supports multiple implementations: SQLite, PostgreSQL, MySQL, etc.
+
+### External Services
+- Backend service systems required for tool calls 

i18n/es/docusaurus-plugin-content-docs/current/development/architecture.md

@@ -0,0 +1,42 @@
+# Descripción General de la Arquitectura de MCP Gateway
+
+Proporciona una visión general de la arquitectura del sistema MCP Gateway, incluyendo el gateway en sí, el backend de gestión, las APIs de soporte, los mecanismos de almacenamiento y los métodos de integración con servicios externos.
+
+---
+
+## Diagrama de Arquitectura
+
+![MCP Gateway Architecture](https://www.mermaidchart.com/raw/32023f97-aaa9-4563-a4fe-2f0f4da28916?theme=light&version=v0.1&format=svg)
+
+---
+
+## Descripción de Módulos
+
+### MCP Gateway (mcp-gateway)
+- **Punto de Entrada**: `/*` Escucha unificada de todas las solicitudes HTTP, enrutamiento dinámico basado en la configuración a nivel de aplicación
+- **Capa de Enrutamiento**: Enrutamiento basado en prefijos y sufijos `/sse`, `/message`, `/mcp`
+- **Análisis de Protocolo**: Analiza el formato JSON-RPC, extrae métodos y parámetros
+- **Distribución de Herramientas**: Analiza nombres de herramientas, construye parámetros de llamada
+- **Llamadas a Servicios Externos**: Inicia llamadas a servicios externos y analiza resultados
+- **Almacenamiento de Configuración (Lectura)**: Carga información de configuración
+
+### Backend de Gestión (web)
+- **Módulo de Configuración de Proxy**: Utilizado para configurar proxies/herramientas de MCP gateway
+- **Laboratorio de Chat**: Chat simple para probar MCP, principalmente para desarrolladores y usuarios que necesitan integrarlo en sistemas autodesarrollados
+- **Módulo de Gestión de Usuarios**: Mantenimiento de permisos e información de usuarios
+
+### Servicio Backend de Gestión (apiserver)
+- **Módulo de Servicio Principal**: Proporciona APIs para gestión de configuración, interfaz de usuario, consulta de historial de chat, etc.
+- **Almacenamiento de Configuración (Escritura)**: Escribe modificaciones en la base de datos
+- **Notificador (Emisor)**: Notifica al MCP gateway para actualizaciones en caliente cuando cambia la configuración
+
+### Almacenamiento de Configuración
+- Almacena todos los servicios MCP, herramientas, rutas y otras configuraciones
+- Soporta múltiples implementaciones: disco (yaml), SQLite, PostgreSQL, MySQL, etc.
+
+### Almacenamiento de Datos Web
+- Almacena datos de usuario, registros de sesión, etc.
+- Soporta múltiples implementaciones: SQLite, PostgreSQL, MySQL, etc.
+
+### Servicios Externos
+- Sistemas de servicios backend requeridos para llamadas de herramientas 

i18n/fr/docusaurus-plugin-content-docs/current/development/architecture.md

@@ -0,0 +1,42 @@
+# Vue d'ensemble de l'architecture de la passerelle MCP
+
+Présente une vue d'ensemble de l'architecture du système MCP Gateway, y compris la passerelle elle-même, le backend de gestion, les API de support, les mécanismes de stockage et les méthodes d'intégration avec les services externes.
+
+---
+
+## Diagramme d'architecture
+
+![MCP Gateway Architecture](https://www.mermaidchart.com/raw/32023f97-aaa9-4563-a4fe-2f0f4da28916?theme=light&version=v0.1&format=svg)
+
+---
+
+## Description des modules
+
+### Passerelle MCP (mcp-gateway)
+- **Point d'entrée** : `/*` Écoute unifiée de toutes les requêtes HTTP, routage dynamique basé sur la configuration au niveau de l'application
+- **Couche de routage** : Routage basé sur les préfixes et suffixes `/sse`, `/message`, `/mcp`
+- **Analyse de protocole** : Analyse du format JSON-RPC, extraction des méthodes et paramètres
+- **Distribution d'outils** : Analyse des noms d'outils, construction des paramètres d'appel
+- **Appels aux services externes** : Lancement des appels aux services externes et analyse des résultats
+- **Stockage de configuration (lecture)** : Chargement des informations de configuration
+
+### Backend de gestion (web)
+- **Module de configuration des proxies** : Utilisé pour configurer les proxies/outils de la passerelle MCP
+- **Laboratoire de chat** : Chat simple pour tester MCP, principalement destiné aux développeurs et aux utilisateurs qui doivent l'intégrer dans des systèmes auto-développés
+- **Module de gestion des utilisateurs** : Maintenance des permissions et informations utilisateur
+
+### Service backend de gestion (apiserver)
+- **Module de service principal** : Fournit des API pour la gestion de la configuration, l'interface utilisateur, la requête d'historique de chat, etc.
+- **Stockage de configuration (écriture)** : Écrit les modifications dans la base de données
+- **Notificateur (émetteur)** : Notifie la passerelle MCP pour les mises à jour à chaud lors des changements de configuration
+
+### Stockage de configuration
+- Stocke toutes les configurations des services MCP, outils, routes, etc.
+- Prend en charge plusieurs implémentations : disque (yaml), SQLite, PostgreSQL, MySQL, etc.
+
+### Stockage de données Web
+- Stocke les données utilisateur, les enregistrements de session, etc.
+- Prend en charge plusieurs implémentations : SQLite, PostgreSQL, MySQL, etc.
+
+### Services externes
+- Systèmes de services backend requis pour les appels d'outils 

i18n/hi/docusaurus-plugin-content-docs/current/development/architecture.md

@@ -0,0 +1,42 @@
+# MCP गेटवे आर्किटेक्चर अवलोकन
+
+MCP गेटवे सिस्टम आर्किटेक्चर का एक अवलोकन प्रदान करता है, जिसमें गेटवे स्वयं, प्रबंधन बैकएंड, सहायक API, स्टोरेज मैकेनिज्म और बाहरी सेवाओं के साथ एकीकरण के तरीके शामिल हैं।
+
+---
+
+## आर्किटेक्चर डायग्राम
+
+![MCP Gateway Architecture](https://www.mermaidchart.com/raw/32023f97-aaa9-4563-a4fe-2f0f4da28916?theme=light&version=v0.1&format=svg)
+
+---
+
+## मॉड्यूल विवरण
+
+### MCP गेटवे (mcp-gateway)
+- **प्रवेश बिंदु**: `/*` एकीकृत HTTP अनुरोध लिस्टनर, एप्लिकेशन लेयर पर कॉन्फ़िगरेशन के आधार पर गतिशील रूटिंग
+- **रूटिंग लेयर**: प्रीफिक्स और सफिक्स `/sse`, `/message`, `/mcp` के आधार पर रूटिंग
+- **प्रोटोकॉल पार्सिंग**: JSON-RPC फॉर्मेट का विश्लेषण, मेथड और पैरामीटर निकालना
+- **टूल वितरण**: टूल नामों का विश्लेषण, कॉल पैरामीटर का निर्माण
+- **बाहरी सेवा कॉल**: बाहरी सेवाओं के लिए कॉल शुरू करना और परिणामों का विश्लेषण
+- **कॉन्फ़िगरेशन स्टोरेज (पढ़ना)**: कॉन्फ़िगरेशन जानकारी लोड करना
+
+### प्रबंधन बैकएंड (web)
+- **प्रॉक्सी कॉन्फ़िगरेशन मॉड्यूल**: MCP गेटवे प्रॉक्सी/टूल्स को कॉन्फ़िगर करने के लिए उपयोग किया जाता है
+- **चैट लैब**: MCP का परीक्षण करने के लिए सरल चैट, मुख्य रूप से डेवलपर्स और स्व-विकसित सिस्टम में एकीकृत करने वाले उपयोगकर्ताओं के लिए
+- **उपयोगकर्ता प्रबंधन मॉड्यूल**: उपयोगकर्ता अनुमतियों और जानकारी का रखरखाव
+
+### प्रबंधन बैकएंड सेवा (apiserver)
+- **मुख्य सेवा मॉड्यूल**: कॉन्फ़िगरेशन प्रबंधन, उपयोगकर्ता इंटरफेस, चैट इतिहास क्वेरी आदि के लिए API प्रदान करता है
+- **कॉन्फ़िगरेशन स्टोरेज (लिखना)**: डेटाबेस में परिवर्तन लिखता है
+- **नोटिफायर (प्रेषक)**: कॉन्फ़िगरेशन परिवर्तनों पर MCP गेटवे को हॉट अपडेट के लिए सूचित करता है
+
+### कॉन्फ़िगरेशन स्टोरेज
+- सभी MCP सेवाओं, टूल्स, रूट्स और अन्य कॉन्फ़िगरेशन को संग्रहीत करता है
+- कई कार्यान्वयनों का समर्थन करता है: डिस्क (yaml), SQLite, PostgreSQL, MySQL, आदि
+
+### वेब डेटा स्टोरेज
+- उपयोगकर्ता डेटा, सत्र रिकॉर्ड आदि संग्रहीत करता है
+- कई कार्यान्वयनों का समर्थन करता है: SQLite, PostgreSQL, MySQL, आदि
+
+### बाहरी सेवाएं
+- टूल कॉल के लिए आवश्यक बैकएंड सेवा सिस्टम 

i18n/ja/docusaurus-plugin-content-docs/current/development/architecture.md

@@ -0,0 +1,42 @@
+# MCP ゲートウェイアーキテクチャ概要
+
+MCP Gateway システムの全体的なアーキテクチャを概説します。ゲートウェイ自体、管理バックエンド、サポート API、ストレージメカニズム、および外部サービスとの統合方法を含みます。
+
+---
+
+## アーキテクチャ図
+
+![MCP Gateway Architecture](https://www.mermaidchart.com/raw/32023f97-aaa9-4563-a4fe-2f0f4da28916?theme=light&version=v0.1&format=svg)
+
+---
+
+## モジュール説明
+
+### MCP ゲートウェイ（mcp-gateway）
+- **エントリーポイント**：`/*` すべての HTTP リクエストを統一的にリッスンし、アプリケーション層で設定に基づいて動的にルーティング
+- **ルーティング層**：プレフィックスとサフィックス `/sse`、`/message`、`/mcp` に基づいてルーティング
+- **プロトコル解析**：JSON-RPC 形式を解析し、メソッドとパラメータを抽出
+- **ツール配信**：ツール名を解析し、呼び出しパラメータを構築
+- **外部サービス呼び出し**：外部サービスへの呼び出しを開始し、結果を解析
+- **設定ストレージ（読み取り）**：設定情報を読み込み
+
+### 管理バックエンド（web）
+- **プロキシ設定モジュール**：MCP ゲートウェイプロキシ/ツールの設定に使用
+- **チャットラボ**：MCP のテスト用のシンプルなチャット、主に開発者と自社開発システムへの統合が必要なユーザー向け
+- **ユーザー管理モジュール**：ユーザー権限と情報の管理
+
+### 管理バックエンドサービス（apiserver）
+- **メインサービスモジュール**：設定管理、ユーザーインターフェース、チャット履歴クエリなどの API を提供
+- **設定ストレージ（書き込み）**：変更をデータベースに書き込み
+- **通知機能（送信側）**：設定変更時に MCP ゲートウェイにホットアップデートを通知
+
+### 設定ストレージ
+- すべての MCP サービス、ツール、ルートなどの設定を保存
+- 複数の実装をサポート：ディスク（yaml）、SQLite、PostgreSQL、MySQL など
+
+### Web データストレージ
+- ユーザーデータ、セッション記録などを保存
+- 複数の実装をサポート：SQLite、PostgreSQL、MySQL など
+
+### 外部サービス
+- ツール呼び出しに必要なバックエンドサービスシステム