docs: update doc

Author: tianzhou

CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 # DBHub Development Guidelines
 
-DBHub is a Minimal Database MCP Server implementing the Model Context Protocol (MCP) server interface. This lightweight server bridges MCP-compatible clients (Claude Desktop, Claude Code, Cursor) with various database systems.
+DBHub is a zero-dependency, minimal database MCP server implementing the Model Context Protocol (MCP) server interface. This lightweight server bridges MCP-compatible clients (Claude Desktop, Claude Code, Cursor) with various database systems.
 
 ## Commands
 

README.md

@@ -30,7 +30,7 @@
                  MCP Clients           MCP Server             Databases
 ```
 
-DBHub is a Minimal Database MCP Server implementing the Model Context Protocol (MCP) server interface. This lightweight gateway allows MCP-compatible clients to connect to and explore different databases:
+DBHub is a zero-dependency, minimal database MCP server implementing the Model Context Protocol (MCP) server interface. This lightweight gateway allows MCP-compatible clients to connect to and explore different databases:
 
 - **Token Efficient**: Just two general MCP tools (execute_sql, search_objects) to minimize context window usage, plus support for custom tools
 - **Multi-Database**: Single interface for PostgreSQL, MySQL, MariaDB, SQL Server, and SQLite
@@ -50,6 +50,12 @@ DBHub implements MCP tools for database operations:
 - **[search_objects](https://dbhub.ai/tools/search-objects)**: Search and explore database schemas, tables, columns, indexes, and procedures with progressive disclosure
 - **[Custom Tools](https://dbhub.ai/tools/custom-tools)**: Define reusable, parameterized SQL operations in your `dbhub.toml` configuration file
 
+## Workbench
+
+DBHub includes a [built-in web interface](https://dbhub.ai/workbench/overview) for interacting with your database tools. It provides a visual way to execute queries, run custom tools, and view request traces without requiring an MCP client.
+
+![workbench](https://raw.githubusercontent.com/bytebase/dbhub/main/docs/images/workbench/workbench.webp)
+
 ## Installation
 
 See the full [Installation Guide](https://dbhub.ai/installation) for detailed instructions.

docs/docs.json

@@ -34,7 +34,7 @@
             "pages": [
               "workbench/overview",
               "workbench/tool-execution",
-              "workbench/request-history"
+              "workbench/request-trace"
             ]
           },
           {

docs/index.mdx

@@ -12,7 +12,7 @@ title: "Introduction"
   src="/images/logo/full-dark.svg"
 />
 
-DBHub is a minimal database MCP server that implements the Model Context Protocol server interface. This lightweight gateway enables AI-powered tools like Claude Desktop, Claude Code, Cursor, and VS Code Copilot to securely connect to and interact with your databases.
+DBHub is a zero-dependency, minimal database MCP server that implements the Model Context Protocol server interface. This lightweight gateway enables AI-powered tools like Claude Desktop, Claude Code, Cursor, and VS Code Copilot to securely connect to and interact with your databases.
 
 ```
  +------------------+    +--------------+    +------------------+
@@ -49,40 +49,61 @@ DBHub brings powerful database capabilities to AI coding assistants:
 
 ## Key Features
 
-### Database Exploration
+### MCP Tools
 
-AI assistants can discover and explore your database schema:
-- List schemas, tables, and columns
-- View table structures and relationships
-- Inspect indexes and stored procedures
-- Understand database constraints
+DBHub provides AI assistants with direct database access through three core tools:
+- **[execute_sql](/tools/execute-sql)**: Run queries with transaction support and safety controls
+- **[search_objects](/tools/search-objects)**: Explore schemas, tables, columns, indexes, and procedures
+- **[Custom Tools](/tools/custom-tools)**: Define reusable, parameterized SQL operations
 
-### SQL Execution
+### Workbench
 
-Execute SQL queries directly from AI tools:
-- Run SELECT queries for data analysis
-- Execute DDL/DML in read-write mode
-- Support for parameterized queries
-- Multi-statement execution with transaction support
+A [web-based interface](/workbench/overview) for running database tools and viewing request traces without requiring an MCP client.
 
-### AI Assistant Capabilities
+## Architecture
 
-DBHub enables AI assistants to:
-- Generate optimized SQL queries
-- Explain database elements and relationships
-- Suggest schema improvements
-- Debug complex queries
+```mermaid
+flowchart TB
+    %% Human User
+    User["Human User"]
 
-### Security Features
+    %% Workbench
+    WB["DBHub Workbench"]
 
-- **Read-only Mode**: Restrict operations to SELECT queries only
-- **SSH Tunneling**: Secure connections through bastion hosts
-- **SSL/TLS**: Encrypted database connections
-- **Row Limiting**: Prevent accidental large data retrieval
+    %% AI Agent with MCP Client
+    subgraph Agent["AI Agent"]
+        MC["MCP Client"]
+    end
 
-### Workbench
+    %% Configuration
+    Config["dbhub.toml"]
+
+    %% DBHub Server
+    subgraph DBHub["DBHub Server"]
+        MCP["/mcp endpoint"]
+        subgraph Tools["MCP Tools"]
+            ES["execute_sql"]
+            SO["search_objects"]
+            CT["custom tools"]
+        end
+    end
+
+    %% Databases
+    Databases["PostgreSQL, MySQL, SQL Server, MariaDB, SQLite"]
+
+    %% Connections
+    User --> WB
+    WB --> DBHub
+
+    Agent --> MC
+    MC --> MCP
+    MCP --> Tools
+
+    Config -.->|loads| DBHub
+    Tools --> Databases
+```
 
-A [web-based interface](/workbench/overview) for exploring data sources and executing tools directly in your browser.
+DBHub acts as a gateway between databases and AI agents. AI agents access databases through the `/mcp` endpoint using MCP tools, while the Workbench provides direct browser-based access for humans.
 
 ## Getting Started
 

docs/workbench/overview.mdx

@@ -3,7 +3,7 @@ title: "Overview"
 description: "A web-based interface for exploring and executing database tools"
 ---
 
-The Workbench is DBHub's built-in web interface for interacting with your database tools. It provides a visual way to execute queries and test custom tools without requiring an MCP client.
+The Workbench is DBHub's built-in web interface for interacting with your database tools. It provides a visual way to execute queries, run custom tools, and view request traces without requiring an MCP client.
 
 ![workbench](https://raw.githubusercontent.com/bytebase/dbhub/main/docs/images/workbench/workbench.webp)
 

docs/workbench/request-history.mdx

@@ -0,0 +1,12 @@
+---
+title: "Request Trace"
+description: "View recent tool execution traces"
+---
+
+The Request Trace page (`/requests`) displays recent tool executions, helping you track queries and debug issues.
+
+![request-trace](https://raw.githubusercontent.com/bytebase/dbhub/main/docs/images/workbench/request-trace.webp)
+
+## Data Retention
+
+Request traces are stored in memory (resets on restart), keeping the latest 100 requests per source.