Add OpenAPI specification generation for OpenWebUI integration (#295)

Co-authored-by: samanhappy <samanhappy@gmail.com>

.dockerignore

@@ -0,0 +1 @@
+.git

Dockerfile

@@ -2,12 +2,6 @@ FROM python:3.13-slim-bookworm AS base
 
 COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 
-# 添加 HTTP_PROXY 和 HTTPS_PROXY 环境变量
-ARG HTTP_PROXY=""
-ARG HTTPS_PROXY=""
-ENV HTTP_PROXY=$HTTP_PROXY
-ENV HTTPS_PROXY=$HTTPS_PROXY
-
 RUN apt-get update && apt-get install -y curl gnupg git \
   && curl -fsSL https://deb.nodesource.com/setup_22.x | bash - \
   && apt-get install -y nodejs \
@@ -15,15 +9,6 @@ RUN apt-get update && apt-get install -y curl gnupg git \
 
 RUN npm install -g pnpm
 
-ARG REQUEST_TIMEOUT=60000
-ENV REQUEST_TIMEOUT=$REQUEST_TIMEOUT
-
-ARG BASE_PATH=""
-ENV BASE_PATH=$BASE_PATH
-
-ARG READONLY=false
-ENV READONLY=$READONLY
-
 ENV PNPM_HOME=/usr/local/share/pnpm
 ENV PATH=$PNPM_HOME:$PATH
 RUN mkdir -p $PNPM_HOME && \

QWEN.md

@@ -0,0 +1,126 @@
+# MCPHub Project Overview
+
+## Project Summary
+
+MCPHub is a centralized hub server for managing multiple Model Context Protocol (MCP) servers. It allows organizing these servers into flexible Streamable HTTP (SSE) endpoints, supporting access to all servers, individual servers, or logical server groups. It provides a web dashboard for monitoring and managing servers, along with features like authentication, group-based access control, and Smart Routing using vector semantic search.
+
+## Technology Stack
+
+### Backend
+- **Language:** TypeScript (Node.js)
+- **Framework:** Express
+- **Key Libraries:**
+  - `@modelcontextprotocol/sdk`: Core library for MCP interactions.
+  - `typeorm`: ORM for database interactions.
+  - `pg` & `pgvector`: PostgreSQL database and vector support.
+  - `jsonwebtoken` & `bcryptjs`: Authentication (JWT) and password hashing.
+  - `openai`: For embedding generation in Smart Routing.
+  - Various utility and validation libraries (e.g., `dotenv`, `express-validator`, `uuid`).
+
+### Frontend
+- **Framework:** React (via Vite)
+- **Language:** TypeScript
+- **UI Library:** Tailwind CSS
+- **Routing:** `react-router-dom`
+- **Internationalization:** `i18next`
+- **Component Structure:** Modular components and pages within `frontend/src`.
+
+### Infrastructure
+- **Build Tool:** `pnpm` (package manager and script runner).
+- **Containerization:** Docker (`Dockerfile` provided).
+- **Process Management:** Not explicitly defined in core files, but likely managed by Docker or host system.
+
+## Key Features
+
+- **MCP Server Management:** Configure, start, stop, and monitor multiple upstream MCP servers via `stdio`, `SSE`, or `Streamable HTTP` protocols.
+- **Centralized Dashboard:** Web UI for server status, group management, user administration, and logs.
+- **Flexible Endpoints:**
+  - Global MCP/SSE endpoint (`/mcp`, `/sse`) for all enabled servers.
+  - Group-based endpoints (`/mcp/{group}`, `/sse/{group}`).
+  - Server-specific endpoints (`/mcp/{server}`, `/sse/{server}`).
+  - Smart Routing endpoint (`/mcp/$smart`, `/sse/$smart`) using vector search.
+- **Authentication & Authorization:** JWT-based user authentication with role-based access control (admin/user).
+- **Group Management:** Logical grouping of servers for targeted access and permission control.
+- **Smart Routing (Experimental):** Uses pgvector and OpenAI embeddings to semantically search and find relevant tools across all connected servers.
+- **Configuration:** Managed via `mcp_settings.json`.
+- **Logging:** Server logs are captured and viewable via the dashboard.
+- **Marketplace Integration:** Access to a marketplace of MCP servers (`servers.json`).
+
+## Project Structure
+
+```
+C:\code\mcphub\
+├───src\                  # Backend source code (TypeScript)
+├───frontend\             # Frontend source code (React/TypeScript)
+│   ├───src\
+│       ├───components\   # Reusable UI components
+│       ├───pages\        # Top-level page components
+│       ├───contexts\     # React contexts (Auth, Theme, Toast)
+│       ├───layouts\      # Page layouts
+│       ├───utils\        # Frontend utilities
+│       └───...
+├───dist\                 # Compiled backend output
+├───frontend\dist\        # Compiled frontend output
+├───tests\                # Backend tests
+├───docs\                 # Documentation
+├───scripts\              # Utility scripts
+├───bin\                  # CLI entry points
+├───assets\               # Static assets (e.g., images for README)
+├───.github\              # GitHub workflows
+├───.vscode\              # VS Code settings
+├───mcp_settings.json     # Main configuration file for MCP servers and users
+├───servers.json          # Marketplace server definitions
+├───package.json          # Node.js project definition, dependencies, and scripts
+├───pnpm-lock.yaml        # Dependency lock file
+├───tsconfig.json         # TypeScript compiler configuration (Backend)
+├───README.md             # Project documentation
+├───Dockerfile            # Docker image definition
+└───...
+```
+
+## Building and Running
+
+### Prerequisites
+- Node.js (>=18.0.0 or >=20.0.0)
+- pnpm
+- Python 3.13 (for some upstream servers and uvx)
+- Docker (optional, for containerized deployment)
+- PostgreSQL with pgvector (optional, for Smart Routing)
+
+### Local Development
+1.  Clone the repository.
+2.  Install dependencies: `pnpm install`.
+3.  Start development servers: `pnpm dev`.
+    - This runs `pnpm backend:dev` (Node.js with `tsx watch`) and `pnpm frontend:dev` (Vite dev server) concurrently.
+    - Access the dashboard at `http://localhost:5173` (Vite default) or the configured port/path.
+
+### Production Build
+1.  Install dependencies: `pnpm install`.
+2.  Build the project: `pnpm build`.
+    - This runs `pnpm backend:build` (TypeScript compilation to `dist/`) and `pnpm frontend:build` (Vite build to `frontend/dist/`).
+3.  Start the production server: `pnpm start`.
+    - This runs `node dist/index.js`.
+
+### Docker Deployment
+- Pull the image: `docker pull samanhappy/mcphub`.
+- Run with default settings: `docker run -p 3000:3000 samanhappy/mcphub`.
+- Run with custom config: `docker run -p 3000:3000 -v ./mcp_settings.json:/app/mcp_settings.json -v ./data:/app/data samanhappy/mcphub`.
+- Access the dashboard at `http://localhost:3000`.
+
+## Configuration
+
+The main configuration file is `mcp_settings.json`. It defines:
+- `mcpServers`: A map of server configurations (command, args, env, URL, etc.).
+- `users`: A list of user accounts (username, hashed password, admin status).
+- `groups`: A map of server groups.
+- `systemConfig`: System-wide settings (e.g., proxy, registry, installation options).
+
+## Development Conventions
+
+- **Language:** TypeScript for both backend and frontend.
+- **Backend Style:** Modular structure with clear separation of concerns (controllers, services, models, middlewares, routes, config, utils).
+- **Frontend Style:** Component-based React architecture with contexts for state management.
+- **Database:** TypeORM with PostgreSQL is used, leveraging decorators for entity definition.
+- **Testing:** Uses `jest` for backend testing.
+- **Linting/Formatting:** Uses `eslint` and `prettier`.
+- **Scripts:** Defined in `package.json` under the `scripts` section for common tasks (dev, build, start, test, lint, format).

README.md

@@ -6,6 +6,11 @@ MCPHub makes it easy to manage and scale multiple MCP (Model Context Protocol) s
 
 ![Dashboard Preview](assets/dashboard.png)
 
+## 🌐 Live Demo & Docs
+
+- **Documentation**: [docs.mcphubx.com](https://docs.mcphubx.com/)
+- **Demo Environment**: [demo.mcphubx.com](https://demo.mcphubx.com/)
+
 ## 🚀 Features
 
 - **Broadened MCP Server Support**: Seamlessly integrate any MCP server with minimal configuration.

README.zh.md

@@ -6,6 +6,11 @@ MCPHub 通过将多个 MCP（Model Context Protocol）服务器组织为灵活
 
 ![控制面板预览](assets/dashboard.zh.png)
 
+## 🌐 在线文档与演示
+
+- **文档地址**: [docs.mcphubx.com](https://docs.mcphubx.com/)
+- **演示环境**: [demo.mcphubx.com](https://demo.mcphubx.com/)
+
 ## 🚀 功能亮点
 
 - **广泛的 MCP 服务器支持**：无缝集成任何 MCP 服务器，配置简单。

articals/intro.md

@@ -48,11 +48,11 @@ MCPHub 已内置多个常用 MCP 服务，如高德地图、GitHub、Slack、Fet
 
 ![配置高德地图](../assets/amap-edit.png)
 
-点击保存后，MCP Hub 将自动重启高德地图的 MCP 服务，使新配置生效。
+点击保存后，MCPHub 将自动重启高德地图的 MCP 服务，使新配置生效。
 
-### 配置 MCP Hub SSE
+### 配置 MCPHub SSE
 
-MCP Hub 提供了单一聚合的 MCP Server SSE 端点：`http://localhost:3000/sse`，可在任意支持 MCP 的客户端中配置使用。这里我们选择开源的 Cherry Studio 进行演示。
+MCPHub 提供了单一聚合的 MCP Server SSE 端点：`http://localhost:3000/sse`，可在任意支持 MCP 的客户端中配置使用。这里我们选择开源的 Cherry Studio 进行演示。
 
 ![配置 Cherry Studio](../assets/cherry-mcp.png)
 

docs/api-reference/auth.mdx

@@ -0,0 +1,147 @@
+---
+title: "Authentication"
+description: "Manage users and authentication."
+---
+
+import { Card, Cards } from 'mintlify';
+
+<Card
+  title="POST /api/auth/login"
+  href="#login"
+>
+  Log in to get a JWT token.
+</Card>
+
+<Card
+  title="POST /api/auth/register"
+  href="#register"
+>
+  Register a new user.
+</Card>
+
+<Card
+  title="GET /api/auth/user"
+  href="#get-current-user"
+>
+  Get the currently authenticated user.
+</Card>
+
+<Card
+  title="POST /api/auth/change-password"
+  href="#change-password"
+>
+  Change the password for the current user.
+</Card>
+
+---
+
+### Login
+
+Authenticates a user and returns a JWT token along with user details.
+
+- **Endpoint**: `/api/auth/login`
+- **Method**: `POST`
+- **Body**:
+  - `username` (string, required): The user's username.
+  - `password` (string, required): The user's password.
+- **Request Example**:
+  ```json
+  {
+    "username": "admin",
+    "password": "admin123"
+  }
+  ```
+- **Success Response**:
+  ```json
+  {
+    "success": true,
+    "message": "Login successful",
+    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+    "user": {
+      "username": "admin",
+      "isAdmin": true,
+      "permissions": { ... }
+    }
+  }
+  ```
+
+---
+
+### Register
+
+Registers a new user and returns a JWT token.
+
+- **Endpoint**: `/api/auth/register`
+- **Method**: `POST`
+- **Body**:
+  - `username` (string, required): The desired username.
+  - `password` (string, required): The desired password (must be at least 6 characters).
+  - `isAdmin` (boolean, optional): Whether the user should have admin privileges.
+- **Request Example**:
+  ```json
+  {
+    "username": "newuser",
+    "password": "password123",
+    "isAdmin": false
+  }
+  ```
+- **Success Response**:
+  ```json
+  {
+    "success": true,
+    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+    "user": {
+      "username": "newuser",
+      "isAdmin": false,
+      "permissions": { ... }
+    }
+  }
+  ```
+
+---
+
+### Get Current User
+
+Retrieves the profile of the currently authenticated user.
+
+- **Endpoint**: `/api/auth/user`
+- **Method**: `GET`
+- **Authentication**: Bearer Token required.
+- **Success Response**:
+  ```json
+  {
+    "success": true,
+    "user": {
+      "username": "admin",
+      "isAdmin": true,
+      "permissions": { ... }
+    }
+  }
+  ```
+
+---
+
+### Change Password
+
+Allows the authenticated user to change their password.
+
+- **Endpoint**: `/api/auth/change-password`
+- **Method**: `POST`
+- **Authentication**: Bearer Token required.
+- **Body**:
+  - `currentPassword` (string, required): The user's current password.
+  - `newPassword` (string, required): The desired new password (must be at least 6 characters).
+- **Request Example**:
+  ```json
+  {
+    "currentPassword": "oldpassword",
+    "newPassword": "newpassword123"
+  }
+  ```
+- **Success Response**:
+  ```json
+  {
+    "success": true,
+    "message": "Password updated successfully"
+  }
+  ```

docs/api-reference/config.mdx

@@ -0,0 +1,111 @@
+---
+title: "Config"
+description: "Manage and retrieve system-wide configurations."
+---
+
+import { Card, Cards } from 'mintlify';
+
+<Card title="PUT /api/system-config" href="#update-system-config">Update the main system configuration.</Card>
+<Card title="GET /api/settings" href="#get-all-settings">Get all system settings, including servers and groups.</Card>
+<Card title="GET /config" href="#get-runtime-config">Get public runtime configuration for the frontend.</Card>
+<Card title="GET /public-config" href="#get-public-config">Get public configuration to check for auth skip.</Card>
+
+---
+
+### Update System Config
+
+Updates various parts of the system configuration. You only need to provide the keys for the sections you want to update.
+
+- **Endpoint**: `/api/system-config`
+- **Method**: `PUT`
+- **Body**: A JSON object containing one or more of the following top-level keys: `routing`, `install`, `smartRouting`, `mcpRouter`.
+
+#### Routing Configuration (`routing`)
+
+- `enableGlobalRoute` (boolean): Enable or disable the global `/api/mcp` route.
+- `enableGroupNameRoute` (boolean): Enable or disable group-based routing (e.g., `/api/mcp/group/:groupName`).
+- `enableBearerAuth` (boolean): Enable bearer token authentication for MCP routes.
+- `bearerAuthKey` (string): The secret key to use for bearer authentication.
+- `skipAuth` (boolean): If true, skips all authentication, making the instance public.
+
+#### Install Configuration (`install`)
+
+- `pythonIndexUrl` (string): The base URL of the Python Package Index (PyPI) to use for installations.
+- `npmRegistry` (string): The URL of the npm registry to use for installations.
+- `baseUrl` (string): The public base URL of this MCPHub instance.
+
+#### Smart Routing Configuration (`smartRouting`)
+
+- `enabled` (boolean): Enable or disable the Smart Routing feature.
+- `dbUrl` (string): The database connection URL for storing embeddings.
+- `openaiApiBaseUrl` (string): The base URL for the OpenAI-compatible API for generating embeddings.
+- `openaiApiKey` (string): The API key for the embeddings service.
+- `openaiApiEmbeddingModel` (string): The name of the embedding model to use.
+
+#### MCP Router Configuration (`mcpRouter`)
+
+- `apiKey` (string): The API key for the MCP Router service.
+- `referer` (string): The referer header to use for MCP Router requests.
+- `title` (string): The title to display for this instance on MCP Router.
+- `baseUrl` (string): The base URL for the MCP Router API.
+
+- **Request Example**:
+  ```json
+  {
+    "routing": {
+      "skipAuth": true
+    },
+    "smartRouting": {
+      "enabled": true,
+      "dbUrl": "postgresql://user:pass@host:port/db"
+    }
+  }
+  ```
+
+---
+
+### Get All Settings
+
+Retrieves the entire settings object for the instance, including all server configurations, groups, and system settings. This is a comprehensive dump of the `mcp_settings.json` file.
+
+- **Endpoint**: `/api/settings`
+- **Method**: `GET`
+
+---
+
+### Get Runtime Config
+
+Retrieves the essential runtime configuration required for the frontend application. This endpoint does not require authentication.
+
+- **Endpoint**: `/config`
+- **Method**: `GET`
+- **Success Response**:
+  ```json
+  {
+    "success": true,
+    "data": {
+      "basePath": "",
+      "version": "1.0.0",
+      "name": "MCPHub"
+    }
+  }
+  ```
+
+---
+
+### Get Public Config
+
+Retrieves public configuration, primarily to check if authentication is skipped. This allows the frontend to adjust its behavior accordingly before a user has logged in. This endpoint does not require authentication.
+
+- **Endpoint**: `/public-config`
+- **Method**: `GET`
+- **Success Response**:
+  ```json
+  {
+    "success": true,
+    "data": {
+      "skipAuth": false,
+      "permissions": {}
+    }
+  }
+  ```

docs/api-reference/endpoint/create.mdx

@@ -1,4 +0,0 @@
----
-title: 'Create Plant'
-openapi: 'POST /plants'
----

docs/api-reference/endpoint/delete.mdx

@@ -1,4 +0,0 @@
----
-title: 'Delete Plant'
-openapi: 'DELETE /plants/{id}'
----

docs/api-reference/endpoint/get.mdx

@@ -1,4 +0,0 @@
----
-title: 'Get Plants'
-openapi: 'GET /plants'
----

docs/api-reference/endpoint/webhook.mdx

@@ -1,4 +0,0 @@
----
-title: 'New Plant'
-openapi: 'WEBHOOK /plant/webhook'
----

docs/api-reference/groups.mdx

@@ -0,0 +1,212 @@
+---
+title: "Groups"
+description: "Manage server groups to organize and route requests."
+---
+
+import { Card, Cards } from 'mintlify';
+
+<Card title="GET /api/groups" href="#get-all-groups">Get a list of all groups.</Card>
+<Card title="POST /api/groups" href="#create-a-new-group">Create a new group.</Card>
+<Card title="GET /api/groups/:id" href="#get-a-group">Get details of a specific group.</Card>
+<Card title="PUT /api/groups/:id" href="#update-a-group">Update an existing group.</Card>
+<Card title="DELETE /api/groups/:id" href="#delete-a-group">Delete a group.</Card>
+<Card title="POST /api/groups/:id/servers" href="#add-server-to-group">Add a server to a group.</Card>
+<Card title="DELETE /api/groups/:id/servers/:serverName" href="#remove-server-from-group">Remove a server from a group.</Card>
+<Card title="PUT /api/groups/:id/servers/batch" href="#batch-update-group-servers">Batch update servers in a group.</Card>
+<Card title="GET /api/groups/:id/server-configs" href="#get-group-server-configs">Get detailed server configurations in a group.</Card>
+<Card title="PUT /api/groups/:id/server-configs/:serverName/tools" href="#update-group-server-tools">Update tool selection for a server in a group.</Card>
+
+---
+
+### Get All Groups
+
+Retrieves a list of all server groups.
+
+- **Endpoint**: `/api/groups`
+- **Method**: `GET`
+- **Success Response**:
+  ```json
+  {
+    "success": true,
+    "data": [
+      {
+        "id": "group-1",
+        "name": "My Group",
+        "description": "A collection of servers.",
+        "servers": ["server1", "server2"],
+        "owner": "admin"
+      }
+    ]
+  }
+  ```
+
+---
+
+### Create a New Group
+
+Creates a new server group.
+
+- **Endpoint**: `/api/groups`
+- **Method**: `POST`
+- **Body**:
+  - `name` (string, required): The name of the group.
+  - `description` (string, optional): A description for the group.
+  - `servers` (array of strings, optional): A list of server names to include in the group.
+- **Request Example**:
+  ```json
+  {
+    "name": "My New Group",
+    "description": "A description for the new group",
+    "servers": ["server1", "server2"]
+  }
+  ```
+
+---
+
+### Get a Group
+
+Retrieves details for a specific group by its ID or name.
+
+- **Endpoint**: `/api/groups/:id`
+- **Method**: `GET`
+- **Parameters**:
+  - `:id` (string, required): The ID or name of the group.
+
+---
+
+### Update a Group
+
+Updates an existing group's name, description, or server list.
+
+- **Endpoint**: `/api/groups/:id`
+- **Method**: `PUT`
+- **Parameters**:
+  - `:id` (string, required): The ID or name of the group to update.
+- **Body**:
+  - `name` (string, optional): The new name for the group.
+  - `description` (string, optional): The new description for the group.
+  - `servers` (array, optional): The new list of servers for the group. See [Batch Update Group Servers](#batch-update-group-servers) for format.
+- **Request Example**:
+  ```json
+  {
+    "name": "Updated Group Name",
+    "description": "Updated description"
+  }
+  ```
+
+---
+
+### Delete a Group
+
+Deletes a group by its ID or name.
+
+- **Endpoint**: `/api/groups/:id`
+- **Method**: `DELETE`
+- **Parameters**:
+  - `:id` (string, required): The ID or name of the group to delete.
+
+---
+
+### Add Server to Group
+
+Adds a single server to a group.
+
+- **Endpoint**: `/api/groups/:id/servers`
+- **Method**: `POST`
+- **Parameters**:
+  - `:id` (string, required): The ID or name of the group.
+- **Body**:
+  - `serverName` (string, required): The name of the server to add.
+- **Request Example**:
+  ```json
+  {
+    "serverName": "my-server"
+  }
+  ```
+
+---
+
+### Remove Server from Group
+
+Removes a single server from a group.
+
+- **Endpoint**: `/api/groups/:id/servers/:serverName`
+- **Method**: `DELETE`
+- **Parameters**:
+  - `:id` (string, required): The ID or name of the group.
+  - `:serverName` (string, required): The name of the server to remove.
+
+---
+
+### Batch Update Group Servers
+
+Replaces all servers in a group with a new list. The list can be simple strings or detailed configuration objects.
+
+- **Endpoint**: `/api/groups/:id/servers/batch`
+- **Method**: `PUT`
+- **Parameters**:
+  - `:id` (string, required): The ID or name of the group.
+- **Body**:
+  - `servers` (array, required): An array of server names (strings) or server configuration objects.
+- **Request Example (Simple)**:
+  ```json
+  {
+    "servers": ["server1", "server2"]
+  }
+  ```
+- **Request Example (Detailed)**:
+  ```json
+  {
+    "servers": [
+      { "name": "server1", "tools": "all" },
+      { "name": "server2", "tools": ["toolA", "toolB"] }
+    ]
+  }
+  ```
+
+---
+
+### Get Group Server Configs
+
+Retrieves the detailed configuration for all servers within a group, including which tools are enabled.
+
+- **Endpoint**: `/api/groups/:id/server-configs`
+- **Method**: `GET`
+- **Parameters**:
+  - `:id` (string, required): The ID or name of the group.
+- **Success Response**:
+  ```json
+  {
+    "success": true,
+    "data": [
+      {
+        "name": "server1",
+        "tools": "all"
+      },
+      {
+        "name": "server2",
+        "tools": ["toolA", "toolB"]
+      }
+    ]
+  }
+  ```
+
+---
+
+### Update Group Server Tools
+
+Updates the tool selection for a specific server within a group.
+
+- **Endpoint**: `/api/groups/:id/server-configs/:serverName/tools`
+- **Method**: `PUT`
+- **Parameters**:
+  - `:id` (string, required): The ID or name of the group.
+  - `:serverName` (string, required): The name of the server to update.
+- **Body**:
+  - `tools` (string or array of strings, required): Either the string `"all"` to enable all tools, or an array of tool names to enable specifically.
+- **Request Example**:
+  ```json
+  {
+    "tools": ["toolA", "toolC"]
+  }
+  ```

docs/api-reference/introduction.mdx

@@ -1,33 +1,13 @@
 ---
-title: 'Introduction'
-description: 'Example section for showcasing API endpoints'
+title: "Introduction"
+description: "Welcome to the MCPHub API documentation."
 ---
 
-<Note>
-  If you're not looking to build API reference documentation, you can delete
-  this section by removing the api-reference folder.
-</Note>
+The MCPHub API provides a comprehensive set of endpoints to manage your MCP servers, groups, users, and more. The API is divided into two main categories:
 
-## Welcome
+- **MCP Endpoints**: These are the primary endpoints for interacting with your MCP servers. They provide a unified interface for sending requests to your servers and receiving responses in real-time.
+- **Management API**: These endpoints are used for managing the MCPHub instance itself. This includes managing servers, groups, users, and system settings.
 
-There are two ways to build API documentation: [OpenAPI](https://mintlify.com/docs/api-playground/openapi/setup) and [MDX components](https://mintlify.com/docs/api-playground/mdx/configuration). For the starter kit, we are using the following OpenAPI specification.
+All API endpoints are available under the `/api` path. For example, the endpoint to get all servers is `/api/servers`.
 
-<Card
-  title="Plant Store Endpoints"
-  icon="leaf"
-  href="https://github.com/mintlify/starter/blob/main/api-reference/openapi.json"
->
-  View the OpenAPI specification file
-</Card>
-
-## Authentication
-
-All API endpoints are authenticated using Bearer tokens and picked up from the specification file.
-
-```json
-"security": [
-  {
-    "bearerAuth": []
-  }
-]
-```
+Authentication is required for most Management API endpoints. See the [Authentication](/api-reference/auth) section for more details.

docs/api-reference/logs.mdx

@@ -0,0 +1,81 @@
+---
+title: "Logs"
+description: "Access and manage server logs."
+---
+
+import { Card, Cards } from 'mintlify';
+
+<Card
+  title="GET /api/logs"
+  href="#get-all-logs"
+>
+  Get all logs.
+</Card>
+
+<Card
+  title="DELETE /api/logs"
+  href="#clear-logs"
+>
+  Clear all logs.
+</Card>
+
+<Card
+  title="GET /api/logs/stream"
+  href="#stream-logs"
+>
+  Stream logs in real-time.
+</Card>
+
+---
+
+### Get All Logs
+
+Retrieves all stored logs.
+
+- **Endpoint**: `/api/logs`
+- **Method**: `GET`
+- **Success Response**:
+  ```json
+  {
+    "success": true,
+    "data": [
+      {
+        "timestamp": "2023-10-27T10:00:00.000Z",
+        "level": "info",
+        "message": "Server started successfully.",
+        "service": "system"
+      }
+    ]
+  }
+  ```
+
+---
+
+### Clear Logs
+
+Deletes all stored logs.
+
+- **Endpoint**: `/api/logs`
+- **Method**: `DELETE`
+- **Success Response**:
+  ```json
+  {
+    "success": true,
+    "message": "Logs cleared successfully"
+  }
+  ```
+
+---
+
+### Stream Logs
+
+Streams logs in real-time using Server-Sent Events (SSE). The connection will remain open, and new log entries will be sent as they occur.
+
+- **Endpoint**: `/api/logs/stream`
+- **Method**: `GET`
+- **Response Format**: The stream sends events with a `data` field containing a JSON object. The first event has `type: 'initial'` and contains all historical logs. Subsequent events have `type: 'log'` and contain a single new log entry.
+
+- **Example Event**:
+  ```
+  data: {"type":"log","log":{"timestamp":"2023-10-27T10:00:05.000Z","level":"debug","message":"Processing request for /api/some-endpoint","service":"mcp-server"}}
+  ```

docs/api-reference/mcp-http.mdx

@@ -0,0 +1,33 @@
+---
+title: "MCP HTTP Endpoints"
+description: "Connect to your MCP servers using the unified HTTP endpoint."
+---
+
+MCPHub provides a unified streamable HTTP interface for all your MCP servers. This allows you to send requests to any configured MCP server and receive responses in real-time.
+
+### Unified Endpoint
+
+This endpoint provides access to all enabled MCP servers.
+
+- **Endpoint**: `http://localhost:3000/mcp`
+- **Method**: `POST`
+
+### Group-Specific Endpoint
+
+For targeted access to specific server groups, use the group-based HTTP endpoint.
+
+- **Endpoint**: `http://localhost:3000/mcp/{group}`
+- **Method**: `POST`
+- **Parameters**:
+  - `{group}`: The ID or name of the group.
+
+### Server-Specific Endpoint
+
+For direct access to individual servers, use the server-specific HTTP endpoint.
+
+- **Endpoint**: `http://localhost:3000/mcp/{server}`
+- **Method**: `POST`
+- **Parameters**:
+  - `{server}`: The name of the server.
+
+> **Note**: If a server name and group name are the same, the group will take precedence.

docs/api-reference/mcp-sse.mdx

@@ -0,0 +1,25 @@
+---
+title: "MCP SSE Endpoints (Deprecated)"
+description: "Connect to your MCP servers using the SSE endpoint."
+---
+
+The SSE endpoint is deprecated and will be removed in a future version. Please use the [MCP HTTP Endpoints](/api-reference/mcp-http) instead.
+
+### Unified Endpoint
+
+- **Endpoint**: `http://localhost:3000/sse`
+- **Method**: `GET`
+
+### Group-Specific Endpoint
+
+- **Endpoint**: `http://localhost:3000/sse/{group}`
+- **Method**: `GET`
+- **Parameters**:
+  - `{group}`: The ID or name of the group.
+
+### Server-Specific Endpoint
+
+- **Endpoint**: `http://localhost:3000/sse/{server}`
+- **Method**: `GET`
+- **Parameters**:
+  - `{server}`: The name of the server.

docs/api-reference/openapi.mdx

@@ -0,0 +1,250 @@
+---
+title: "OpenAPI Integration"
+description: "Generate OpenAPI specifications from MCP tools for seamless integration with OpenWebUI and other systems"
+---
+
+# OpenAPI Generation for OpenWebUI Integration
+
+MCPHub now supports generating OpenAPI 3.0.3 specifications from MCP tools, enabling seamless integration with OpenWebUI and other OpenAPI-compatible systems without requiring MCPO as an intermediary proxy.
+
+## Features
+
+- ✅ **Automatic OpenAPI Generation**: Converts MCP tools to OpenAPI 3.0.3 specification
+- ✅ **OpenWebUI Compatible**: Direct integration without MCPO proxy
+- ✅ **Real-time Tool Discovery**: Dynamically includes tools from connected MCP servers
+- ✅ **Dual Parameter Support**: Supports both GET (query params) and POST (JSON body) for tool execution
+- ✅ **No Authentication Required**: OpenAPI endpoints are public for easy integration
+- ✅ **Comprehensive Metadata**: Full OpenAPI specification with proper schemas and documentation
+
+## API Endpoints
+
+### OpenAPI Specification
+
+<CodeGroup>
+
+```bash GET /api/openapi.json
+curl "http://localhost:3000/api/openapi.json"
+```
+
+```bash With Parameters
+curl "http://localhost:3000/api/openapi.json?title=My MCP API&version=2.0.0"
+```
+
+</CodeGroup>
+
+Generates and returns the complete OpenAPI 3.0.3 specification for all connected MCP tools.
+
+**Query Parameters:**
+
+<ParamField query="title" type="string" optional>
+  Custom API title
+</ParamField>
+
+<ParamField query="description" type="string" optional>
+  Custom API description
+</ParamField>
+
+<ParamField query="version" type="string" optional>
+  Custom API version
+</ParamField>
+
+<ParamField query="serverUrl" type="string" optional>
+  Custom server URL
+</ParamField>
+
+<ParamField query="includeDisabled" type="boolean" optional default="false">
+  Include disabled tools
+</ParamField>
+
+<ParamField query="servers" type="string" optional>
+  Comma-separated list of server names to include
+</ParamField>
+
+### Available Servers
+
+<CodeGroup>
+
+```bash GET /api/openapi/servers
+curl "http://localhost:3000/api/openapi/servers"
+```
+
+</CodeGroup>
+
+Returns a list of connected MCP server names.
+
+<ResponseExample>
+
+```json Example Response
+{
+  "success": true,
+  "data": ["amap", "playwright", "slack"]
+}
+```
+
+</ResponseExample>
+
+### Tool Statistics
+
+<CodeGroup>
+
+```bash GET /api/openapi/stats
+curl "http://localhost:3000/api/openapi/stats"
+```
+
+</CodeGroup>
+
+Returns statistics about available tools and servers.
+
+<ResponseExample>
+
+```json Example Response
+{
+  "success": true,
+  "data": {
+    "totalServers": 3,
+    "totalTools": 41,
+    "serverBreakdown": [
+      {"name": "amap", "toolCount": 12, "status": "connected"},
+      {"name": "playwright", "toolCount": 21, "status": "connected"},
+      {"name": "slack", "toolCount": 8, "status": "connected"}
+    ]
+  }
+}
+```
+
+</ResponseExample>
+
+### Tool Execution
+
+<CodeGroup>
+
+```bash GET /api/tools/{serverName}/{toolName}
+curl "http://localhost:3000/api/tools/amap/amap-maps_weather?city=Beijing"
+```
+
+```bash POST /api/tools/{serverName}/{toolName}
+curl -X POST "http://localhost:3000/api/tools/playwright/playwright-browser_navigate" \
+  -H "Content-Type: application/json" \
+  -d '{"url": "https://example.com"}'
+```
+
+</CodeGroup>
+
+Execute MCP tools via OpenAPI-compatible endpoints.
+
+**Path Parameters:**
+
+<ParamField path="serverName" type="string" required>
+  The name of the MCP server
+</ParamField>
+
+<ParamField path="toolName" type="string" required>
+  The name of the tool to execute
+</ParamField>
+
+## OpenWebUI Integration
+
+To integrate MCPHub with OpenWebUI:
+
+<Steps>
+  <Step title="Start MCPHub">
+    Ensure MCPHub is running with your MCP servers configured
+  </Step>
+  <Step title="Get OpenAPI Specification">
+    ```bash
+    curl http://localhost:3000/api/openapi.json > mcphub-api.json
+    ```
+  </Step>
+  <Step title="Add to OpenWebUI">
+    Import the OpenAPI specification file or point to the URL directly in OpenWebUI
+  </Step>
+</Steps>
+
+### Configuration Example
+
+In OpenWebUI, you can add MCPHub as an OpenAPI tool by using:
+
+<CardGroup cols={2}>
+  <Card title="OpenAPI URL" icon="link">
+    `http://localhost:3000/api/openapi.json`
+  </Card>
+  <Card title="Base URL" icon="server">
+    `http://localhost:3000/api`
+  </Card>
+</CardGroup>
+
+## Generated OpenAPI Structure
+
+The generated OpenAPI specification includes:
+
+### Tool Conversion Logic
+
+- **Simple tools** (≤10 primitive parameters) → GET endpoints with query parameters
+- **Complex tools** (objects, arrays, or >10 parameters) → POST endpoints with JSON request body
+- **All tools** include comprehensive response schemas and error handling
+
+### Example Generated Operation
+
+```yaml
+/tools/amap/amap-maps_weather:
+  get:
+    summary: "根据城市名称或者标准adcode查询指定城市的天气"
+    operationId: "amap_amap-maps_weather"
+    tags: ["amap"]
+    parameters:
+      - name: city
+        in: query
+        required: true
+        description: "城市名称或者adcode"
+        schema:
+          type: string
+    responses:
+      '200':
+        description: "Successful tool execution"
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ToolResponse'
+```
+
+### Security
+
+- Bearer authentication is defined but not enforced for tool execution endpoints
+- Enables flexible integration with various OpenAPI-compatible systems
+
+## Benefits over MCPO
+
+<CardGroup cols={2}>
+  <Card title="Direct Integration" icon="plug">
+    No need for intermediate proxy
+  </Card>
+  <Card title="Real-time Updates" icon="refresh">
+    OpenAPI spec updates automatically as MCP servers connect/disconnect
+  </Card>
+  <Card title="Better Performance" icon="bolt">
+    Direct tool execution without proxy overhead
+  </Card>
+  <Card title="Simplified Architecture" icon="layer-group">
+    One less component to manage
+  </Card>
+</CardGroup>
+
+## Troubleshooting
+
+<AccordionGroup>
+  <Accordion title="OpenAPI spec shows no tools">
+    Ensure MCP servers are connected. Check `/api/openapi/stats` for server status.
+  </Accordion>
+  
+  <Accordion title="Tool execution fails">
+    Verify the tool name and parameters match the OpenAPI specification. Check server logs for details.
+  </Accordion>
+  
+  <Accordion title="OpenWebUI can't connect">
+    Ensure MCPHub is accessible from OpenWebUI and the OpenAPI URL is correct.
+  </Accordion>
+  
+  <Accordion title="Missing tools in specification">
+    Check if tools are enabled in your MCP server configuration. Use `includeDisabled=true` to see all tools.
+  </Accordion>
+</AccordionGroup>

docs/api-reference/servers.mdx

@@ -0,0 +1,209 @@
+---
+title: "Servers"
+description: "Manage your MCP servers."
+---
+
+import { Card, Cards } from 'mintlify';
+
+<Card
+  title="GET /api/servers"
+  href="#get-all-servers"
+>
+  Get a list of all MCP servers.
+</Card>
+
+<Card
+  title="POST /api/servers"
+  href="#create-a-new-server"
+>
+  Create a new MCP server.
+</Card>
+
+<Card
+  title="PUT /api/servers/:name"
+  href="#update-a-server"
+>
+  Update an existing MCP server.
+</Card>
+
+<Card
+  title="DELETE /api/servers/:name"
+  href="#delete-a-server"
+>
+  Delete an MCP server.
+</Card>
+
+<Card
+  title="POST /api/servers/:name/toggle"
+  href="#toggle-a-server"
+>
+  Toggle the enabled state of a server.
+</Card>
+
+<Card
+  title="POST /api/servers/:serverName/tools/:toolName/toggle"
+  href="#toggle-a-tool"
+>
+  Toggle the enabled state of a tool.
+</Card>
+
+<Card
+  title="PUT /api/servers/:serverName/tools/:toolName/description"
+  href="#update-tool-description"
+>
+  Update the description of a tool.
+</Card>
+
+---
+
+### Get All Servers
+
+Retrieves a list of all configured MCP servers, including their status and available tools.
+
+- **Endpoint**: `/api/servers`
+- **Method**: `GET`
+- **Response**:
+  ```json
+  {
+    "success": true,
+    "data": [
+      {
+        "name": "example-server",
+        "status": "connected",
+        "tools": [
+          {
+            "name": "tool1",
+            "description": "Description of tool 1"
+          }
+        ],
+        "config": {
+          "type": "stdio",
+          "command": "node",
+          "args": ["server.js"]
+        }
+      }
+    ]
+  }
+  ```
+
+---
+
+### Create a New Server
+
+Adds a new MCP server to the configuration.
+
+- **Endpoint**: `/api/servers`
+- **Method**: `POST`
+- **Body**:
+  ```json
+  {
+    "name": "my-new-server",
+    "config": {
+      "type": "stdio",
+      "command": "python",
+      "args": ["-u", "my_script.py"],
+      "owner": "admin"
+    }
+  }
+  ```
+  - `name` (string, required): The unique name for the server.
+  - `config` (object, required): The server configuration object.
+    - `type` (string): `stdio`, `sse`, `streamable-http`, or `openapi`.
+    - `command` (string): Command to execute for `stdio` type.
+    - `args` (array of strings): Arguments for the command.
+    - `url` (string): URL for `sse`, `streamable-http`, or `openapi` types.
+    - `openapi` (object): OpenAPI configuration.
+      - `url` (string): URL to the OpenAPI schema.
+      - `schema` (object): The OpenAPI schema object itself.
+    - `headers` (object): Headers to send with requests for `sse`, `streamable-http`, and `openapi` types.
+    - `keepAliveInterval` (number): Keep-alive interval in milliseconds for `sse` type. Defaults to 60000.
+    - `owner` (string): The owner of the server. Defaults to the current user or 'admin'.
+
+---
+
+### Update a Server
+
+Updates the configuration of an existing MCP server.
+
+- **Endpoint**: `/api/servers/:name`
+- **Method**: `PUT`
+- **Parameters**:
+  - `:name` (string, required): The name of the server to update.
+- **Body**:
+  ```json
+  {
+    "config": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["new_server.js"]
+    }
+  }
+  ```
+  - `config` (object, required): The updated server configuration object. See "Create a New Server" for details.
+
+---
+
+### Delete a Server
+
+Removes an MCP server from the configuration.
+
+- **Endpoint**: `/api/servers/:name`
+- **Method**: `DELETE`
+- **Parameters**:
+  - `:name` (string, required): The name of the server to delete.
+
+---
+
+### Toggle a Server
+
+Enables or disables an MCP server.
+
+- **Endpoint**: `/api/servers/:name/toggle`
+- **Method**: `POST`
+- **Parameters**:
+  - `:name` (string, required): The name of the server to toggle.
+- **Body**:
+  ```json
+  {
+    "enabled": true
+  }
+  ```
+  - `enabled` (boolean, required): `true` to enable the server, `false` to disable it.
+
+---
+
+### Toggle a Tool
+
+Enables or disables a specific tool on a server.
+
+- **Endpoint**: `/api/servers/:serverName/tools/:toolName/toggle`
+- **Method**: `POST`
+- **Parameters**:
+  - `:serverName` (string, required): The name of the server.
+  - `:toolName` (string, required): The name of the tool.
+- **Body**:
+  ```json
+  {
+    "enabled": true
+  }
+  ```
+  - `enabled` (boolean, required): `true` to enable the tool, `false` to disable it.
+
+---
+
+### Update Tool Description
+
+Updates the description of a specific tool.
+
+- **Endpoint**: `/api/servers/:serverName/tools/:toolName/description`
+- **Method**: `PUT`
+- **Parameters**:
+  - `:serverName` (string, required): The name of the server.
+  - `:toolName` (string, required): The name of the tool.
+- **Body**:
+  ```json
+  {
+    "description": "New tool description"
+  }
+  ```
+  - `description` (string, required): The new description for the tool.

docs/api-reference/smart-routing.mdx

@@ -0,0 +1,29 @@
+---
+title: "Smart Routing"
+description: "Intelligent tool discovery using vector semantic search."
+---
+
+Smart Routing is MCPHub's intelligent tool discovery system that uses vector semantic search to automatically find the most relevant tools for any given task.
+
+### HTTP Endpoint
+
+- **Endpoint**: `http://localhost:3000/mcp/$smart`
+- **Method**: `POST`
+
+### SSE Endpoint (Deprecated)
+
+- **Endpoint**: `http://localhost:3000/sse/$smart`
+- **Method**: `GET`
+
+### How it Works
+
+1.  **Tool Indexing**: All MCP tools are automatically converted to vector embeddings and stored in PostgreSQL with pgvector.
+2.  **Semantic Search**: User queries are converted to vectors and matched against tool embeddings using cosine similarity.
+3.  **Intelligent Filtering**: Dynamic thresholds ensure relevant results without noise.
+4.  **Precise Execution**: Found tools can be directly executed with proper parameter validation.
+
+### Setup Requirements
+
+- PostgreSQL with pgvector extension
+- OpenAI API key (or compatible embedding service)
+- Enable Smart Routing in MCPHub settings

docs/configuration/environment-variables.mdx

@@ -11,261 +11,34 @@ MCPHub uses environment variables for configuration. This guide covers all avail
 
 ### Server Configuration
 
-| Variable    | Default       | Description                                                   |
-| ----------- | ------------- | ------------------------------------------------------------- |
-| `PORT`      | `3000`        | Port number for the HTTP server                               |
-| `HOST`      | `0.0.0.0`     | Host address to bind the server                               |
-| `NODE_ENV`  | `development` | Application environment (`development`, `production`, `test`) |
-| `LOG_LEVEL` | `info`        | Logging level (`error`, `warn`, `info`, `debug`)              |
+| Variable | Default | Description |
+| --- | --- | --- |
+| `PORT` | `3000` | Port number for the HTTP server |
+| `INIT_TIMEOUT` | `300000` | Initial timeout for the application |
+| `BASE_PATH` | `''` | The base path of the application |
+| `READONLY` | `false` | Set to `true` to enable readonly mode |
+| `MCPHUB_SETTING_PATH` | | Path to the MCPHub settings |
+| `NODE_ENV` | `development` | Application environment (`development`, `production`, `test`) |
 
 ```env
 PORT=3000
-HOST=0.0.0.0
+INIT_TIMEOUT=300000
+BASE_PATH=/api
+READONLY=true
+MCPHUB_SETTING_PATH=/path/to/settings
 NODE_ENV=production
-LOG_LEVEL=info
-```
-
-### Database Configuration
-
-| Variable       | Default     | Description                        |
-| -------------- | ----------- | ---------------------------------- |
-| `DATABASE_URL` | -           | PostgreSQL connection string       |
-| `DB_HOST`      | `localhost` | Database host                      |
-| `DB_PORT`      | `5432`      | Database port                      |
-| `DB_NAME`      | `mcphub`    | Database name                      |
-| `DB_USER`      | `mcphub`    | Database username                  |
-| `DB_PASSWORD`  | -           | Database password                  |
-| `DB_SSL`       | `false`     | Enable SSL for database connection |
-| `DB_POOL_MIN`  | `2`         | Minimum database pool size         |
-| `DB_POOL_MAX`  | `10`        | Maximum database pool size         |
-
-```env
-# Option 1: Full connection string
-DATABASE_URL=postgresql://username:password@localhost:5432/mcphub
-
-# Option 2: Individual components
-DB_HOST=localhost
-DB_PORT=5432
-DB_NAME=mcphub
-DB_USER=mcphub
-DB_PASSWORD=your-password
-DB_SSL=false
 ```
 
 ## Authentication & Security
 
 ### JWT Configuration
 
-| Variable                 | Default | Description                                 |
-| ------------------------ | ------- | ------------------------------------------- |
-| `JWT_SECRET`             | -       | Secret key for JWT token signing (required) |
-| `JWT_EXPIRES_IN`         | `24h`   | JWT token expiration time                   |
-| `JWT_REFRESH_EXPIRES_IN` | `7d`    | Refresh token expiration time               |
-| `JWT_ALGORITHM`          | `HS256` | JWT signing algorithm                       |
+| Variable | Default | Description |
+| --- | --- | --- |
+| `JWT_SECRET` | - | Secret key for JWT token signing (required) |
 
 ```env
 JWT_SECRET=your-super-secret-key-change-this-in-production
-JWT_EXPIRES_IN=24h
-JWT_REFRESH_EXPIRES_IN=7d
-```
-
-### Session & Security
-
-| Variable            | Default | Description                     |
-| ------------------- | ------- | ------------------------------- |
-| `SESSION_SECRET`    | -       | Session encryption secret       |
-| `BCRYPT_ROUNDS`     | `12`    | bcrypt hashing rounds           |
-| `RATE_LIMIT_WINDOW` | `15`    | Rate limiting window in minutes |
-| `RATE_LIMIT_MAX`    | `100`   | Maximum requests per window     |
-| `CORS_ORIGIN`       | `*`     | Allowed CORS origins            |
-
-```env
-SESSION_SECRET=your-session-secret
-BCRYPT_ROUNDS=12
-RATE_LIMIT_WINDOW=15
-RATE_LIMIT_MAX=100
-CORS_ORIGIN=https://your-domain.com,https://admin.your-domain.com
-```
-
-## External Services
-
-### OpenAI Configuration
-
-| Variable                 | Default                  | Description                      |
-| ------------------------ | ------------------------ | -------------------------------- |
-| `OPENAI_API_KEY`         | -                        | OpenAI API key for smart routing |
-| `OPENAI_MODEL`           | `gpt-3.5-turbo`          | OpenAI model for embeddings      |
-| `OPENAI_EMBEDDING_MODEL` | `text-embedding-ada-002` | Model for vector embeddings      |
-| `OPENAI_MAX_TOKENS`      | `1000`                   | Maximum tokens per request       |
-| `OPENAI_TEMPERATURE`     | `0.1`                    | Temperature for AI responses     |
-
-```env
-OPENAI_API_KEY=sk-your-openai-api-key
-OPENAI_MODEL=gpt-3.5-turbo
-OPENAI_EMBEDDING_MODEL=text-embedding-ada-002
-OPENAI_MAX_TOKENS=1000
-OPENAI_TEMPERATURE=0.1
-```
-
-### Redis Configuration (Optional)
-
-| Variable         | Default     | Description             |
-| ---------------- | ----------- | ----------------------- |
-| `REDIS_URL`      | -           | Redis connection string |
-| `REDIS_HOST`     | `localhost` | Redis host              |
-| `REDIS_PORT`     | `6379`      | Redis port              |
-| `REDIS_PASSWORD` | -           | Redis password          |
-| `REDIS_DB`       | `0`         | Redis database number   |
-| `REDIS_PREFIX`   | `mcphub:`   | Key prefix for Redis    |
-
-```env
-# Option 1: Full connection string
-REDIS_URL=redis://username:password@localhost:6379/0
-
-# Option 2: Individual components
-REDIS_HOST=localhost
-REDIS_PORT=6379
-REDIS_PASSWORD=your-redis-password
-REDIS_DB=0
-REDIS_PREFIX=mcphub:
-```
-
-## MCP Server Configuration
-
-### Default Settings
-
-| Variable            | Default             | Description                                  |
-| ------------------- | ------------------- | -------------------------------------------- |
-| `MCP_SETTINGS_FILE` | `mcp_settings.json` | Path to MCP settings file                    |
-| `MCP_SERVERS_FILE`  | `servers.json`      | Path to servers configuration                |
-| `MCP_TIMEOUT`       | `30000`             | Default timeout for MCP operations (ms)      |
-| `MCP_MAX_RETRIES`   | `3`                 | Maximum retry attempts for failed operations |
-| `MCP_RESTART_DELAY` | `5000`              | Delay before restarting failed servers (ms)  |
-
-```env
-MCP_SETTINGS_FILE=./config/mcp_settings.json
-MCP_SERVERS_FILE=./config/servers.json
-MCP_TIMEOUT=30000
-MCP_MAX_RETRIES=3
-MCP_RESTART_DELAY=5000
-```
-
-### Smart Routing
-
-| Variable                    | Default | Description                      |
-| --------------------------- | ------- | -------------------------------- |
-| `SMART_ROUTING_ENABLED`     | `true`  | Enable AI-powered smart routing  |
-| `SMART_ROUTING_THRESHOLD`   | `0.7`   | Similarity threshold for routing |
-| `SMART_ROUTING_MAX_RESULTS` | `5`     | Maximum tools to return          |
-| `VECTOR_CACHE_TTL`          | `3600`  | Vector cache TTL in seconds      |
-
-```env
-SMART_ROUTING_ENABLED=true
-SMART_ROUTING_THRESHOLD=0.7
-SMART_ROUTING_MAX_RESULTS=5
-VECTOR_CACHE_TTL=3600
-```
-
-## File Storage & Uploads
-
-| Variable             | Default          | Description                         |
-| -------------------- | ---------------- | ----------------------------------- |
-| `UPLOAD_DIR`         | `./uploads`      | Directory for file uploads          |
-| `MAX_FILE_SIZE`      | `10485760`       | Maximum file size in bytes (10MB)   |
-| `ALLOWED_FILE_TYPES` | `image/*,text/*` | Allowed MIME types                  |
-| `STORAGE_TYPE`       | `local`          | Storage type (`local`, `s3`, `gcs`) |
-
-```env
-UPLOAD_DIR=./data/uploads
-MAX_FILE_SIZE=10485760
-ALLOWED_FILE_TYPES=image/*,text/*,application/json
-STORAGE_TYPE=local
-```
-
-### S3 Storage (Optional)
-
-| Variable               | Default     | Description        |
-| ---------------------- | ----------- | ------------------ |
-| `S3_BUCKET`            | -           | S3 bucket name     |
-| `S3_REGION`            | `us-east-1` | S3 region          |
-| `S3_ACCESS_KEY_ID`     | -           | S3 access key      |
-| `S3_SECRET_ACCESS_KEY` | -           | S3 secret key      |
-| `S3_ENDPOINT`          | -           | Custom S3 endpoint |
-
-```env
-S3_BUCKET=mcphub-uploads
-S3_REGION=us-east-1
-S3_ACCESS_KEY_ID=your-access-key
-S3_SECRET_ACCESS_KEY=your-secret-key
-```
-
-## Monitoring & Logging
-
-### Application Monitoring
-
-| Variable                 | Default | Description                   |
-| ------------------------ | ------- | ----------------------------- |
-| `METRICS_ENABLED`        | `true`  | Enable metrics collection     |
-| `METRICS_PORT`           | `9090`  | Port for metrics endpoint     |
-| `HEALTH_CHECK_INTERVAL`  | `30000` | Health check interval (ms)    |
-| `PERFORMANCE_MONITORING` | `false` | Enable performance monitoring |
-
-```env
-METRICS_ENABLED=true
-METRICS_PORT=9090
-HEALTH_CHECK_INTERVAL=30000
-PERFORMANCE_MONITORING=true
-```
-
-### Logging Configuration
-
-| Variable           | Default      | Description                             |
-| ------------------ | ------------ | --------------------------------------- |
-| `LOG_FORMAT`       | `json`       | Log format (`json`, `text`)             |
-| `LOG_FILE`         | -            | Log file path (if file logging enabled) |
-| `LOG_MAX_SIZE`     | `10m`        | Maximum log file size                   |
-| `LOG_MAX_FILES`    | `5`          | Maximum number of log files             |
-| `LOG_DATE_PATTERN` | `YYYY-MM-DD` | Date pattern for log rotation           |
-
-```env
-LOG_FORMAT=json
-LOG_FILE=./logs/mcphub.log
-LOG_MAX_SIZE=10m
-LOG_MAX_FILES=5
-LOG_DATE_PATTERN=YYYY-MM-DD
-```
-
-## Development & Debug
-
-| Variable                 | Default | Description                         |
-| ------------------------ | ------- | ----------------------------------- |
-| `DEBUG`                  | -       | Debug namespaces (e.g., `mcphub:*`) |
-| `DEV_TOOLS_ENABLED`      | `false` | Enable development tools            |
-| `HOT_RELOAD`             | `true`  | Enable hot reload in development    |
-| `MOCK_EXTERNAL_SERVICES` | `false` | Mock external API calls             |
-
-```env
-DEBUG=mcphub:*
-DEV_TOOLS_ENABLED=true
-HOT_RELOAD=true
-MOCK_EXTERNAL_SERVICES=false
-```
-
-## Production Optimization
-
-| Variable           | Default | Description                            |
-| ------------------ | ------- | -------------------------------------- |
-| `CLUSTER_MODE`     | `false` | Enable cluster mode                    |
-| `WORKER_PROCESSES` | `0`     | Number of worker processes (0 = auto)  |
-| `MEMORY_LIMIT`     | -       | Memory limit per process               |
-| `CPU_LIMIT`        | -       | CPU limit per process                  |
-| `GC_OPTIMIZE`      | `false` | Enable garbage collection optimization |
-
-```env
-CLUSTER_MODE=true
-WORKER_PROCESSES=4
-MEMORY_LIMIT=512M
-GC_OPTIMIZE=true
 ```
 
 ## Configuration Examples
@@ -276,22 +49,9 @@ GC_OPTIMIZE=true
 # .env.development
 NODE_ENV=development
 PORT=3000
-LOG_LEVEL=debug
-
-# Database
-DATABASE_URL=postgresql://mcphub:password@localhost:5432/mcphub_dev
 
 # Auth
 JWT_SECRET=dev-secret-key
-JWT_EXPIRES_IN=24h
-
-# OpenAI (optional for development)
-# OPENAI_API_KEY=your-dev-key
-
-# Debug
-DEBUG=mcphub:*
-DEV_TOOLS_ENABLED=true
-HOT_RELOAD=true
 ```
 
 ### Production Environment
@@ -300,30 +60,9 @@ HOT_RELOAD=true
 # .env.production
 NODE_ENV=production
 PORT=3000
-LOG_LEVEL=info
-LOG_FORMAT=json
-
-# Database
-DATABASE_URL=postgresql://mcphub:secure-password@db.example.com:5432/mcphub
-DB_SSL=true
-DB_POOL_MAX=20
 
 # Security
 JWT_SECRET=your-super-secure-production-secret
-SESSION_SECRET=your-session-secret
-BCRYPT_ROUNDS=14
-
-# External Services
-OPENAI_API_KEY=your-production-openai-key
-REDIS_URL=redis://redis.example.com:6379
-
-# Monitoring
-METRICS_ENABLED=true
-PERFORMANCE_MONITORING=true
-
-# Optimization
-CLUSTER_MODE=true
-GC_OPTIMIZE=true
 ```
 
 ### Docker Environment
@@ -331,21 +70,10 @@ GC_OPTIMIZE=true
 ```env
 # .env.docker
 NODE_ENV=production
-HOST=0.0.0.0
 PORT=3000
 
-# Use service names for Docker networking
-DATABASE_URL=postgresql://mcphub:password@postgres:5432/mcphub
-REDIS_URL=redis://redis:6379
-
 # Security
 JWT_SECRET_FILE=/run/secrets/jwt_secret
-DB_PASSWORD_FILE=/run/secrets/db_password
-
-# File paths in container
-MCP_SETTINGS_FILE=/app/mcp_settings.json
-UPLOAD_DIR=/app/data/uploads
-LOG_FILE=/app/logs/mcphub.log
 ```
 
 ## Environment Variable Loading
@@ -364,7 +92,6 @@ MCPHub supports variable expansion:
 ```env
 BASE_URL=https://api.example.com
 API_ENDPOINT=${BASE_URL}/v1
-DATABASE_URL=postgresql://${DB_USER}:${DB_PASSWORD}@${DB_HOST}:${DB_PORT}/${DB_NAME}
 ```
 
 ## Security Best Practices
@@ -375,15 +102,3 @@ DATABASE_URL=postgresql://${DB_USER}:${DB_PASSWORD}@${DB_HOST}:${DB_PORT}/${DB_N
 4. **Use environment-specific files**
 5. **Validate all environment variables** at startup
 6. **Use Docker secrets** for container deployments
-
-## Validation
-
-MCPHub validates environment variables at startup. Invalid configurations will prevent the application from starting with helpful error messages.
-
-Required variables for production:
-
-- `JWT_SECRET`
-- `DATABASE_URL` or individual DB components
-- `OPENAI_API_KEY` (if smart routing is enabled)
-
-This comprehensive environment configuration ensures MCPHub can be properly configured for any deployment scenario.

docs/docs.json

@@ -34,6 +34,7 @@
             "group": "Configuration",
             "pages": [
               "configuration/mcp-settings",
+              "configuration/environment-variables",
               "configuration/docker-setup",
               "configuration/nginx"
             ]
@@ -63,31 +64,76 @@
             "group": "配置指南",
             "pages": [
               "zh/configuration/mcp-settings",
+              "zh/configuration/environment-variables",
               "zh/configuration/docker-setup",
               "zh/configuration/nginx"
             ]
           }
         ]
+      },
+      {
+        "tab": "API",
+        "groups": [
+          {
+            "group": "MCP Endpoints",
+            "pages": [
+              "api-reference/introduction",
+              "api-reference/mcp-http",
+              "api-reference/mcp-sse",
+              "api-reference/smart-routing"
+            ]
+          },
+          {
+            "group": "OpenAPI Endpoints",
+            "pages": [
+              "api-reference/openapi"
+            ]
+          },
+          {
+            "group": "Management Endpoints",
+            "pages": [
+              "api-reference/servers",
+              "api-reference/groups",
+              "api-reference/auth",
+              "api-reference/logs",
+              "api-reference/config"
+            ]
+          }
+        ]
+      },
+      {
+        "tab": "接口",
+        "groups": [
+          {
+            "group": "MCP 端点",
+            "pages": [
+              "zh/api-reference/introduction",
+              "zh/api-reference/mcp-http",
+              "zh/api-reference/mcp-sse",
+              "zh/api-reference/smart-routing"
+            ]
+          },
+          {
+            "group": "OpenAPI 端点",
+            "pages": [
+              "zh/api-reference/openapi"
+            ]
+          },
+          {
+            "group": "管理端点",
+            "pages": [
+              "zh/api-reference/servers",
+              "zh/api-reference/groups",
+              "zh/api-reference/auth",
+              "zh/api-reference/logs",
+              "zh/api-reference/config"
+            ]
+          }
+        ]
       }
     ],
     "global": {
-      "anchors": [
-        {
-          "anchor": "GitHub",
-          "href": "https://github.com/samanhappy/mcphub",
-          "icon": "github"
-        },
-        {
-          "anchor": "Discord",
-          "href": "https://discord.gg/qMKNsn5Q",
-          "icon": "discord"
-        },
-        {
-          "anchor": "Sponsor",
-          "href": "https://ko-fi.com/samanhappy",
-          "icon": "heart"
-        }
-      ]
+      "anchors": []
     }
   },
   "logo": {

docs/zh/api-reference/auth.mdx

@@ -0,0 +1,147 @@
+---
+title: "身份验证"
+description: "管理用户和身份验证。"
+---
+
+import { Card, Cards } from 'mintlify';
+
+<Card
+  title="POST /api/auth/login"
+  href="#login"
+>
+  登录以获取 JWT 令牌。
+</Card>
+
+<Card
+  title="POST /api/auth/register"
+  href="#register"
+>
+  注册一个新用户。
+</Card>
+
+<Card
+  title="GET /api/auth/user"
+  href="#get-current-user"
+>
+  获取当前已验证的用户。
+</Card>
+
+<Card
+  title="POST /api/auth/change-password"
+  href="#change-password"
+>
+  更改当前用户的密码。
+</Card>
+
+---
+
+### 登录
+
+验证用户身份并返回 JWT 令牌及用户详细信息。
+
+- **端点**: `/api/auth/login`
+- **方法**: `POST`
+- **正文**:
+  - `username` (string, 必填): 用户名。
+  - `password` (string, 必填): 用户密码。
+- **请求示例**:
+  ```json
+  {
+    "username": "admin",
+    "password": "admin123"
+  }
+  ```
+- **成功响应**:
+  ```json
+  {
+    "success": true,
+    "message": "登录成功",
+    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+    "user": {
+      "username": "admin",
+      "isAdmin": true,
+      "permissions": { ... }
+    }
+  }
+  ```
+
+---
+
+### 注册
+
+注册一个新用户并返回 JWT 令牌。
+
+- **端点**: `/api/auth/register`
+- **方法**: `POST`
+- **正文**:
+  - `username` (string, 必填): 新的用户名。
+  - `password` (string, 必填): 新的用户密码 (至少6个字符)。
+  - `isAdmin` (boolean, 可选): 用户是否应有管理员权限。
+- **请求示例**:
+  ```json
+  {
+    "username": "newuser",
+    "password": "password123",
+    "isAdmin": false
+  }
+  ```
+- **成功响应**:
+  ```json
+  {
+    "success": true,
+    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+    "user": {
+      "username": "newuser",
+      "isAdmin": false,
+      "permissions": { ... }
+    }
+  }
+  ```
+
+---
+
+### 获取当前用户
+
+检索当前通过身份验证的用户的个人资料。
+
+- **端点**: `/api/auth/user`
+- **方法**: `GET`
+- **身份验证**: 需要承载令牌 (Bearer Token)。
+- **成功响应**:
+  ```json
+  {
+    "success": true,
+    "user": {
+      "username": "admin",
+      "isAdmin": true,
+      "permissions": { ... }
+    }
+  }
+  ```
+
+---
+
+### 更改密码
+
+允许通过身份验证的用户更改其密码。
+
+- **端点**: `/api/auth/change-password`
+- **方法**: `POST`
+- **身份验证**: 需要承载令牌 (Bearer Token)。
+- **正文**:
+  - `currentPassword` (string, 必填): 用户的当前密码。
+  - `newPassword` (string, 必填): 新的密码 (至少6个字符)。
+- **请求示例**:
+  ```json
+  {
+    "currentPassword": "oldpassword",
+    "newPassword": "newpassword123"
+  }
+  ```
+- **成功响应**:
+  ```json
+  {
+    "success": true,
+    "message": "密码更新成功"
+  }
+  ```

docs/zh/api-reference/config.mdx

@@ -0,0 +1,111 @@
+---
+title: "配置"
+description: "管理和检索系统级配置。"
+---
+
+import { Card, Cards } from 'mintlify';
+
+<Card title="PUT /api/system-config" href="#update-system-config">更新主系统配置。</Card>
+<Card title="GET /api/settings" href="#get-all-settings">获取所有系统设置，包括服务器和群组。</Card>
+<Card title="GET /config" href="#get-runtime-config">获取前端的公共运行时配置。</Card>
+<Card title="GET /public-config" href="#get-public-config">获取公共配置以检查是否跳过身份验证。</Card>
+
+---
+
+### 更新系统配置
+
+更新系统配置的各个部分。您只需提供要更新部分的键。
+
+- **端点**: `/api/system-config`
+- **方法**: `PUT`
+- **正文**: 一个 JSON 对象，包含以下一个或多个顶级键：`routing`、`install`、`smartRouting`、`mcpRouter`。
+
+#### 路由配置 (`routing`)
+
+- `enableGlobalRoute` (boolean): 启用或禁用全局 `/api/mcp` 路由。
+- `enableGroupNameRoute` (boolean): 启用或禁用基于群组的路由 (例如 `/api/mcp/group/:groupName`)。
+- `enableBearerAuth` (boolean): 为 MCP 路由启用承载令牌身份验证。
+- `bearerAuthKey` (string): 用于承载身份验证的密钥。
+- `skipAuth` (boolean): 如果为 true，则跳过所有身份验证，使实例公开。
+
+#### 安装配置 (`install`)
+
+- `pythonIndexUrl` (string): 用于安装的 Python 包索引 (PyPI) 的基础 URL。
+- `npmRegistry` (string): 用于安装的 npm 注册表 URL。
+- `baseUrl` (string): 此 MCPHub 实例的公共基础 URL。
+
+#### 智能路由配置 (`smartRouting`)
+
+- `enabled` (boolean): 启用或禁用智能路由功能。
+- `dbUrl` (string): 用于存储嵌入的数据库连接 URL。
+- `openaiApiBaseUrl` (string): 用于生成嵌入的 OpenAI 兼容 API 的基础 URL。
+- `openaiApiKey` (string): 嵌入服务的 API 密钥。
+- `openaiApiEmbeddingModel` (string): 要使用的嵌入模型的名称。
+
+#### MCP 路由器配置 (`mcpRouter`)
+
+- `apiKey` (string): MCP 路由器服务的 API 密钥。
+- `referer` (string): 用于 MCP 路由器请求的 referer 头。
+- `title` (string): 在 MCP 路由器上显示的此实例的标题。
+- `baseUrl` (string): MCP 路由器 API 的基础 URL。
+
+- **请求示例**:
+  ```json
+  {
+    "routing": {
+      "skipAuth": true
+    },
+    "smartRouting": {
+      "enabled": true,
+      "dbUrl": "postgresql://user:pass@host:port/db"
+    }
+  }
+  ```
+
+---
+
+### 获取所有设置
+
+检索实例的整个设置对象，包括所有服务器配置、群组和系统设置。这是 `mcp_settings.json` 文件的完整转储。
+
+- **端点**: `/api/settings`
+- **方法**: `GET`
+
+---
+
+### 获取运行时配置
+
+检索前端应用程序所需的基本运行时配置。此端点不需要身份验证。
+
+- **端点**: `/config`
+- **方法**: `GET`
+- **成功响应**:
+  ```json
+  {
+    "success": true,
+    "data": {
+      "basePath": "",
+      "version": "1.0.0",
+      "name": "MCPHub"
+    }
+  }
+  ```
+
+---
+
+### 获取公共配置
+
+检索公共配置，主要用于检查是否跳过身份验证。这允许前端在用户登录前相应地调整其行为。此端点不需要身份验证。
+
+- **端点**: `/public-config`
+- **方法**: `GET`
+- **成功响应**:
+  ```json
+  {
+    "success": true,
+    "data": {
+      "skipAuth": false,
+      "permissions": {}
+    }
+  }
+  ```

docs/zh/api-reference/endpoint/create.mdx

@@ -1,572 +0,0 @@
----
-title: '创建资源'
-description: '创建新的 MCP 服务器、用户和组'
----
-
-## 创建服务器
-
-### 端点
-
-```http
-POST /api/servers
-```
-
-### 请求
-
-#### 请求头
-
-```http
-Content-Type: application/json
-Authorization: Bearer YOUR_JWT_TOKEN
-```
-
-#### 请求体
-
-```json
-{
-  "name": "文件系统服务器",
-  "command": "npx",
-  "args": ["-y", "@modelcontextprotocol/server-filesystem", "/allowed/path"],
-  "env": {
-    "NODE_ENV": "production",
-    "DEBUG": "mcp:*",
-    "MAX_FILES": "1000"
-  },
-  "cwd": "/app/workspace",
-  "timeout": 30000,
-  "retries": 3,
-  "enabled": true,
-  "description": "提供文件系统访问的 MCP 服务器",
-  "tags": ["filesystem", "production"],
-  "healthCheck": {
-    "enabled": true,
-    "interval": 30000,
-    "timeout": 5000,
-    "retries": 3,
-    "endpoint": "/health"
-  },
-  "resources": {
-    "memory": {
-      "limit": "512MB",
-      "warning": "400MB"
-    },
-    "cpu": {
-      "limit": "50%"
-    }
-  },
-  "logging": {
-    "level": "info",
-    "file": "/var/log/mcphub/server.log",
-    "maxSize": "100MB",
-    "maxFiles": 5
-  }
-}
-```
-
-#### 必填字段
-
-- `name` (string): 服务器唯一名称
-- `command` (string): 执行命令
-- `args` (array): 命令参数数组
-
-#### 可选字段
-
-- `env` (object): 环境变量键值对
-- `cwd` (string): 工作目录
-- `timeout` (number): 超时时间（毫秒）
-- `retries` (number): 重试次数
-- `enabled` (boolean): 是否启用（默认 true）
-- `description` (string): 服务器描述
-- `tags` (array): 标签数组
-- `healthCheck` (object): 健康检查配置
-- `resources` (object): 资源限制配置
-- `logging` (object): 日志配置
-
-### 响应
-
-#### 成功响应 (201 Created)
-
-```json
-{
-  "success": true,
-  "data": {
-    "id": "server-abc123",
-    "name": "文件系统服务器",
-    "status": "stopped",
-    "command": "npx",
-    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/allowed/path"],
-    "env": {
-      "NODE_ENV": "production",
-      "DEBUG": "mcp:*",
-      "MAX_FILES": "1000"
-    },
-    "cwd": "/app/workspace",
-    "timeout": 30000,
-    "retries": 3,
-    "enabled": true,
-    "description": "提供文件系统访问的 MCP 服务器",
-    "tags": ["filesystem", "production"],
-    "healthCheck": {
-      "enabled": true,
-      "interval": 30000,
-      "timeout": 5000,
-      "retries": 3,
-      "endpoint": "/health",
-      "status": "unknown"
-    },
-    "resources": {
-      "memory": {
-        "limit": "512MB",
-        "warning": "400MB",
-        "current": "0MB"
-      },
-      "cpu": {
-        "limit": "50%",
-        "current": "0%"
-      }
-    },
-    "logging": {
-      "level": "info",
-      "file": "/var/log/mcphub/server.log",
-      "maxSize": "100MB",
-      "maxFiles": 5,
-      "currentSize": "0MB"
-    },
-    "createdAt": "2024-01-01T12:00:00Z",
-    "updatedAt": "2024-01-01T12:00:00Z",
-    "createdBy": "user123"
-  },
-  "message": "服务器创建成功"
-}
-```
-
-#### 错误响应
-
-**400 Bad Request - 参数错误**
-
-```json
-{
-  "success": false,
-  "error": {
-    "code": "VALIDATION_ERROR",
-    "message": "请求数据验证失败",
-    "details": [
-      {
-        "field": "name",
-        "message": "服务器名称不能为空"
-      },
-      {
-        "field": "command",
-        "message": "执行命令不能为空"
-      }
-    ]
-  }
-}
-```
-
-**409 Conflict - 名称冲突**
-
-```json
-{
-  "success": false,
-  "error": {
-    "code": "RESOURCE_CONFLICT",
-    "message": "服务器名称已存在",
-    "details": {
-      "field": "name",
-      "value": "文件系统服务器",
-      "conflictingResourceId": "server-xyz789"
-    }
-  }
-}
-```
-
-### 示例
-
-#### cURL
-
-```bash
-curl -X POST http://localhost:3000/api/servers \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
-  -d '{
-    "name": "文件系统服务器",
-    "command": "npx",
-    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/data"],
-    "env": {
-      "NODE_ENV": "production"
-    },
-    "description": "生产环境文件系统服务器"
-  }'
-```
-
-#### JavaScript
-
-```javascript
-const response = await fetch('/api/servers', {
-  method: 'POST',
-  headers: {
-    'Content-Type': 'application/json',
-    Authorization: `Bearer ${token}`,
-  },
-  body: JSON.stringify({
-    name: '文件系统服务器',
-    command: 'npx',
-    args: ['-y', '@modelcontextprotocol/server-filesystem', '/data'],
-    env: {
-      NODE_ENV: 'production',
-    },
-    description: '生产环境文件系统服务器',
-  }),
-});
-
-const result = await response.json();
-if (result.success) {
-  console.log('服务器创建成功:', result.data);
-} else {
-  console.error('创建失败:', result.error);
-}
-```
-
-#### Python
-
-```python
-import requests
-
-response = requests.post(
-    'http://localhost:3000/api/servers',
-    headers={
-        'Content-Type': 'application/json',
-        'Authorization': f'Bearer {token}'
-    },
-    json={
-        'name': '文件系统服务器',
-        'command': 'npx',
-        'args': ['-y', '@modelcontextprotocol/server-filesystem', '/data'],
-        'env': {
-            'NODE_ENV': 'production'
-        },
-        'description': '生产环境文件系统服务器'
-    }
-)
-
-if response.status_code == 201:
-    result = response.json()
-    print('服务器创建成功:', result['data'])
-else:
-    error = response.json()
-    print('创建失败:', error['error'])
-```
-
-## 创建用户
-
-### 端点
-
-```http
-POST /api/users
-```
-
-### 请求体
-
-```json
-{
-  "username": "newuser",
-  "email": "user@example.com",
-  "password": "SecurePassword123!",
-  "role": "user",
-  "groups": ["dev-team", "qa-team"],
-  "profile": {
-    "firstName": "张",
-    "lastName": "三",
-    "department": "开发部",
-    "title": "软件工程师",
-    "phone": "+86-138-0013-8000",
-    "location": "北京"
-  },
-  "preferences": {
-    "language": "zh-CN",
-    "timezone": "Asia/Shanghai",
-    "notifications": {
-      "email": true,
-      "slack": false,
-      "browser": true
-    }
-  },
-  "enabled": true
-}
-```
-
-### 响应 (201 Created)
-
-```json
-{
-  "success": true,
-  "data": {
-    "id": "user-abc123",
-    "username": "newuser",
-    "email": "user@example.com",
-    "role": "user",
-    "groups": [
-      {
-        "id": "dev-team",
-        "name": "开发团队",
-        "role": "member"
-      }
-    ],
-    "profile": {
-      "firstName": "张",
-      "lastName": "三",
-      "fullName": "张三",
-      "department": "开发部",
-      "title": "软件工程师",
-      "phone": "+86-138-0013-8000",
-      "location": "北京",
-      "avatar": null
-    },
-    "preferences": {
-      "language": "zh-CN",
-      "timezone": "Asia/Shanghai",
-      "notifications": {
-        "email": true,
-        "slack": false,
-        "browser": true
-      }
-    },
-    "enabled": true,
-    "lastLoginAt": null,
-    "createdAt": "2024-01-01T12:00:00Z",
-    "updatedAt": "2024-01-01T12:00:00Z"
-  },
-  "message": "用户创建成功"
-}
-```
-
-## 创建组
-
-### 端点
-
-```http
-POST /api/groups
-```
-
-### 请求体
-
-```json
-{
-  "name": "dev-team",
-  "displayName": "开发团队",
-  "description": "前端和后端开发人员",
-  "parentGroup": null,
-  "permissions": {
-    "servers": {
-      "create": false,
-      "read": true,
-      "update": true,
-      "delete": false,
-      "execute": true
-    },
-    "tools": {
-      "filesystem": {
-        "read": true,
-        "write": true,
-        "paths": ["/app/data", "/tmp"]
-      },
-      "web-search": {
-        "enabled": true,
-        "maxQueries": 100
-      }
-    },
-    "monitoring": {
-      "viewLogs": true,
-      "viewMetrics": true,
-      "exportData": false
-    }
-  },
-  "settings": {
-    "autoAssign": false,
-    "maxMembers": 50,
-    "requireApproval": true,
-    "sessionTimeout": "8h"
-  },
-  "quotas": {
-    "requests": {
-      "daily": 1000,
-      "monthly": 30000
-    },
-    "storage": {
-      "maxSize": "10GB"
-    }
-  }
-}
-```
-
-### 响应 (201 Created)
-
-```json
-{
-  "success": true,
-  "data": {
-    "id": "group-abc123",
-    "name": "dev-team",
-    "displayName": "开发团队",
-    "description": "前端和后端开发人员",
-    "parentGroup": null,
-    "permissions": {
-      "servers": {
-        "create": false,
-        "read": true,
-        "update": true,
-        "delete": false,
-        "execute": true
-      },
-      "tools": {
-        "filesystem": {
-          "read": true,
-          "write": true,
-          "paths": ["/app/data", "/tmp"]
-        },
-        "web-search": {
-          "enabled": true,
-          "maxQueries": 100
-        }
-      },
-      "monitoring": {
-        "viewLogs": true,
-        "viewMetrics": true,
-        "exportData": false
-      }
-    },
-    "settings": {
-      "autoAssign": false,
-      "maxMembers": 50,
-      "requireApproval": true,
-      "sessionTimeout": "8h"
-    },
-    "quotas": {
-      "requests": {
-        "daily": 1000,
-        "monthly": 30000
-      },
-      "storage": {
-        "maxSize": "10GB"
-      }
-    },
-    "memberCount": 0,
-    "serverCount": 0,
-    "createdAt": "2024-01-01T12:00:00Z",
-    "updatedAt": "2024-01-01T12:00:00Z",
-    "createdBy": "admin"
-  },
-  "message": "组创建成功"
-}
-```
-
-## 批量创建
-
-### 批量创建服务器
-
-```http
-POST /api/servers/bulk
-```
-
-#### 请求体
-
-```json
-{
-  "servers": [
-    {
-      "name": "dev-server-1",
-      "command": "python",
-      "args": ["-m", "mcp_server"],
-      "env": { "ENV": "development" }
-    },
-    {
-      "name": "dev-server-2",
-      "command": "node",
-      "args": ["server.js"],
-      "env": { "ENV": "development" }
-    }
-  ],
-  "options": {
-    "skipExisting": true,
-    "validateAll": true,
-    "startAfterCreate": false
-  }
-}
-```
-
-#### 响应 (201 Created)
-
-```json
-{
-  "success": true,
-  "data": {
-    "created": [
-      {
-        "id": "server-1",
-        "name": "dev-server-1",
-        "status": "created"
-      },
-      {
-        "id": "server-2",
-        "name": "dev-server-2",
-        "status": "created"
-      }
-    ],
-    "skipped": [],
-    "failed": [],
-    "summary": {
-      "total": 2,
-      "created": 2,
-      "skipped": 0,
-      "failed": 0
-    }
-  },
-  "message": "批量创建完成，成功创建 2 个服务器"
-}
-```
-
-## 验证
-
-### 预验证创建请求
-
-在实际创建资源之前验证请求：
-
-```http
-POST /api/servers/validate
-```
-
-#### 请求体
-
-```json
-{
-  "name": "test-server",
-  "command": "invalid-command",
-  "args": []
-}
-```
-
-#### 响应
-
-```json
-{
-  "success": false,
-  "data": {
-    "valid": false,
-    "errors": [
-      {
-        "field": "command",
-        "message": "命令 'invalid-command' 不存在或无法执行"
-      }
-    ],
-    "warnings": [
-      {
-        "field": "args",
-        "message": "参数数组为空，服务器可能无法正常启动"
-      }
-    ]
-  }
-}
-```
-
-有关更多 API 端点信息，请参阅 [获取资源](/zh/api-reference/endpoint/get)、[删除资源](/zh/api-reference/endpoint/delete) 和 [WebHooks](/zh/api-reference/endpoint/webhook) 文档。

docs/zh/api-reference/endpoint/delete.mdx

@@ -1,303 +0,0 @@
----
-title: 删除资源 API
-description: 删除各种资源的 API 端点，包括服务器、组和配置等
----
-
-# 删除资源 API
-
-本文档描述了用于删除各种资源的 API 端点。
-
-## 删除 MCP 服务器
-
-删除指定的 MCP 服务器配置。
-
-### 端点
-
-```http
-DELETE /api/servers/{id}
-```
-
-### 参数
-
-| 参数名 | 类型   | 位置 | 必需 | 描述               |
-| ------ | ------ | ---- | ---- | ------------------ |
-| id     | string | path | 是   | 服务器的唯一标识符 |
-
-### 请求示例
-
-```bash
-curl -X DELETE \
-  'https://api.mcphub.io/api/servers/mcp-server-123' \
-  -H 'Authorization: Bearer YOUR_API_TOKEN' \
-  -H 'Content-Type: application/json'
-```
-
-### 响应
-
-#### 成功响应 (204 No Content)
-
-```json
-{
-  "success": true,
-  "message": "服务器已成功删除",
-  "data": {
-    "id": "mcp-server-123",
-    "deletedAt": "2024-01-15T10:30:00Z"
-  }
-}
-```
-
-#### 错误响应
-
-**404 Not Found**
-
-```json
-{
-  "error": {
-    "code": "SERVER_NOT_FOUND",
-    "message": "指定的服务器不存在",
-    "details": {
-      "serverId": "mcp-server-123"
-    }
-  }
-}
-```
-
-**409 Conflict**
-
-```json
-{
-  "error": {
-    "code": "SERVER_IN_USE",
-    "message": "服务器正在使用中，无法删除",
-    "details": {
-      "activeConnections": 5,
-      "associatedGroups": ["group-1", "group-2"]
-    }
-  }
-}
-```
-
-## 删除服务器组
-
-删除指定的服务器组。
-
-### 端点
-
-```http
-DELETE /api/groups/{id}
-```
-
-### 参数
-
-| 参数名 | 类型    | 位置  | 必需 | 描述                           |
-| ------ | ------- | ----- | ---- | ------------------------------ |
-| id     | string  | path  | 是   | 组的唯一标识符                 |
-| force  | boolean | query | 否   | 是否强制删除（包含服务器的组） |
-
-### 请求示例
-
-```bash
-curl -X DELETE \
-  'https://api.mcphub.io/api/groups/production-group?force=true' \
-  -H 'Authorization: Bearer YOUR_API_TOKEN' \
-  -H 'Content-Type: application/json'
-```
-
-### 响应
-
-#### 成功响应 (204 No Content)
-
-```json
-{
-  "success": true,
-  "message": "服务器组已成功删除",
-  "data": {
-    "id": "production-group",
-    "deletedServers": ["server-1", "server-2"],
-    "deletedAt": "2024-01-15T10:30:00Z"
-  }
-}
-```
-
-## 删除配置项
-
-删除指定的配置项。
-
-### 端点
-
-```http
-DELETE /api/config/{key}
-```
-
-### 参数
-
-| 参数名 | 类型   | 位置 | 必需 | 描述     |
-| ------ | ------ | ---- | ---- | -------- |
-| key    | string | path | 是   | 配置键名 |
-
-### 请求示例
-
-```bash
-curl -X DELETE \
-  'https://api.mcphub.io/api/config/custom-setting' \
-  -H 'Authorization: Bearer YOUR_API_TOKEN'
-```
-
-### 响应
-
-#### 成功响应 (200 OK)
-
-```json
-{
-  "success": true,
-  "message": "配置项已删除",
-  "data": {
-    "key": "custom-setting",
-    "previousValue": "old-value",
-    "deletedAt": "2024-01-15T10:30:00Z"
-  }
-}
-```
-
-## 批量删除
-
-### 批量删除服务器
-
-删除多个 MCP 服务器。
-
-#### 端点
-
-```http
-DELETE /api/servers/batch
-```
-
-#### 请求体
-
-```json
-{
-  "serverIds": ["server-1", "server-2", "server-3"],
-  "force": false
-}
-```
-
-#### 响应
-
-```json
-{
-  "success": true,
-  "message": "批量删除完成",
-  "data": {
-    "deleted": ["server-1", "server-3"],
-    "failed": [
-      {
-        "id": "server-2",
-        "reason": "服务器正在使用中"
-      }
-    ],
-    "summary": {
-      "total": 3,
-      "deleted": 2,
-      "failed": 1
-    }
-  }
-}
-```
-
-## 软删除 vs 硬删除
-
-### 软删除
-
-默认情况下，MCPHub 使用软删除机制：
-
-- 资源被标记为已删除但保留在数据库中
-- 可以通过恢复 API 恢复删除的资源
-- 删除的资源在列表 API 中默认不显示
-
-### 硬删除
-
-使用 `permanent=true` 参数执行硬删除：
-
-```bash
-curl -X DELETE \
-  'https://api.mcphub.io/api/servers/mcp-server-123?permanent=true' \
-  -H 'Authorization: Bearer YOUR_API_TOKEN'
-```
-
-<Warning>硬删除操作不可逆，请谨慎使用。</Warning>
-
-## 权限要求
-
-| 操作       | 所需权限                 |
-| ---------- | ------------------------ |
-| 删除服务器 | `servers:delete`         |
-| 删除组     | `groups:delete`          |
-| 删除配置   | `config:delete`          |
-| 硬删除     | `admin:permanent_delete` |
-
-## 错误代码
-
-| 错误代码                   | HTTP 状态码 | 描述             |
-| -------------------------- | ----------- | ---------------- |
-| `RESOURCE_NOT_FOUND`       | 404         | 资源不存在       |
-| `RESOURCE_IN_USE`          | 409         | 资源正在使用中   |
-| `INSUFFICIENT_PERMISSIONS` | 403         | 权限不足         |
-| `VALIDATION_ERROR`         | 400         | 请求参数验证失败 |
-| `INTERNAL_ERROR`           | 500         | 服务器内部错误   |
-
-## 最佳实践
-
-### 1. 删除前检查
-
-在删除资源前，建议先检查资源的使用情况：
-
-```bash
-# 检查服务器使用情况
-curl -X GET \
-  'https://api.mcphub.io/api/servers/mcp-server-123/usage' \
-  -H 'Authorization: Bearer YOUR_API_TOKEN'
-```
-
-### 2. 备份重要数据
-
-对于重要资源，建议在删除前进行备份：
-
-```bash
-# 导出服务器配置
-curl -X GET \
-  'https://api.mcphub.io/api/servers/mcp-server-123/export' \
-  -H 'Authorization: Bearer YOUR_API_TOKEN' \
-  > server-backup.json
-```
-
-### 3. 使用事务删除
-
-对于复杂的删除操作，使用事务确保数据一致性：
-
-```json
-{
-  "transaction": true,
-  "operations": [
-    {
-      "type": "delete",
-      "resource": "server",
-      "id": "server-1"
-    },
-    {
-      "type": "delete",
-      "resource": "group",
-      "id": "group-1"
-    }
-  ]
-}
-```
-
-## 恢复删除的资源
-
-软删除的资源可以通过恢复 API 恢复：
-
-```bash
-curl -X POST \
-  'https://api.mcphub.io/api/servers/mcp-server-123/restore' \
-  -H 'Authorization: Bearer YOUR_API_TOKEN'
-```

docs/zh/api-reference/endpoint/get.mdx

@@ -1,607 +0,0 @@
----
-title: '获取资源'
-description: '查询和检索 MCP 服务器、用户和组信息'
----
-
-## 获取服务器列表
-
-### 端点
-
-```http
-GET /api/servers
-```
-
-### 查询参数
-
-| 参数             | 类型    | 描述                            | 示例                         |
-| ---------------- | ------- | ------------------------------- | ---------------------------- |
-| `page`           | integer | 页码（从 1 开始）               | `?page=2`                    |
-| `limit`          | integer | 每页记录数（默认 20，最大 100） | `?limit=50`                  |
-| `sort`           | string  | 排序字段                        | `?sort=name`                 |
-| `order`          | string  | 排序顺序（asc/desc）            | `?order=desc`                |
-| `status`         | string  | 过滤服务器状态                  | `?status=running`            |
-| `search`         | string  | 搜索服务器名称或描述            | `?search=python`             |
-| `group`          | string  | 过滤所属组                      | `?group=dev-team`            |
-| `tags`           | string  | 过滤标签（逗号分隔）            | `?tags=python,production`    |
-| `enabled`        | boolean | 过滤启用状态                    | `?enabled=true`              |
-| `created_after`  | string  | 创建时间起始                    | `?created_after=2024-01-01`  |
-| `created_before` | string  | 创建时间结束                    | `?created_before=2024-01-31` |
-
-### 响应
-
-```json
-{
-  "success": true,
-  "data": {
-    "items": [
-      {
-        "id": "server-abc123",
-        "name": "文件系统服务器",
-        "status": "running",
-        "command": "npx",
-        "args": ["-y", "@modelcontextprotocol/server-filesystem", "/data"],
-        "env": {
-          "NODE_ENV": "production"
-        },
-        "cwd": "/app",
-        "pid": 12345,
-        "uptime": 3600000,
-        "enabled": true,
-        "description": "提供文件系统访问的 MCP 服务器",
-        "tags": ["filesystem", "production"],
-        "health": {
-          "status": "healthy",
-          "lastCheck": "2024-01-01T12:00:00Z",
-          "responseTime": "45ms"
-        },
-        "resources": {
-          "memory": {
-            "used": "128MB",
-            "limit": "512MB",
-            "percentage": 25
-          },
-          "cpu": {
-            "used": "15%",
-            "limit": "50%"
-          }
-        },
-        "stats": {
-          "totalRequests": 1523,
-          "errorCount": 2,
-          "avgResponseTime": "234ms"
-        },
-        "lastRestart": "2024-01-01T08:00:00Z",
-        "createdAt": "2024-01-01T00:00:00Z",
-        "updatedAt": "2024-01-01T12:00:00Z"
-      }
-    ],
-    "pagination": {
-      "page": 1,
-      "limit": 20,
-      "total": 45,
-      "pages": 3,
-      "hasNext": true,
-      "hasPrev": false
-    },
-    "filters": {
-      "status": "running",
-      "totalFiltered": 12
-    }
-  }
-}
-```
-
-### 示例
-
-```bash
-# 获取运行中的服务器，按名称排序
-curl -X GET "http://localhost:3000/api/servers?status=running&sort=name&order=asc" \
-  -H "Authorization: Bearer $TOKEN"
-
-# 搜索包含 "python" 的服务器
-curl -X GET "http://localhost:3000/api/servers?search=python&limit=10" \
-  -H "Authorization: Bearer $TOKEN"
-
-# 获取开发团队的服务器
-curl -X GET "http://localhost:3000/api/servers?group=dev-team" \
-  -H "Authorization: Bearer $TOKEN"
-```
-
-## 获取服务器详情
-
-### 端点
-
-```http
-GET /api/servers/{serverId}
-```
-
-### 路径参数
-
-- `serverId` (string): 服务器唯一标识符
-
-### 查询参数
-
-| 参数            | 类型   | 描述                                            |
-| --------------- | ------ | ----------------------------------------------- |
-| `include`       | string | 包含额外信息（逗号分隔）：`logs,metrics,events` |
-| `metrics_range` | string | 指标时间范围：`1h`, `24h`, `7d`                 |
-
-### 响应
-
-```json
-{
-  "success": true,
-  "data": {
-    "id": "server-abc123",
-    "name": "文件系统服务器",
-    "status": "running",
-    "command": "npx",
-    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/data"],
-    "env": {
-      "NODE_ENV": "production",
-      "DEBUG": "mcp:*"
-    },
-    "cwd": "/app",
-    "pid": 12345,
-    "uptime": 3600000,
-    "enabled": true,
-    "description": "提供文件系统访问的 MCP 服务器",
-    "tags": ["filesystem", "production"],
-    "healthCheck": {
-      "enabled": true,
-      "interval": 30000,
-      "timeout": 5000,
-      "retries": 3,
-      "endpoint": "/health",
-      "status": "healthy",
-      "lastCheck": "2024-01-01T12:00:00Z",
-      "responseTime": "45ms",
-      "consecutiveFailures": 0
-    },
-    "resources": {
-      "memory": {
-        "used": "128MB",
-        "limit": "512MB",
-        "warning": "400MB",
-        "percentage": 25
-      },
-      "cpu": {
-        "used": "15%",
-        "limit": "50%",
-        "cores": 4
-      },
-      "network": {
-        "bytesIn": "1.2GB",
-        "bytesOut": "890MB"
-      }
-    },
-    "stats": {
-      "totalRequests": 1523,
-      "successfulRequests": 1521,
-      "errorCount": 2,
-      "avgResponseTime": "234ms",
-      "p95ResponseTime": "450ms",
-      "requestsPerMinute": 25,
-      "lastError": {
-        "timestamp": "2024-01-01T11:30:00Z",
-        "message": "Temporary connection timeout",
-        "count": 1
-      }
-    },
-    "capabilities": [
-      {
-        "type": "tool",
-        "name": "read_file",
-        "description": "读取文件内容",
-        "schema": {
-          "type": "object",
-          "properties": {
-            "path": { "type": "string" }
-          }
-        }
-      },
-      {
-        "type": "tool",
-        "name": "write_file",
-        "description": "写入文件内容",
-        "schema": {
-          "type": "object",
-          "properties": {
-            "path": { "type": "string" },
-            "content": { "type": "string" }
-          }
-        }
-      }
-    ],
-    "groups": [
-      {
-        "id": "dev-team",
-        "name": "开发团队",
-        "permissions": ["read", "write", "execute"]
-      }
-    ],
-    "events": [
-      {
-        "id": "event-123",
-        "type": "started",
-        "timestamp": "2024-01-01T08:00:00Z",
-        "message": "服务器启动成功",
-        "metadata": {
-          "pid": 12345,
-          "startupTime": "2.3s"
-        }
-      }
-    ],
-    "lastRestart": "2024-01-01T08:00:00Z",
-    "createdAt": "2024-01-01T00:00:00Z",
-    "updatedAt": "2024-01-01T12:00:00Z",
-    "createdBy": "admin"
-  }
-}
-```
-
-### 示例
-
-```bash
-# 获取服务器基本信息
-curl -X GET "http://localhost:3000/api/servers/server-abc123" \
-  -H "Authorization: Bearer $TOKEN"
-
-# 获取服务器详情包含日志和指标
-curl -X GET "http://localhost:3000/api/servers/server-abc123?include=logs,metrics&metrics_range=24h" \
-  -H "Authorization: Bearer $TOKEN"
-```
-
-## 获取服务器状态
-
-### 端点
-
-```http
-GET /api/servers/{serverId}/status
-```
-
-### 响应
-
-```json
-{
-  "success": true,
-  "data": {
-    "serverId": "server-abc123",
-    "status": "running",
-    "health": "healthy",
-    "pid": 12345,
-    "uptime": 3600000,
-    "startedAt": "2024-01-01T08:00:00Z",
-    "lastHealthCheck": "2024-01-01T12:00:00Z",
-    "resources": {
-      "memory": {
-        "rss": 134217728,
-        "heapTotal": 67108864,
-        "heapUsed": 45088768,
-        "external": 8388608
-      },
-      "cpu": {
-        "user": 1000000,
-        "system": 500000,
-        "percentage": 15.5
-      }
-    },
-    "connections": {
-      "active": 5,
-      "total": 127
-    },
-    "performance": {
-      "requestsPerSecond": 12.5,
-      "avgResponseTime": "234ms",
-      "errorRate": "0.1%"
-    }
-  }
-}
-```
-
-## 获取服务器日志
-
-### 端点
-
-```http
-GET /api/servers/{serverId}/logs
-```
-
-### 查询参数
-
-| 参数     | 类型    | 描述                                           |
-| -------- | ------- | ---------------------------------------------- |
-| `level`  | string  | 日志级别过滤：`error`, `warn`, `info`, `debug` |
-| `limit`  | integer | 返回日志条数（默认 100，最大 1000）            |
-| `since`  | string  | 开始时间（ISO 8601 格式）                      |
-| `until`  | string  | 结束时间（ISO 8601 格式）                      |
-| `follow` | boolean | 实时跟踪日志流                                 |
-| `search` | string  | 搜索日志内容                                   |
-
-### 响应
-
-```json
-{
-  "success": true,
-  "data": {
-    "logs": [
-      {
-        "id": "log-123",
-        "timestamp": "2024-01-01T12:00:00Z",
-        "level": "info",
-        "message": "处理请求: read_file",
-        "source": "mcp-server",
-        "metadata": {
-          "requestId": "req-456",
-          "userId": "user-789",
-          "duration": "45ms"
-        }
-      },
-      {
-        "id": "log-124",
-        "timestamp": "2024-01-01T12:00:05Z",
-        "level": "error",
-        "message": "文件不存在: /nonexistent/file.txt",
-        "source": "filesystem",
-        "metadata": {
-          "requestId": "req-457",
-          "path": "/nonexistent/file.txt",
-          "error": "ENOENT"
-        }
-      }
-    ],
-    "pagination": {
-      "limit": 100,
-      "total": 1523,
-      "hasMore": true,
-      "nextCursor": "cursor-abc123"
-    }
-  }
-}
-```
-
-### 实时日志流
-
-```bash
-# 实时跟踪日志
-curl -X GET "http://localhost:3000/api/servers/server-abc123/logs?follow=true" \
-  -H "Authorization: Bearer $TOKEN" \
-  -H "Accept: text/event-stream"
-```
-
-## 获取服务器指标
-
-### 端点
-
-```http
-GET /api/servers/{serverId}/metrics
-```
-
-### 查询参数
-
-| 参数          | 类型   | 描述                                        |
-| ------------- | ------ | ------------------------------------------- |
-| `timeRange`   | string | 时间范围：`1h`, `24h`, `7d`, `30d`          |
-| `granularity` | string | 数据粒度：`1m`, `5m`, `1h`, `1d`            |
-| `metrics`     | string | 指定指标（逗号分隔）：`cpu,memory,requests` |
-
-### 响应
-
-```json
-{
-  "success": true,
-  "data": {
-    "timeRange": "1h",
-    "granularity": "5m",
-    "metrics": {
-      "cpu": {
-        "data": [
-          { "timestamp": "2024-01-01T11:00:00Z", "value": 12.5 },
-          { "timestamp": "2024-01-01T11:05:00Z", "value": 15.2 }
-        ],
-        "summary": {
-          "avg": 13.8,
-          "min": 8.1,
-          "max": 18.5,
-          "current": 15.2
-        }
-      },
-      "memory": {
-        "data": [
-          { "timestamp": "2024-01-01T11:00:00Z", "value": 125 },
-          { "timestamp": "2024-01-01T11:05:00Z", "value": 128 }
-        ],
-        "summary": {
-          "avg": 126.5,
-          "min": 120,
-          "max": 135,
-          "current": 128
-        }
-      },
-      "requests": {
-        "data": [
-          { "timestamp": "2024-01-01T11:00:00Z", "value": 45 },
-          { "timestamp": "2024-01-01T11:05:00Z", "value": 52 }
-        ],
-        "summary": {
-          "total": 2847,
-          "avg": 48.5,
-          "peak": 67
-        }
-      },
-      "responseTime": {
-        "data": [
-          { "timestamp": "2024-01-01T11:00:00Z", "avg": 230, "p95": 450 },
-          { "timestamp": "2024-01-01T11:05:00Z", "avg": 245, "p95": 480 }
-        ],
-        "summary": {
-          "avgResponseTime": "237ms",
-          "p95ResponseTime": "465ms"
-        }
-      }
-    }
-  }
-}
-```
-
-## 获取用户列表
-
-### 端点
-
-```http
-GET /api/users
-```
-
-### 查询参数
-
-| 参数               | 类型    | 描述             |
-| ------------------ | ------- | ---------------- |
-| `role`             | string  | 过滤用户角色     |
-| `group`            | string  | 过滤所属组       |
-| `enabled`          | boolean | 过滤启用状态     |
-| `search`           | string  | 搜索用户名或邮箱 |
-| `last_login_after` | string  | 最后登录时间起始 |
-
-### 响应
-
-```json
-{
-  "success": true,
-  "data": {
-    "items": [
-      {
-        "id": "user-abc123",
-        "username": "zhangsan",
-        "email": "zhangsan@example.com",
-        "role": "user",
-        "enabled": true,
-        "profile": {
-          "firstName": "张",
-          "lastName": "三",
-          "fullName": "张三",
-          "department": "开发部",
-          "title": "软件工程师"
-        },
-        "groups": [
-          {
-            "id": "dev-team",
-            "name": "开发团队",
-            "role": "member"
-          }
-        ],
-        "stats": {
-          "totalSessions": 45,
-          "totalRequests": 1234,
-          "lastRequestAt": "2024-01-01T11:30:00Z"
-        },
-        "lastLoginAt": "2024-01-01T08:00:00Z",
-        "createdAt": "2023-12-01T00:00:00Z"
-      }
-    ],
-    "pagination": {
-      "page": 1,
-      "limit": 20,
-      "total": 89,
-      "pages": 5
-    }
-  }
-}
-```
-
-## 获取组列表
-
-### 端点
-
-```http
-GET /api/groups
-```
-
-### 响应
-
-```json
-{
-  "success": true,
-  "data": {
-    "items": [
-      {
-        "id": "group-abc123",
-        "name": "dev-team",
-        "displayName": "开发团队",
-        "description": "前端和后端开发人员",
-        "memberCount": 12,
-        "serverCount": 8,
-        "parentGroup": null,
-        "children": [],
-        "permissions": {
-          "servers": ["read", "write", "execute"],
-          "tools": ["read", "execute"]
-        },
-        "quotas": {
-          "requests": {
-            "used": 750,
-            "limit": 1000
-          }
-        },
-        "createdAt": "2023-12-01T00:00:00Z"
-      }
-    ]
-  }
-}
-```
-
-## 搜索
-
-### 全局搜索
-
-```http
-GET /api/search
-```
-
-### 查询参数
-
-| 参数    | 类型    | 描述                                           |
-| ------- | ------- | ---------------------------------------------- |
-| `q`     | string  | 搜索关键词                                     |
-| `type`  | string  | 资源类型：`servers`, `users`, `groups`, `logs` |
-| `limit` | integer | 每种类型的最大结果数                           |
-
-### 响应
-
-```json
-{
-  "success": true,
-  "data": {
-    "query": "python",
-    "results": {
-      "servers": [
-        {
-          "id": "server-1",
-          "name": "Python MCP Server",
-          "type": "server",
-          "relevance": 0.95
-        }
-      ],
-      "users": [],
-      "groups": [
-        {
-          "id": "python-devs",
-          "name": "Python 开发者",
-          "type": "group",
-          "relevance": 0.8
-        }
-      ],
-      "logs": [
-        {
-          "id": "log-123",
-          "message": "Starting Python server...",
-          "type": "log",
-          "relevance": 0.7
-        }
-      ]
-    },
-    "total": 3
-  }
-}
-```
-
-有关更多信息，请参阅 [创建资源](/zh/api-reference/endpoint/create)、[删除资源](/zh/api-reference/endpoint/delete) 和 [WebHooks](/zh/api-reference/endpoint/webhook) 文档。

docs/zh/api-reference/endpoint/webhook.mdx

@@ -1,615 +0,0 @@
----
-title: WebHooks API
-description: 配置和管理 WebHook 事件通知的完整指南
----
-
-# WebHooks API
-
-WebHooks 允许 MCPHub 在特定事件发生时向您的应用程序发送实时通知。
-
-## 概述
-
-MCPHub WebHooks 系统支持以下功能：
-
-- 实时事件通知
-- 自定义过滤器
-- 重试机制
-- 签名验证
-- 批量事件处理
-
-## 支持的事件类型
-
-| 事件类型                | 描述           |
-| ----------------------- | -------------- |
-| `server.created`        | MCP 服务器创建 |
-| `server.updated`        | MCP 服务器更新 |
-| `server.deleted`        | MCP 服务器删除 |
-| `server.status_changed` | 服务器状态变更 |
-| `group.created`         | 服务器组创建   |
-| `group.updated`         | 服务器组更新   |
-| `group.deleted`         | 服务器组删除   |
-| `user.login`            | 用户登录       |
-| `user.logout`           | 用户登出       |
-| `config.changed`        | 配置变更       |
-| `system.error`          | 系统错误       |
-
-## 创建 WebHook
-
-### 端点
-
-```http
-POST /api/webhooks
-```
-
-### 请求体
-
-```json
-{
-  "url": "https://your-app.com/webhook",
-  "events": ["server.created", "server.status_changed"],
-  "secret": "your-webhook-secret",
-  "active": true,
-  "config": {
-    "contentType": "application/json",
-    "insecureSsl": false,
-    "retryCount": 3,
-    "timeout": 30
-  },
-  "filters": {
-    "serverGroups": ["production", "staging"],
-    "serverTypes": ["ai-assistant", "data-processor"]
-  }
-}
-```
-
-### 响应
-
-```json
-{
-  "success": true,
-  "data": {
-    "id": "webhook-123",
-    "url": "https://your-app.com/webhook",
-    "events": ["server.created", "server.status_changed"],
-    "active": true,
-    "secret": "your-webhook-secret",
-    "config": {
-      "contentType": "application/json",
-      "insecureSsl": false,
-      "retryCount": 3,
-      "timeout": 30
-    },
-    "filters": {
-      "serverGroups": ["production", "staging"],
-      "serverTypes": ["ai-assistant", "data-processor"]
-    },
-    "createdAt": "2024-01-15T10:30:00Z",
-    "updatedAt": "2024-01-15T10:30:00Z"
-  }
-}
-```
-
-## 获取 WebHook 列表
-
-### 端点
-
-```http
-GET /api/webhooks
-```
-
-### 查询参数
-
-| 参数名 | 类型    | 描述                 |
-| ------ | ------- | -------------------- |
-| page   | integer | 页码（默认：1）      |
-| limit  | integer | 每页数量（默认：20） |
-| active | boolean | 过滤活跃状态         |
-| event  | string  | 过滤事件类型         |
-
-### 请求示例
-
-```bash
-curl -X GET \
-  'https://api.mcphub.io/api/webhooks?active=true&limit=10' \
-  -H 'Authorization: Bearer YOUR_API_TOKEN'
-```
-
-### 响应
-
-```json
-{
-  "success": true,
-  "data": {
-    "webhooks": [
-      {
-        "id": "webhook-123",
-        "url": "https://your-app.com/webhook",
-        "events": ["server.created", "server.status_changed"],
-        "active": true,
-        "lastDelivery": "2024-01-15T09:30:00Z",
-        "deliveryCount": 145,
-        "failureCount": 2,
-        "createdAt": "2024-01-10T10:30:00Z"
-      }
-    ],
-    "pagination": {
-      "page": 1,
-      "limit": 10,
-      "total": 25,
-      "pages": 3
-    }
-  }
-}
-```
-
-## 获取单个 WebHook
-
-### 端点
-
-```http
-GET /api/webhooks/{id}
-```
-
-### 响应
-
-```json
-{
-  "success": true,
-  "data": {
-    "id": "webhook-123",
-    "url": "https://your-app.com/webhook",
-    "events": ["server.created", "server.status_changed"],
-    "active": true,
-    "secret": "your-webhook-secret",
-    "config": {
-      "contentType": "application/json",
-      "insecureSsl": false,
-      "retryCount": 3,
-      "timeout": 30
-    },
-    "filters": {
-      "serverGroups": ["production", "staging"],
-      "serverTypes": ["ai-assistant", "data-processor"]
-    },
-    "stats": {
-      "totalDeliveries": 145,
-      "successfulDeliveries": 143,
-      "failedDeliveries": 2,
-      "lastDelivery": "2024-01-15T09:30:00Z",
-      "lastSuccess": "2024-01-15T09:30:00Z",
-      "lastFailure": "2024-01-14T15:20:00Z"
-    },
-    "createdAt": "2024-01-10T10:30:00Z",
-    "updatedAt": "2024-01-15T10:30:00Z"
-  }
-}
-```
-
-## 更新 WebHook
-
-### 端点
-
-```http
-PUT /api/webhooks/{id}
-```
-
-### 请求体
-
-```json
-{
-  "url": "https://your-app.com/new-webhook",
-  "events": ["server.created", "server.updated", "server.deleted"],
-  "active": true,
-  "config": {
-    "retryCount": 5,
-    "timeout": 45
-  }
-}
-```
-
-## 删除 WebHook
-
-### 端点
-
-```http
-DELETE /api/webhooks/{id}
-```
-
-### 响应
-
-```json
-{
-  "success": true,
-  "message": "WebHook 已成功删除"
-}
-```
-
-## WebHook 事件格式
-
-### 基本结构
-
-所有 WebHook 事件都遵循以下基本结构：
-
-```json
-{
-  "id": "event-123",
-  "type": "server.created",
-  "timestamp": "2024-01-15T10:30:00Z",
-  "version": "1.0",
-  "data": {
-    // 事件特定数据
-  },
-  "metadata": {
-    "source": "mcphub",
-    "environment": "production",
-    "triggeredBy": "user-456"
-  }
-}
-```
-
-### 服务器事件示例
-
-#### server.created
-
-```json
-{
-  "id": "event-123",
-  "type": "server.created",
-  "timestamp": "2024-01-15T10:30:00Z",
-  "version": "1.0",
-  "data": {
-    "server": {
-      "id": "mcp-server-123",
-      "name": "AI Assistant Server",
-      "type": "ai-assistant",
-      "endpoint": "https://ai-assistant.example.com",
-      "group": "production",
-      "status": "active",
-      "capabilities": ["chat", "completion"],
-      "createdAt": "2024-01-15T10:30:00Z"
-    }
-  },
-  "metadata": {
-    "source": "mcphub",
-    "environment": "production",
-    "triggeredBy": "user-456"
-  }
-}
-```
-
-#### server.status_changed
-
-```json
-{
-  "id": "event-124",
-  "type": "server.status_changed",
-  "timestamp": "2024-01-15T11:30:00Z",
-  "version": "1.0",
-  "data": {
-    "server": {
-      "id": "mcp-server-123",
-      "name": "AI Assistant Server",
-      "previousStatus": "active",
-      "currentStatus": "inactive",
-      "reason": "Health check failed",
-      "lastHealthCheck": "2024-01-15T11:25:00Z"
-    }
-  },
-  "metadata": {
-    "source": "mcphub",
-    "environment": "production",
-    "triggeredBy": "system"
-  }
-}
-```
-
-## 签名验证
-
-MCPHub 使用 HMAC-SHA256 签名来验证 WebHook 的真实性。
-
-### 签名生成
-
-签名在 `X-MCPHub-Signature-256` 头中发送：
-
-```
-X-MCPHub-Signature-256: sha256=5757107ea39eca8e35d1e8...
-```
-
-### 验证示例
-
-#### Node.js
-
-```javascript
-const crypto = require('crypto');
-
-function verifySignature(payload, signature, secret) {
-  const expectedSignature = crypto
-    .createHmac('sha256', secret)
-    .update(payload, 'utf8')
-    .digest('hex');
-
-  const actualSignature = signature.replace('sha256=', '');
-
-  return crypto.timingSafeEqual(
-    Buffer.from(expectedSignature, 'hex'),
-    Buffer.from(actualSignature, 'hex'),
-  );
-}
-
-// Express.js 中间件示例
-app.use('/webhook', express.raw({ type: 'application/json' }), (req, res) => {
-  const signature = req.headers['x-mcphub-signature-256'];
-  const payload = req.body;
-
-  if (!verifySignature(payload, signature, process.env.WEBHOOK_SECRET)) {
-    return res.status(401).send('Unauthorized');
-  }
-
-  // 处理 WebHook 事件
-  const event = JSON.parse(payload);
-  console.log('收到事件:', event.type);
-
-  res.status(200).send('OK');
-});
-```
-
-#### Python
-
-```python
-import hmac
-import hashlib
-
-def verify_signature(payload, signature, secret):
-    expected_signature = hmac.new(
-        secret.encode('utf-8'),
-        payload,
-        hashlib.sha256
-    ).hexdigest()
-
-    actual_signature = signature.replace('sha256=', '')
-
-    return hmac.compare_digest(expected_signature, actual_signature)
-
-# Flask 示例
-from flask import Flask, request, jsonify
-import json
-
-app = Flask(__name__)
-
-@app.route('/webhook', methods=['POST'])
-def webhook():
-    signature = request.headers.get('X-MCPHub-Signature-256')
-    payload = request.get_data()
-
-    if not verify_signature(payload, signature, 'your-webhook-secret'):
-        return jsonify({'error': 'Unauthorized'}), 401
-
-    event = json.loads(payload)
-    print(f'收到事件: {event["type"]}')
-
-    return jsonify({'status': 'success'}), 200
-```
-
-## 重试机制
-
-MCPHub 对失败的 WebHook 交付实施指数退避重试：
-
-- **重试次数**: 可配置（默认 3 次）
-- **重试间隔**: 2^n 秒（n 为重试次数）
-- **最大间隔**: 300 秒（5 分钟）
-- **超时设置**: 可配置（默认 30 秒）
-
-### 重试时间表
-
-| 尝试次数 | 延迟时间 |
-| -------- | -------- |
-| 1        | 立即     |
-| 2        | 2 秒     |
-| 3        | 4 秒     |
-| 4        | 8 秒     |
-| 5        | 16 秒    |
-
-## 获取交付历史
-
-### 端点
-
-```http
-GET /api/webhooks/{id}/deliveries
-```
-
-### 查询参数
-
-| 参数名     | 类型    | 描述                                 |
-| ---------- | ------- | ------------------------------------ |
-| page       | integer | 页码                                 |
-| limit      | integer | 每页数量                             |
-| status     | string  | 过滤状态（success, failed, pending） |
-| event_type | string  | 过滤事件类型                         |
-
-### 响应
-
-```json
-{
-  "success": true,
-  "data": {
-    "deliveries": [
-      {
-        "id": "delivery-123",
-        "eventId": "event-123",
-        "eventType": "server.created",
-        "url": "https://your-app.com/webhook",
-        "status": "success",
-        "responseCode": 200,
-        "responseTime": 145,
-        "attempts": 1,
-        "deliveredAt": "2024-01-15T10:30:15Z",
-        "nextRetry": null
-      },
-      {
-        "id": "delivery-124",
-        "eventId": "event-124",
-        "eventType": "server.status_changed",
-        "url": "https://your-app.com/webhook",
-        "status": "failed",
-        "responseCode": 500,
-        "responseTime": 30000,
-        "attempts": 3,
-        "error": "Connection timeout",
-        "deliveredAt": null,
-        "nextRetry": "2024-01-15T11:45:00Z"
-      }
-    ],
-    "pagination": {
-      "page": 1,
-      "limit": 20,
-      "total": 145,
-      "pages": 8
-    }
-  }
-}
-```
-
-## 测试 WebHook
-
-### 端点
-
-```http
-POST /api/webhooks/{id}/test
-```
-
-### 请求体
-
-```json
-{
-  "eventType": "server.created",
-  "customData": {
-    "test": true,
-    "message": "这是一个测试事件"
-  }
-}
-```
-
-### 响应
-
-```json
-{
-  "success": true,
-  "data": {
-    "deliveryId": "delivery-test-123",
-    "status": "delivered",
-    "responseCode": 200,
-    "responseTime": 124,
-    "sentAt": "2024-01-15T10:30:00Z"
-  }
-}
-```
-
-## 最佳实践
-
-### 1. 幂等性处理
-
-确保您的 WebHook 端点能够处理重复事件：
-
-```javascript
-const processedEvents = new Set();
-
-app.post('/webhook', (req, res) => {
-  const event = req.body;
-
-  // 检查事件是否已处理
-  if (processedEvents.has(event.id)) {
-    return res.status(200).send('Already processed');
-  }
-
-  // 处理事件
-  processEvent(event);
-
-  // 记录已处理的事件
-  processedEvents.add(event.id);
-
-  res.status(200).send('OK');
-});
-```
-
-### 2. 异步处理
-
-对于复杂的处理逻辑，使用异步处理避免阻塞：
-
-```javascript
-app.post('/webhook', async (req, res) => {
-  const event = req.body;
-
-  // 立即响应
-  res.status(200).send('OK');
-
-  // 异步处理事件
-  setImmediate(() => {
-    processEventAsync(event);
-  });
-});
-```
-
-### 3. 错误处理
-
-实施适当的错误处理和日志记录：
-
-```javascript
-app.post('/webhook', (req, res) => {
-  try {
-    const event = req.body;
-    processEvent(event);
-    res.status(200).send('OK');
-  } catch (error) {
-    console.error('WebHook 处理错误:', error);
-    res.status(500).send('Internal Server Error');
-  }
-});
-```
-
-### 4. 监控和告警
-
-监控 WebHook 的交付状态：
-
-```bash
-# 检查失败的交付
-curl -X GET \
-  'https://api.mcphub.io/api/webhooks/webhook-123/deliveries?status=failed' \
-  -H 'Authorization: Bearer YOUR_API_TOKEN'
-```
-
-## 故障排除
-
-### 常见问题
-
-1. **签名验证失败**
-
-   - 检查密钥是否正确
-   - 确保使用原始请求体进行验证
-   - 验证 HMAC 计算实现
-
-2. **超时错误**
-
-   - 增加 WebHook 超时设置
-   - 优化端点响应时间
-   - 使用异步处理
-
-3. **重复事件**
-   - 实施幂等性检查
-   - 使用事件 ID 去重
-   - 记录处理状态
-
-### 调试工具
-
-使用 MCPHub 提供的调试工具：
-
-```bash
-# 查看最近的交付日志
-curl -X GET \
-  'https://api.mcphub.io/api/webhooks/webhook-123/deliveries?limit=5' \
-  -H 'Authorization: Bearer YOUR_API_TOKEN'
-
-# 重新发送失败的事件
-curl -X POST \
-  'https://api.mcphub.io/api/webhooks/delivery-124/redeliver' \
-  -H 'Authorization: Bearer YOUR_API_TOKEN'
-```

docs/zh/api-reference/groups.mdx

@@ -0,0 +1,212 @@
+---
+title: "群组"
+description: "管理服务器群组以组织和路由请求。"
+---
+
+import { Card, Cards } from 'mintlify';
+
+<Card title="GET /api/groups" href="#get-all-groups">获取所有群组的列表。</Card>
+<Card title="POST /api/groups" href="#create-a-new-group">创建一个新群组。</Card>
+<Card title="GET /api/groups/:id" href="#get-a-group">获取特定群组的详细信息。</Card>
+<Card title="PUT /api/groups/:id" href="#update-a-group">更新现有群组。</Card>
+<Card title="DELETE /api/groups/:id" href="#delete-a-group">删除一个群组。</Card>
+<Card title="POST /api/groups/:id/servers" href="#add-server-to-group">将服务器添加到群组。</Card>
+<Card title="DELETE /api/groups/:id/servers/:serverName" href="#remove-server-from-group">从群组中删除服务器。</Card>
+<Card title="PUT /api/groups/:id/servers/batch" href="#batch-update-group-servers">批量更新群组中的服务器。</Card>
+<Card title="GET /api/groups/:id/server-configs" href="#get-group-server-configs">获取群组中详细的服务器配置。</Card>
+<Card title="PUT /api/groups/:id/server-configs/:serverName/tools" href="#update-group-server-tools">更新群组中服务器的工具选择。</Card>
+
+---
+
+### 获取所有群组
+
+检索所有服务器群组的列表。
+
+- **端点**: `/api/groups`
+- **方法**: `GET`
+- **成功响应**:
+  ```json
+  {
+    "success": true,
+    "data": [
+      {
+        "id": "group-1",
+        "name": "我的群组",
+        "description": "服务器的集合。",
+        "servers": ["server1", "server2"],
+        "owner": "admin"
+      }
+    ]
+  }
+  ```
+
+---
+
+### 创建一个新群组
+
+创建一个新的服务器群组。
+
+- **端点**: `/api/groups`
+- **方法**: `POST`
+- **正文**:
+  - `name` (string, 必填): 群组的名称。
+  - `description` (string, 可选): 群组的描述。
+  - `servers` (array of strings, 可选): 要包含在群组中的服务器名称列表。
+- **请求示例**:
+  ```json
+  {
+    "name": "我的新群组",
+    "description": "新群组的描述",
+    "servers": ["server1", "server2"]
+  }
+  ```
+
+---
+
+### 获取一个群组
+
+通过 ID 或名称检索特定群组的详细信息。
+
+- **端点**: `/api/groups/:id`
+- **方法**: `GET`
+- **参数**:
+  - `:id` (string, 必填): 群组的 ID 或名称。
+
+---
+
+### 更新一个群组
+
+更新现有群组的名称、描述或服务器列表。
+
+- **端点**: `/api/groups/:id`
+- **方法**: `PUT`
+- **参数**:
+  - `:id` (string, 必填): 要更新的群组的 ID 或名称。
+- **正文**:
+  - `name` (string, 可选): 群组的新名称。
+  - `description` (string, 可选): 群组的新描述。
+  - `servers` (array, 可选): 群组的新服务器列表。格式请参阅 [批量更新群组服务器](#batch-update-group-servers)。
+- **请求示例**:
+  ```json
+  {
+    "name": "更新后的群组名称",
+    "description": "更新后的描述"
+  }
+  ```
+
+---
+
+### 删除一个群组
+
+通过 ID 或名称删除一个群组。
+
+- **端点**: `/api/groups/:id`
+- **方法**: `DELETE`
+- **参数**:
+  - `:id` (string, 必填): 要删除的群组的 ID 或名称。
+
+---
+
+### 将服务器添加到群组
+
+将单个服务器添加到群组。
+
+- **端点**: `/api/groups/:id/servers`
+- **方法**: `POST`
+- **参数**:
+  - `:id` (string, 必填): 群组的 ID 或名称。
+- **正文**:
+  - `serverName` (string, 必填): 要添加的服务器的名称。
+- **请求示例**:
+  ```json
+  {
+    "serverName": "my-server"
+  }
+  ```
+
+---
+
+### 从群组中删除服务器
+
+从群组中删除单个服务器。
+
+- **端点**: `/api/groups/:id/servers/:serverName`
+- **方法**: `DELETE`
+- **参数**:
+  - `:id` (string, 必填): 群组的 ID 或名称。
+  - `:serverName` (string, 必填): 要删除的服务器的名称。
+
+---
+
+### 批量更新群组服务器
+
+用新的列表替换群组中的所有服务器。该列表可以是简单的字符串或详细的配置对象。
+
+- **端点**: `/api/groups/:id/servers/batch`
+- **方法**: `PUT`
+- **参数**:
+  - `:id` (string, 必填): 群组的 ID 或名称。
+- **正文**:
+  - `servers` (array, 必填): 服务器名称（字符串）或服务器配置对象的数组。
+- **请求示例 (简单)**:
+  ```json
+  {
+    "servers": ["server1", "server2"]
+  }
+  ```
+- **请求示例 (详细)**:
+  ```json
+  {
+    "servers": [
+      { "name": "server1", "tools": "all" },
+      { "name": "server2", "tools": ["toolA", "toolB"] }
+    ]
+  }
+  ```
+
+---
+
+### 获取群组服务器配置
+
+检索群组内所有服务器的详细配置，包括启用了哪些工具。
+
+- **端点**: `/api/groups/:id/server-configs`
+- **方法**: `GET`
+- **参数**:
+  - `:id` (string, 必填): 群组的 ID 或名称。
+- **成功响应**:
+  ```json
+  {
+    "success": true,
+    "data": [
+      {
+        "name": "server1",
+        "tools": "all"
+      },
+      {
+        "name": "server2",
+        "tools": ["toolA", "toolB"]
+      }
+    ]
+  }
+  ```
+
+---
+
+### 更新群组服务器工具
+
+更新群组内特定服务器的工具选择。
+
+- **端点**: `/api/groups/:id/server-configs/:serverName/tools`
+- **方法**: `PUT`
+- **参数**:
+  - `:id` (string, 必填): 群组的 ID 或名称。
+  - `:serverName` (string, 必填): 要更新的服务器的名称。
+- **正文**:
+  - `tools` (string or array of strings, 必填): 字符串 `"all"` 表示启用所有工具，或一个工具名称数组以指定启用哪些工具。
+- **请求示例**:
+  ```json
+  {
+    "tools": ["toolA", "toolC"]
+  }
+  ```

docs/zh/api-reference/introduction.mdx

@@ -1,717 +1,13 @@
 ---
-title: 'API 参考'
-description: 'MCPHub REST API 完整参考文档'
+title: "介绍"
+description: "欢迎来到 MCPHub API 文档。"
 ---
 
-## 概述
+MCPHub API 提供了一整套端点来管理您的 MCP 服务器、群组、用户等。该 API 分为两个主要类别：
 
-MCPHub 提供全面的 REST API，用于管理 MCP 服务器、用户、组和监控。所有 API 端点都需要身份验证，并支持 JSON 格式的请求和响应。
+- **MCP 端点**: 这些是与您的 MCP 服务器交互的主要端点。它们提供了一个统一的界面，用于向您的服务器发送请求并实时接收响应。
+- **管理 API**: 这些端点用于管理 MCPHub 实例本身。这包括管理服务器、群组、用户和系统设置。
 
-## 基础信息
+所有 API 端点都在 `/api` 路径下可用。例如，获取所有服务器的端点是 `/api/servers`。
 
-### 基础 URL
-
-```
-https://your-mcphub-instance.com/api
-```
-
-### 身份验证
-
-所有 API 请求都需要身份验证。支持以下方法：
-
-#### JWT 令牌认证
-
-```bash
-curl -X GET https://api.mcphub.com/servers \
-  -H "Authorization: Bearer YOUR_JWT_TOKEN"
-```
-
-#### API 密钥认证
-
-```bash
-curl -X GET https://api.mcphub.com/servers \
-  -H "X-API-Key: YOUR_API_KEY"
-```
-
-### 请求格式
-
-- **Content-Type**: `application/json`
-- **Accept**: `application/json`
-- **User-Agent**: 建议包含您的应用程序名称和版本
-
-### 响应格式
-
-所有响应都采用 JSON 格式：
-
-```json
-{
-  "success": true,
-  "data": {
-    // 响应数据
-  },
-  "message": "操作成功",
-  "timestamp": "2024-01-01T12:00:00Z"
-}
-```
-
-错误响应格式：
-
-```json
-{
-  "success": false,
-  "error": {
-    "code": "VALIDATION_ERROR",
-    "message": "请求数据无效",
-    "details": {
-      "field": "name",
-      "reason": "名称不能为空"
-    }
-  },
-  "timestamp": "2024-01-01T12:00:00Z"
-}
-```
-
-## 状态码
-
-| 状态码 | 说明                 |
-| ------ | -------------------- |
-| 200    | 请求成功             |
-| 201    | 资源创建成功         |
-| 204    | 请求成功，无返回内容 |
-| 400    | 请求参数错误         |
-| 401    | 未授权访问           |
-| 403    | 权限不足             |
-| 404    | 资源不存在           |
-| 409    | 资源冲突             |
-| 422    | 请求数据验证失败     |
-| 429    | 请求频率超限         |
-| 500    | 服务器内部错误       |
-
-## 分页
-
-支持分页的端点使用以下参数：
-
-- `page`: 页码（从 1 开始）
-- `limit`: 每页记录数（默认 20，最大 100）
-- `sort`: 排序字段
-- `order`: 排序顺序（`asc` 或 `desc`）
-
-```bash
-curl -X GET "https://api.mcphub.com/servers?page=2&limit=50&sort=name&order=asc" \
-  -H "Authorization: Bearer $TOKEN"
-```
-
-分页响应格式：
-
-```json
-{
-  "success": true,
-  "data": {
-    "items": [...],
-    "pagination": {
-      "page": 2,
-      "limit": 50,
-      "total": 234,
-      "pages": 5,
-      "hasNext": true,
-      "hasPrev": true
-    }
-  }
-}
-```
-
-## 过滤和搜索
-
-支持过滤的端点可以使用以下参数：
-
-- `search`: 全文搜索
-- `filter[field]`: 字段过滤
-- `status`: 状态过滤
-- `created_after`: 创建时间筛选
-- `created_before`: 创建时间筛选
-
-```bash
-curl -X GET "https://api.mcphub.com/servers?search=python&filter[status]=running&created_after=2024-01-01" \
-  -H "Authorization: Bearer $TOKEN"
-```
-
-## API 端点
-
-### 服务器管理
-
-#### 获取服务器列表
-
-```http
-GET /api/servers
-```
-
-参数：
-
-- `status` (可选): 过滤服务器状态 (`running`, `stopped`, `error`)
-- `group` (可选): 过滤所属组
-- `search` (可选): 搜索服务器名称或描述
-
-示例响应：
-
-```json
-{
-  "success": true,
-  "data": {
-    "items": [
-      {
-        "id": "server-1",
-        "name": "文件系统服务器",
-        "status": "running",
-        "command": "npx",
-        "args": ["-y", "@modelcontextprotocol/server-filesystem", "/data"],
-        "env": {
-          "NODE_ENV": "production"
-        },
-        "cwd": "/app",
-        "pid": 12345,
-        "uptime": 3600000,
-        "lastRestart": "2024-01-01T12:00:00Z",
-        "createdAt": "2024-01-01T10:00:00Z",
-        "updatedAt": "2024-01-01T12:00:00Z"
-      }
-    ]
-  }
-}
-```
-
-#### 创建服务器
-
-```http
-POST /api/servers
-```
-
-请求体：
-
-```json
-{
-  "name": "新服务器",
-  "command": "python",
-  "args": ["-m", "mcp_server"],
-  "env": {
-    "API_KEY": "your-api-key",
-    "LOG_LEVEL": "INFO"
-  },
-  "cwd": "/app/python-server",
-  "enabled": true,
-  "description": "Python MCP 服务器",
-  "tags": ["python", "production"]
-}
-```
-
-#### 获取服务器详情
-
-```http
-GET /api/servers/{serverId}
-```
-
-#### 更新服务器
-
-```http
-PUT /api/servers/{serverId}
-```
-
-#### 删除服务器
-
-```http
-DELETE /api/servers/{serverId}
-```
-
-#### 启动服务器
-
-```http
-POST /api/servers/{serverId}/start
-```
-
-#### 停止服务器
-
-```http
-POST /api/servers/{serverId}/stop
-```
-
-请求体（可选）：
-
-```json
-{
-  "graceful": true,
-  "timeout": 30000
-}
-```
-
-#### 重启服务器
-
-```http
-POST /api/servers/{serverId}/restart
-```
-
-#### 获取服务器日志
-
-```http
-GET /api/servers/{serverId}/logs
-```
-
-参数：
-
-- `level` (可选): 日志级别过滤
-- `limit` (可选): 返回日志条数
-- `since` (可选): 开始时间
-- `follow` (可选): 实时跟踪日志
-
-### 用户管理
-
-#### 获取用户列表
-
-```http
-GET /api/users
-```
-
-#### 创建用户
-
-```http
-POST /api/users
-```
-
-请求体：
-
-```json
-{
-  "username": "newuser",
-  "email": "user@example.com",
-  "password": "securepassword",
-  "role": "user",
-  "groups": ["dev-team"],
-  "profile": {
-    "firstName": "张",
-    "lastName": "三",
-    "department": "开发部"
-  }
-}
-```
-
-#### 获取用户详情
-
-```http
-GET /api/users/{userId}
-```
-
-#### 更新用户
-
-```http
-PUT /api/users/{userId}
-```
-
-#### 删除用户
-
-```http
-DELETE /api/users/{userId}
-```
-
-### 组管理
-
-#### 获取组列表
-
-```http
-GET /api/groups
-```
-
-#### 创建组
-
-```http
-POST /api/groups
-```
-
-请求体：
-
-```json
-{
-  "name": "dev-team",
-  "displayName": "开发团队",
-  "description": "前端和后端开发人员",
-  "parentGroup": null,
-  "permissions": {
-    "servers": ["read", "write", "execute"],
-    "tools": ["read", "execute"]
-  },
-  "settings": {
-    "autoAssign": false,
-    "maxMembers": 50,
-    "requireApproval": true
-  }
-}
-```
-
-#### 添加用户到组
-
-```http
-POST /api/groups/{groupId}/members
-```
-
-请求体：
-
-```json
-{
-  "userId": "user123",
-  "role": "member"
-}
-```
-
-#### 从组中移除用户
-
-```http
-DELETE /api/groups/{groupId}/members/{userId}
-```
-
-#### 分配服务器到组
-
-```http
-POST /api/groups/{groupId}/servers
-```
-
-请求体：
-
-```json
-{
-  "serverId": "server-1",
-  "permissions": ["read", "write", "execute"]
-}
-```
-
-### 身份验证
-
-#### 登录
-
-```http
-POST /api/auth/login
-```
-
-请求体：
-
-```json
-{
-  "username": "admin",
-  "password": "password",
-  "mfaCode": "123456"
-}
-```
-
-响应：
-
-```json
-{
-  "success": true,
-  "data": {
-    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
-    "refreshToken": "refresh_token_here",
-    "expiresIn": 86400,
-    "user": {
-      "id": "user123",
-      "username": "admin",
-      "role": "admin",
-      "permissions": ["*"]
-    }
-  }
-}
-```
-
-#### 刷新令牌
-
-```http
-POST /api/auth/refresh
-```
-
-#### 注销
-
-```http
-POST /api/auth/logout
-```
-
-#### 验证令牌
-
-```http
-GET /api/auth/verify
-```
-
-### 监控
-
-#### 获取系统状态
-
-```http
-GET /api/monitoring/status
-```
-
-响应：
-
-```json
-{
-  "success": true,
-  "data": {
-    "system": {
-      "uptime": 86400,
-      "version": "2.1.0",
-      "nodeVersion": "18.17.0"
-    },
-    "servers": {
-      "total": 12,
-      "running": 10,
-      "stopped": 1,
-      "error": 1
-    },
-    "performance": {
-      "requestsPerMinute": 85,
-      "avgResponseTime": "245ms",
-      "errorRate": "0.3%"
-    }
-  }
-}
-```
-
-#### 获取性能指标
-
-```http
-GET /api/monitoring/metrics
-```
-
-参数：
-
-- `timeRange`: 时间范围 (`1h`, `24h`, `7d`, `30d`)
-- `granularity`: 数据粒度 (`1m`, `5m`, `1h`, `1d`)
-- `metrics`: 指定指标名称（逗号分隔）
-
-#### 获取日志
-
-```http
-GET /api/monitoring/logs
-```
-
-参数：
-
-- `level`: 日志级别
-- `source`: 日志源
-- `limit`: 返回条数
-- `since`: 开始时间
-- `until`: 结束时间
-
-### 配置管理
-
-#### 获取系统配置
-
-```http
-GET /api/config
-```
-
-#### 更新系统配置
-
-```http
-PUT /api/config
-```
-
-请求体：
-
-```json
-{
-  "smtp": {
-    "host": "smtp.example.com",
-    "port": 587,
-    "secure": false,
-    "auth": {
-      "user": "noreply@example.com",
-      "pass": "password"
-    }
-  },
-  "notifications": {
-    "email": true,
-    "slack": true,
-    "webhook": "https://hooks.example.com/notifications"
-  }
-}
-```
-
-## WebSocket API
-
-MCPHub 支持 WebSocket 连接以获取实时更新。
-
-### 连接
-
-```javascript
-const ws = new WebSocket('wss://api.mcphub.com/ws');
-ws.onopen = function () {
-  // 发送认证消息
-  ws.send(
-    JSON.stringify({
-      type: 'auth',
-      token: 'YOUR_JWT_TOKEN',
-    }),
-  );
-};
-```
-
-### 订阅事件
-
-```javascript
-// 订阅服务器状态更新
-ws.send(
-  JSON.stringify({
-    type: 'subscribe',
-    channel: 'server-status',
-    filters: {
-      serverId: 'server-1',
-    },
-  }),
-);
-
-// 订阅系统监控
-ws.send(
-  JSON.stringify({
-    type: 'subscribe',
-    channel: 'monitoring',
-    metrics: ['cpu', 'memory', 'requests'],
-  }),
-);
-```
-
-### 事件类型
-
-- `server-status`: 服务器状态变化
-- `server-logs`: 实时日志流
-- `monitoring`: 系统监控指标
-- `alerts`: 系统警报
-- `user-activity`: 用户活动事件
-
-## 错误处理
-
-### 错误代码
-
-| 错误代码                | 描述           |
-| ----------------------- | -------------- |
-| `INVALID_REQUEST`       | 请求格式无效   |
-| `AUTHENTICATION_FAILED` | 身份验证失败   |
-| `AUTHORIZATION_FAILED`  | 权限不足       |
-| `RESOURCE_NOT_FOUND`    | 资源不存在     |
-| `RESOURCE_CONFLICT`     | 资源冲突       |
-| `VALIDATION_ERROR`      | 数据验证失败   |
-| `RATE_LIMIT_EXCEEDED`   | 请求频率超限   |
-| `SERVER_ERROR`          | 服务器内部错误 |
-
-### 错误处理示例
-
-```javascript
-async function handleApiRequest() {
-  try {
-    const response = await fetch('/api/servers', {
-      headers: {
-        Authorization: `Bearer ${token}`,
-        'Content-Type': 'application/json',
-      },
-    });
-
-    const data = await response.json();
-
-    if (!data.success) {
-      switch (data.error.code) {
-        case 'AUTHENTICATION_FAILED':
-          // 重新登录
-          redirectToLogin();
-          break;
-        case 'RATE_LIMIT_EXCEEDED':
-          // 延迟重试
-          setTimeout(() => handleApiRequest(), 5000);
-          break;
-        default:
-          // 显示错误消息
-          showError(data.error.message);
-      }
-      return;
-    }
-
-    // 处理成功响应
-    handleSuccessResponse(data.data);
-  } catch (error) {
-    // 处理网络错误
-    console.error('网络请求失败:', error);
-  }
-}
-```
-
-## 速率限制
-
-API 实施速率限制以防止滥用：
-
-- **默认限制**: 每分钟 100 请求
-- **认证用户**: 每分钟 1000 请求
-- **管理员**: 每分钟 5000 请求
-
-响应头包含速率限制信息：
-
-```
-X-RateLimit-Limit: 1000
-X-RateLimit-Remaining: 999
-X-RateLimit-Reset: 1609459200
-```
-
-## SDK 和客户端库
-
-### JavaScript/Node.js
-
-```bash
-npm install @mcphub/sdk
-```
-
-```javascript
-import { MCPHubClient } from '@mcphub/sdk';
-
-const client = new MCPHubClient({
-  baseURL: 'https://api.mcphub.com',
-  token: 'YOUR_JWT_TOKEN',
-});
-
-// 获取服务器列表
-const servers = await client.servers.list();
-
-// 创建服务器
-const newServer = await client.servers.create({
-  name: '新服务器',
-  command: 'python',
-  args: ['-m', 'mcp_server'],
-});
-```
-
-### Python
-
-```bash
-pip install mcphub-sdk
-```
-
-```python
-from mcphub_sdk import MCPHubClient
-
-client = MCPHubClient(
-    base_url='https://api.mcphub.com',
-    token='YOUR_JWT_TOKEN'
-)
-
-# 获取服务器列表
-servers = client.servers.list()
-
-# 创建服务器
-new_server = client.servers.create(
-    name='新服务器',
-    command='python',
-    args=['-m', 'mcp_server']
-)
-```
-
-## 最佳实践
-
-1. **使用 HTTPS**: 始终通过 HTTPS 访问 API
-2. **安全存储令牌**: 不要在客户端代码中硬编码令牌
-3. **处理错误**: 实施适当的错误处理和重试逻辑
-4. **遵守速率限制**: 监控速率限制并实施退避策略
-5. **使用分页**: 对于大数据集使用分页参数
-6. **缓存响应**: 适当缓存 API 响应以减少请求
-7. **版本控制**: 使用 API 版本号以确保兼容性
-
-有关更多信息，请参阅我们的 [SDK 文档](https://docs.mcphub.com/sdk) 和 [示例代码](https://github.com/mcphub/examples)。
+大多数管理 API 端点都需要身份验证。有关更多详细信息，请参阅[身份验证](/api-reference/auth)部分。

docs/zh/api-reference/logs.mdx

@@ -0,0 +1,81 @@
+---
+title: "日志"
+description: "访问和管理服务器日志。"
+---
+
+import { Card, Cards } from 'mintlify';
+
+<Card
+  title="GET /api/logs"
+  href="#get-all-logs"
+>
+  获取所有日志。
+</Card>
+
+<Card
+  title="DELETE /api/logs"
+  href="#clear-logs"
+>
+  清除所有日志。
+</Card>
+
+<Card
+  title="GET /api/logs/stream"
+  href="#stream-logs"
+>
+  实时流式传输日志。
+</Card>
+
+---
+
+### 获取所有日志
+
+检索所有存储的日志。
+
+- **端点**: `/api/logs`
+- **方法**: `GET`
+- **成功响应**:
+  ```json
+  {
+    "success": true,
+    "data": [
+      {
+        "timestamp": "2023-10-27T10:00:00.000Z",
+        "level": "info",
+        "message": "服务器成功启动。",
+        "service": "system"
+      }
+    ]
+  }
+  ```
+
+---
+
+### 清除日志
+
+删除所有存储的日志。
+
+- **端点**: `/api/logs`
+- **方法**: `DELETE`
+- **成功响应**:
+  ```json
+  {
+    "success": true,
+    "message": "日志清除成功"
+  }
+  ```
+
+---
+
+### 流式传输日志
+
+使用服务器发送事件 (SSE) 实时流式传输日志。连接将保持打开状态，新的日志条目将在发生时发送。
+
+- **端点**: `/api/logs/stream`
+- **方法**: `GET`
+- **响应格式**: 该流发送带有包含 JSON 对象的 `data` 字段的事件。第一个事件的 `type` 为 `initial`，包含所有历史日志。后续事件的 `type` 为 `log`，包含单个新日志条目。
+
+- **事件示例**:
+  ```
+  data: {"type":"log","log":{"timestamp":"2023-10-27T10:00:05.000Z","level":"debug","message":"正在处理 /api/some-endpoint 的请求","service":"mcp-server"}}
+  ```

docs/zh/api-reference/mcp-http.mdx

@@ -0,0 +1,33 @@
+---
+title: "MCP HTTP 端点"
+description: "使用统一的 HTTP 端点连接到您的 MCP 服务器。"
+---
+
+MCPHub 为您的所有 MCP 服务器提供统一的可流式 HTTP 接口。这使您可以向任何配置的 MCP 服务器发送请求并实时接收响应。
+
+### 统一端点
+
+此端点提供对所有已启用的 MCP 服务器的访问。
+
+- **端点**: `http://localhost:3000/mcp`
+- **方法**: `POST`
+
+### 特定群组的端点
+
+要定向访问特定的服务器群组，请使用基于群组的 HTTP 端点。
+
+- **端点**: `http://localhost:3000/mcp/{group}`
+- **方法**: `POST`
+- **参数**:
+  - `{group}`: 群组的 ID 或名称。
+
+### 特定服务器的端点
+
+要直接访问单个服务器，请使用特定于服务器的 HTTP 端点。
+
+- **端点**: `http://localhost:3000/mcp/{server}`
+- **方法**: `POST`
+- **参数**:
+  - `{server}`: 服务器的名称。
+
+> **注意**: 如果服务器名称和群组名称相同，则群组将优先。

docs/zh/api-reference/mcp-sse.mdx

@@ -0,0 +1,25 @@
+---
+title: "MCP SSE 端点 (已弃用)"
+description: "使用 SSE 端点连接到您的 MCP 服务器。"
+---
+
+SSE 端点已弃用，并将在未来版本中删除。请改用 [MCP HTTP 端点](/api-reference/mcp-http)。
+
+### 统一端点
+
+- **端点**: `http://localhost:3000/sse`
+- **方法**: `GET`
+
+### 特定群组的端点
+
+- **端点**: `http://localhost:3000/sse/{group}`
+- **方法**: `GET`
+- **参数**:
+  - `{group}`: 群组的 ID 或名称。
+
+### 特定服务器的端点
+
+- **端点**: `http://localhost:3000/sse/{server}`
+- **方法**: `GET`
+- **参数**:
+  - `{server}`: 服务器的名称。

docs/zh/api-reference/openapi.mdx

@@ -0,0 +1,250 @@
+---
+title: "OpenAPI 集成"
+description: "从 MCP 工具生成 OpenAPI 规范，与 OpenWebUI 和其他系统无缝集成"
+---
+
+# OpenWebUI 集成的 OpenAPI 生成
+
+MCPHub 现在支持从 MCP 工具生成 OpenAPI 3.0.3 规范，实现与 OpenWebUI 和其他 OpenAPI 兼容系统的无缝集成，无需 MCPO 作为中间代理。
+
+## 功能特性
+
+- ✅ **自动 OpenAPI 生成**：将 MCP 工具转换为 OpenAPI 3.0.3 规范
+- ✅ **OpenWebUI 兼容**：无需 MCPO 代理的直接集成
+- ✅ **实时工具发现**：动态包含已连接 MCP 服务器的工具
+- ✅ **双参数支持**：支持 GET（查询参数）和 POST（JSON 正文）进行工具执行
+- ✅ **无需身份验证**：OpenAPI 端点公开，便于集成
+- ✅ **完整元数据**：具有适当模式和文档的完整 OpenAPI 规范
+
+## API 端点
+
+### OpenAPI 规范
+
+<CodeGroup>
+
+```bash GET /api/openapi.json
+curl "http://localhost:3000/api/openapi.json"
+```
+
+```bash 带参数
+curl "http://localhost:3000/api/openapi.json?title=我的 MCP API&version=2.0.0"
+```
+
+</CodeGroup>
+
+生成并返回所有已连接 MCP 工具的完整 OpenAPI 3.0.3 规范。
+
+**查询参数：**
+
+<ParamField query="title" type="string" optional>
+  自定义 API 标题
+</ParamField>
+
+<ParamField query="description" type="string" optional>
+  自定义 API 描述
+</ParamField>
+
+<ParamField query="version" type="string" optional>
+  自定义 API 版本
+</ParamField>
+
+<ParamField query="serverUrl" type="string" optional>
+  自定义服务器 URL
+</ParamField>
+
+<ParamField query="includeDisabled" type="boolean" optional default="false">
+  包含禁用的工具
+</ParamField>
+
+<ParamField query="servers" type="string" optional>
+  要包含的服务器名称列表（逗号分隔）
+</ParamField>
+
+### 可用服务器
+
+<CodeGroup>
+
+```bash GET /api/openapi/servers
+curl "http://localhost:3000/api/openapi/servers"
+```
+
+</CodeGroup>
+
+返回已连接的 MCP 服务器名称列表。
+
+<ResponseExample>
+
+```json 示例响应
+{
+  "success": true,
+  "data": ["amap", "playwright", "slack"]
+}
+```
+
+</ResponseExample>
+
+### 工具统计
+
+<CodeGroup>
+
+```bash GET /api/openapi/stats
+curl "http://localhost:3000/api/openapi/stats"
+```
+
+</CodeGroup>
+
+返回有关可用工具和服务器的统计信息。
+
+<ResponseExample>
+
+```json 示例响应
+{
+  "success": true,
+  "data": {
+    "totalServers": 3,
+    "totalTools": 41,
+    "serverBreakdown": [
+      {"name": "amap", "toolCount": 12, "status": "connected"},
+      {"name": "playwright", "toolCount": 21, "status": "connected"},
+      {"name": "slack", "toolCount": 8, "status": "connected"}
+    ]
+  }
+}
+```
+
+</ResponseExample>
+
+### 工具执行
+
+<CodeGroup>
+
+```bash GET /api/tools/{serverName}/{toolName}
+curl "http://localhost:3000/api/tools/amap/amap-maps_weather?city=Beijing"
+```
+
+```bash POST /api/tools/{serverName}/{toolName}
+curl -X POST "http://localhost:3000/api/tools/playwright/playwright-browser_navigate" \
+  -H "Content-Type: application/json" \
+  -d '{"url": "https://example.com"}'
+```
+
+</CodeGroup>
+
+通过 OpenAPI 兼容端点执行 MCP 工具。
+
+**路径参数：**
+
+<ParamField path="serverName" type="string" required>
+  MCP 服务器的名称
+</ParamField>
+
+<ParamField path="toolName" type="string" required>
+  要执行的工具名称
+</ParamField>
+
+## OpenWebUI 集成
+
+要将 MCPHub 与 OpenWebUI 集成：
+
+<Steps>
+  <Step title="启动 MCPHub">
+    确保 MCPHub 正在运行，并且已配置 MCP 服务器
+  </Step>
+  <Step title="获取 OpenAPI 规范">
+    ```bash
+    curl http://localhost:3000/api/openapi.json > mcphub-api.json
+    ```
+  </Step>
+  <Step title="添加到 OpenWebUI">
+    在 OpenWebUI 中导入 OpenAPI 规范文件或直接指向 URL
+  </Step>
+</Steps>
+
+### 配置示例
+
+在 OpenWebUI 中，您可以通过以下方式将 MCPHub 添加为 OpenAPI 工具：
+
+<CardGroup cols={2}>
+  <Card title="OpenAPI URL" icon="link">
+    `http://localhost:3000/api/openapi.json`
+  </Card>
+  <Card title="基础 URL" icon="server">
+    `http://localhost:3000/api`
+  </Card>
+</CardGroup>
+
+## 生成的 OpenAPI 结构
+
+生成的 OpenAPI 规范包括：
+
+### 工具转换逻辑
+
+- **简单工具**（≤10 个原始参数）→ 带查询参数的 GET 端点
+- **复杂工具**（对象、数组或 >10 个参数）→ 带 JSON 请求正文的 POST 端点
+- **所有工具**都包含完整的响应模式和错误处理
+
+### 生成操作示例
+
+```yaml
+/tools/amap/amap-maps_weather:
+  get:
+    summary: "根据城市名称或者标准adcode查询指定城市的天气"
+    operationId: "amap_amap-maps_weather"
+    tags: ["amap"]
+    parameters:
+      - name: city
+        in: query
+        required: true
+        description: "城市名称或者adcode"
+        schema:
+          type: string
+    responses:
+      '200':
+        description: "Successful tool execution"
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ToolResponse'
+```
+
+### 安全性
+
+- 定义了 Bearer 身份验证但不对工具执行端点强制执行
+- 支持与各种 OpenAPI 兼容系统的灵活集成
+
+## 相比 MCPO 的优势
+
+<CardGroup cols={2}>
+  <Card title="直接集成" icon="plug">
+    无需中间代理
+  </Card>
+  <Card title="实时更新" icon="refresh">
+    OpenAPI 规范随着 MCP 服务器连接/断开自动更新
+  </Card>
+  <Card title="更好的性能" icon="bolt">
+    直接工具执行，无代理开销
+  </Card>
+  <Card title="简化架构" icon="layer-group">
+    减少一个需要管理的组件
+  </Card>
+</CardGroup>
+
+## 故障排除
+
+<AccordionGroup>
+  <Accordion title="OpenAPI 规范显示没有工具">
+    确保 MCP 服务器已连接。检查 `/api/openapi/stats` 查看服务器状态。
+  </Accordion>
+  
+  <Accordion title="工具执行失败">
+    验证工具名称和参数是否与 OpenAPI 规范匹配。检查服务器日志以获取详细信息。
+  </Accordion>
+  
+  <Accordion title="OpenWebUI 无法连接">
+    确保 MCPHub 可从 OpenWebUI 访问，并且 OpenAPI URL 正确。
+  </Accordion>
+  
+  <Accordion title="规范中缺少工具">
+    检查您的 MCP 服务器配置中是否启用了工具。使用 `includeDisabled=true` 查看所有工具。
+  </Accordion>
+</AccordionGroup>

docs/zh/api-reference/servers.mdx

@@ -0,0 +1,209 @@
+---
+title: "服务器"
+description: "管理您的 MCP 服务器。"
+---
+
+import { Card, Cards } from 'mintlify';
+
+<Card
+  title="GET /api/servers"
+  href="#get-all-servers"
+>
+  获取所有 MCP 服务器的列表。
+</Card>
+
+<Card
+  title="POST /api/servers"
+  href="#create-a-new-server"
+>
+  创建一个新的 MCP 服务器。
+</Card>
+
+<Card
+  title="PUT /api/servers/:name"
+  href="#update-a-server"
+>
+  更新现有的 MCP 服务器。
+</Card>
+
+<Card
+  title="DELETE /api/servers/:name"
+  href="#delete-a-server"
+>
+  删除一个 MCP 服务器。
+</Card>
+
+<Card
+  title="POST /api/servers/:name/toggle"
+  href="#toggle-a-server"
+>
+  切换服务器的启用状态。
+</Card>
+
+<Card
+  title="POST /api/servers/:serverName/tools/:toolName/toggle"
+  href="#toggle-a-tool"
+>
+  切换工具的启用状态。
+</Card>
+
+<Card
+  title="PUT /api/servers/:serverName/tools/:toolName/description"
+  href="#update-tool-description"
+>
+  更新工具的描述。
+</Card>
+
+---
+
+### 获取所有服务器
+
+检索所有已配置的 MCP 服务器的列表，包括其状态和可用工具。
+
+- **端点**: `/api/servers`
+- **方法**: `GET`
+- **响应**:
+  ```json
+  {
+    "success": true,
+    "data": [
+      {
+        "name": "example-server",
+        "status": "connected",
+        "tools": [
+          {
+            "name": "tool1",
+            "description": "工具1的描述"
+          }
+        ],
+        "config": {
+          "type": "stdio",
+          "command": "node",
+          "args": ["server.js"]
+        }
+      }
+    ]
+  }
+  ```
+
+---
+
+### 创建一个新服务器
+
+将一个新的 MCP 服务器添加到配置中。
+
+- **端点**: `/api/servers`
+- **方法**: `POST`
+- **正文**:
+  ```json
+  {
+    "name": "my-new-server",
+    "config": {
+      "type": "stdio",
+      "command": "python",
+      "args": ["-u", "my_script.py"],
+      "owner": "admin"
+    }
+  }
+  ```
+  - `name` (string, 必填): 服务器的唯一名称。
+  - `config` (object, 必填): 服务器配置对象。
+    - `type` (string): `stdio`、`sse`、`streamable-http` 或 `openapi`。
+    - `command` (string): `stdio` 类型要执行的命令。
+    - `args` (array of strings): 命令的参数。
+    - `url` (string): `sse`、`streamable-http` 或 `openapi` 类型的 URL。
+    - `openapi` (object): OpenAPI 配置。
+      - `url` (string): OpenAPI 模式的 URL。
+      - `schema` (object): OpenAPI 模式对象本身。
+    - `headers` (object): `sse`、`streamable-http` 和 `openapi` 类型请求要发送的标头。
+    - `keepAliveInterval` (number): `sse` 类型的保持活动间隔（毫秒）。默认为 60000。
+    - `owner` (string): 服务器的所有者。默认为当前用户或“admin”。
+
+---
+
+### 更新一个服务器
+
+更新现有 MCP 服务器的配置。
+
+- **端点**: `/api/servers/:name`
+- **方法**: `PUT`
+- **参数**:
+  - `:name` (string, 必填): 要更新的服务器的名称。
+- **正文**:
+  ```json
+  {
+    "config": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["new_server.js"]
+    }
+  }
+  ```
+  - `config` (object, 必填): 更新后的服务器配置对象。详情请参阅“创建一个新服务器”。
+
+---
+
+### 删除一个服务器
+
+从配置中删除一个 MCP 服务器。
+
+- **端点**: `/api/servers/:name`
+- **方法**: `DELETE`
+- **参数**:
+  - `:name` (string, 必填): 要删除的服务器的名称。
+
+---
+
+### 切换一个服务器
+
+启用或禁用一个 MCP 服务器。
+
+- **端点**: `/api/servers/:name/toggle`
+- **方法**: `POST`
+- **参数**:
+  - `:name` (string, 必填): 要切换的服务器的名称。
+- **正文**:
+  ```json
+  {
+    "enabled": true
+  }
+  ```
+  - `enabled` (boolean, 必填): `true` 启用服务器，`false` 禁用服务器。
+
+---
+
+### 切换一个工具
+
+启用或禁用服务器上的特定工具。
+
+- **端点**: `/api/servers/:serverName/tools/:toolName/toggle`
+- **方法**: `POST`
+- **参数**:
+  - `:serverName` (string, 必填): 服务器的名称。
+  - `:toolName` (string, 必填): 工具的名称。
+- **正文**:
+  ```json
+  {
+    "enabled": true
+  }
+  ```
+  - `enabled` (boolean, 必填): `true` 启用工具，`false` 禁用工具。
+
+---
+
+### 更新工具描述
+
+更新特定工具的描述。
+
+- **端点**: `/api/servers/:serverName/tools/:toolName/description`
+- **方法**: `PUT`
+- **参数**:
+  - `:serverName` (string, 必填): 服务器的名称。
+  - `:toolName` (string, 必填): 工具的名称。
+- **正文**:
+  ```json
+  {
+    "description": "新的工具描述"
+  }
+  ```
+  - `description` (string, 必填): 工具的新描述。

docs/zh/api-reference/smart-routing.mdx

@@ -0,0 +1,29 @@
+---
+title: "智能路由"
+description: "使用向量语义搜索进行智能工具发现。"
+---
+
+智能路由是 MCPHub 的智能工具发现系统，它使用向量语义搜索来自动为任何给定任务找到最相关的工具。
+
+### HTTP 端点
+
+- **端点**: `http://localhost:3000/mcp/$smart`
+- **方法**: `POST`
+
+### SSE 端点 (已弃用)
+
+- **端点**: `http://localhost:3000/sse/$smart`
+- **方法**: `GET`
+
+### 工作原理
+
+1.  **工具索引**: 所有 MCP 工具都会自动转换为向量嵌入并存储在带有 pgvector 的 PostgreSQL 中。
+2.  **语义搜索**: 用户查询被转换为向量，并使用余弦相似度与工具嵌入进行匹配。
+3.  **智能过滤**: 动态阈值可确保相关结果而无噪音。
+4.  **精确执行**: 找到的工具可以通过适当的参数验证直接执行。
+
+### 设置要求
+
+- 带有 pgvector 扩展的 PostgreSQL
+- OpenAI API 密钥（或兼容的嵌入服务）
+- 在 MCPHub 设置中启用智能路由

docs/zh/configuration/environment-variables.mdx

@@ -1,271 +1,44 @@
 ---
-title: '环境变量配置'
+title: '环境变量'
 description: '使用环境变量配置 MCPHub'
 ---
 
-# 环境变量配置
+# 环境变量
 
-MCPHub 使用环境变量进行配置。本指南涵盖所有可用变量及其用法。
+MCPHub 使用环境变量进行配置。本指南涵盖了所有可用的变量及其用法。
 
 ## 核心应用设置
 
 ### 服务器配置
 
-| 变量        | 默认值        | 描述                                            |
-| ----------- | ------------- | ----------------------------------------------- |
-| `PORT`      | `3000`        | HTTP 服务器端口号                               |
-| `HOST`      | `0.0.0.0`     | 服务器绑定的主机地址                            |
-| `NODE_ENV`  | `development` | 应用环境（`development`、`production`、`test`） |
-| `LOG_LEVEL` | `info`        | 日志级别（`error`、`warn`、`info`、`debug`）    |
+| 变量 | 默认值 | 描述 |
+| --- | --- | --- |
+| `PORT` | `3000` | HTTP 服务器的端口号 |
+| `INIT_TIMEOUT` | `300000` | 应用程序的初始超时时间 |
+| `BASE_PATH` | `''` | 应用程序的基本路径 |
+| `READONLY` | `false` | 设置为 `true` 以启用只读模式 |
+| `MCPHUB_SETTING_PATH` | | MCPHub 设置文件的路径 |
+| `NODE_ENV` | `development` | 应用程序环境 (`development`, `production`, `test`) |
 
 ```env
 PORT=3000
-HOST=0.0.0.0
+INIT_TIMEOUT=300000
+BASE_PATH=/api
+READONLY=true
+MCPHUB_SETTING_PATH=/path/to/settings
 NODE_ENV=production
-LOG_LEVEL=info
-```
-
-### 数据库配置
-
-| 变量           | 默认值      | 描述                  |
-| -------------- | ----------- | --------------------- |
-| `DATABASE_URL` | -           | PostgreSQL 连接字符串 |
-| `DB_HOST`      | `localhost` | 数据库主机            |
-| `DB_PORT`      | `5432`      | 数据库端口            |
-| `DB_NAME`      | `mcphub`    | 数据库名称            |
-| `DB_USER`      | `mcphub`    | 数据库用户名          |
-| `DB_PASSWORD`  | -           | 数据库密码            |
-| `DB_SSL`       | `false`     | 启用数据库 SSL 连接   |
-| `DB_POOL_MIN`  | `2`         | 最小数据库连接池大小  |
-| `DB_POOL_MAX`  | `10`        | 最大数据库连接池大小  |
-
-```env
-# 选项 1：完整连接字符串
-DATABASE_URL=postgresql://username:password@localhost:5432/mcphub
-
-# 选项 2：单独组件
-DB_HOST=localhost
-DB_PORT=5432
-DB_NAME=mcphub
-DB_USER=mcphub
-DB_PASSWORD=your-password
-DB_SSL=false
 ```
 
 ## 认证与安全
 
 ### JWT 配置
 
-| 变量                     | 默认值  | 描述                     |
-| ------------------------ | ------- | ------------------------ |
-| `JWT_SECRET`             | -       | JWT 令牌签名密钥（必需） |
-| `JWT_EXPIRES_IN`         | `24h`   | JWT 令牌过期时间         |
-| `JWT_REFRESH_EXPIRES_IN` | `7d`    | 刷新令牌过期时间         |
-| `JWT_ALGORITHM`          | `HS256` | JWT 签名算法             |
+| 变量 | 默认值 | 描述 |
+| --- | --- | --- |
+| `JWT_SECRET` | - | 用于 JWT 令牌签名的密钥 (必需) |
 
 ```env
 JWT_SECRET=your-super-secret-key-change-this-in-production
-JWT_EXPIRES_IN=24h
-JWT_REFRESH_EXPIRES_IN=7d
-```
-
-### 会话与安全
-
-| 变量                | 默认值 | 描述                 |
-| ------------------- | ------ | -------------------- |
-| `SESSION_SECRET`    | -      | 会话加密密钥         |
-| `BCRYPT_ROUNDS`     | `12`   | bcrypt 哈希轮数      |
-| `RATE_LIMIT_WINDOW` | `15`   | 速率限制窗口（分钟） |
-| `RATE_LIMIT_MAX`    | `100`  | 每个窗口最大请求数   |
-| `CORS_ORIGIN`       | `*`    | 允许的 CORS 来源     |
-
-```env
-SESSION_SECRET=your-session-secret
-BCRYPT_ROUNDS=12
-RATE_LIMIT_WINDOW=15
-RATE_LIMIT_MAX=100
-CORS_ORIGIN=https://your-domain.com,https://admin.your-domain.com
-```
-
-## 外部服务
-
-### OpenAI 配置
-
-| 变量                     | 默认值                   | 描述                            |
-| ------------------------ | ------------------------ | ------------------------------- |
-| `OPENAI_API_KEY`         | -                        | OpenAI API 密钥（用于智能路由） |
-| `OPENAI_MODEL`           | `gpt-3.5-turbo`          | OpenAI 嵌入模型                 |
-| `OPENAI_EMBEDDING_MODEL` | `text-embedding-ada-002` | 向量嵌入模型                    |
-| `OPENAI_MAX_TOKENS`      | `1000`                   | 每个请求最大令牌数              |
-| `OPENAI_TEMPERATURE`     | `0.1`                    | AI 响应温度                     |
-
-```env
-OPENAI_API_KEY=sk-your-openai-api-key
-OPENAI_MODEL=gpt-3.5-turbo
-OPENAI_EMBEDDING_MODEL=text-embedding-ada-002
-OPENAI_MAX_TOKENS=1000
-OPENAI_TEMPERATURE=0.1
-```
-
-### Redis 配置（可选）
-
-| 变量             | 默认值      | 描述             |
-| ---------------- | ----------- | ---------------- |
-| `REDIS_URL`      | -           | Redis 连接字符串 |
-| `REDIS_HOST`     | `localhost` | Redis 主机       |
-| `REDIS_PORT`     | `6379`      | Redis 端口       |
-| `REDIS_PASSWORD` | -           | Redis 密码       |
-| `REDIS_DB`       | `0`         | Redis 数据库编号 |
-| `REDIS_PREFIX`   | `mcphub:`   | Redis 键前缀     |
-
-```env
-# 选项 1：完整连接字符串
-REDIS_URL=redis://username:password@localhost:6379/0
-
-# 选项 2：单独组件
-REDIS_HOST=localhost
-REDIS_PORT=6379
-REDIS_PASSWORD=your-redis-password
-REDIS_DB=0
-REDIS_PREFIX=mcphub:
-```
-
-## MCP 服务器配置
-
-### 默认设置
-
-| 变量                | 默认值              | 描述                         |
-| ------------------- | ------------------- | ---------------------------- |
-| `MCP_SETTINGS_FILE` | `mcp_settings.json` | MCP 设置文件路径             |
-| `MCP_SERVERS_FILE`  | `servers.json`      | 服务器配置文件路径           |
-| `MCP_TIMEOUT`       | `30000`             | MCP 操作默认超时（毫秒）     |
-| `MCP_MAX_RETRIES`   | `3`                 | 失败操作最大重试次数         |
-| `MCP_RESTART_DELAY` | `5000`              | 重启失败服务器的延迟（毫秒） |
-
-```env
-MCP_SETTINGS_FILE=./config/mcp_settings.json
-MCP_SERVERS_FILE=./config/servers.json
-MCP_TIMEOUT=30000
-MCP_MAX_RETRIES=3
-MCP_RESTART_DELAY=5000
-```
-
-### 智能路由
-
-| 变量                        | 默认值 | 描述                   |
-| --------------------------- | ------ | ---------------------- |
-| `SMART_ROUTING_ENABLED`     | `true` | 启用 AI 驱动的智能路由 |
-| `SMART_ROUTING_THRESHOLD`   | `0.7`  | 路由相似度阈值         |
-| `SMART_ROUTING_MAX_RESULTS` | `5`    | 返回的最大工具数       |
-| `VECTOR_CACHE_TTL`          | `3600` | 向量缓存 TTL（秒）     |
-
-```env
-SMART_ROUTING_ENABLED=true
-SMART_ROUTING_THRESHOLD=0.7
-SMART_ROUTING_MAX_RESULTS=5
-VECTOR_CACHE_TTL=3600
-```
-
-## 文件存储与上传
-
-| 变量                 | 默认值           | 描述                             |
-| -------------------- | ---------------- | -------------------------------- |
-| `UPLOAD_DIR`         | `./uploads`      | 文件上传目录                     |
-| `MAX_FILE_SIZE`      | `10485760`       | 最大文件大小（字节，10MB）       |
-| `ALLOWED_FILE_TYPES` | `image/*,text/*` | 允许的 MIME 类型                 |
-| `STORAGE_TYPE`       | `local`          | 存储类型（`local`、`s3`、`gcs`） |
-
-```env
-UPLOAD_DIR=./data/uploads
-MAX_FILE_SIZE=10485760
-ALLOWED_FILE_TYPES=image/*,text/*,application/json
-STORAGE_TYPE=local
-```
-
-### S3 存储（可选）
-
-| 变量                   | 默认值      | 描述           |
-| ---------------------- | ----------- | -------------- |
-| `S3_BUCKET`            | -           | S3 存储桶名称  |
-| `S3_REGION`            | `us-east-1` | S3 区域        |
-| `S3_ACCESS_KEY_ID`     | -           | S3 访问密钥    |
-| `S3_SECRET_ACCESS_KEY` | -           | S3 密钥        |
-| `S3_ENDPOINT`          | -           | 自定义 S3 端点 |
-
-```env
-S3_BUCKET=mcphub-uploads
-S3_REGION=us-east-1
-S3_ACCESS_KEY_ID=your-access-key
-S3_SECRET_ACCESS_KEY=your-secret-key
-```
-
-## 监控与日志
-
-### 应用监控
-
-| 变量                     | 默认值  | 描述                 |
-| ------------------------ | ------- | -------------------- |
-| `METRICS_ENABLED`        | `true`  | 启用指标收集         |
-| `METRICS_PORT`           | `9090`  | 指标端点端口         |
-| `HEALTH_CHECK_INTERVAL`  | `30000` | 健康检查间隔（毫秒） |
-| `PERFORMANCE_MONITORING` | `false` | 启用性能监控         |
-
-```env
-METRICS_ENABLED=true
-METRICS_PORT=9090
-HEALTH_CHECK_INTERVAL=30000
-PERFORMANCE_MONITORING=true
-```
-
-### 日志配置
-
-| 变量               | 默认值       | 描述                             |
-| ------------------ | ------------ | -------------------------------- |
-| `LOG_FORMAT`       | `json`       | 日志格式（`json`、`text`）       |
-| `LOG_FILE`         | -            | 日志文件路径（如果启用文件日志） |
-| `LOG_MAX_SIZE`     | `10m`        | 最大日志文件大小                 |
-| `LOG_MAX_FILES`    | `5`          | 最大日志文件数                   |
-| `LOG_DATE_PATTERN` | `YYYY-MM-DD` | 日志轮换日期模式                 |
-
-```env
-LOG_FORMAT=json
-LOG_FILE=./logs/mcphub.log
-LOG_MAX_SIZE=10m
-LOG_MAX_FILES=5
-LOG_DATE_PATTERN=YYYY-MM-DD
-```
-
-## 开发与调试
-
-| 变量                     | 默认值  | 描述                            |
-| ------------------------ | ------- | ------------------------------- |
-| `DEBUG`                  | -       | 调试命名空间（例如 `mcphub:*`） |
-| `DEV_TOOLS_ENABLED`      | `false` | 启用开发工具                    |
-| `HOT_RELOAD`             | `true`  | 在开发中启用热重载              |
-| `MOCK_EXTERNAL_SERVICES` | `false` | 模拟外部 API 调用               |
-
-```env
-DEBUG=mcphub:*
-DEV_TOOLS_ENABLED=true
-HOT_RELOAD=true
-MOCK_EXTERNAL_SERVICES=false
-```
-
-## 生产优化
-
-| 变量               | 默认值  | 描述                   |
-| ------------------ | ------- | ---------------------- |
-| `CLUSTER_MODE`     | `false` | 启用集群模式           |
-| `WORKER_PROCESSES` | `0`     | 工作进程数（0 = 自动） |
-| `MEMORY_LIMIT`     | -       | 每个进程内存限制       |
-| `CPU_LIMIT`        | -       | 每个进程 CPU 限制      |
-| `GC_OPTIMIZE`      | `false` | 启用垃圾回收优化       |
-
-```env
-CLUSTER_MODE=true
-WORKER_PROCESSES=4
-MEMORY_LIMIT=512M
-GC_OPTIMIZE=true
 ```
 
 ## 配置示例
@@ -276,22 +49,9 @@ GC_OPTIMIZE=true
 # .env.development
 NODE_ENV=development
 PORT=3000
-LOG_LEVEL=debug
-
-# 数据库
-DATABASE_URL=postgresql://mcphub:password@localhost:5432/mcphub_dev
 
 # 认证
 JWT_SECRET=dev-secret-key
-JWT_EXPIRES_IN=24h
-
-# OpenAI（开发时可选）
-# OPENAI_API_KEY=your-dev-key
-
-# 调试
-DEBUG=mcphub:*
-DEV_TOOLS_ENABLED=true
-HOT_RELOAD=true
 ```
 
 ### 生产环境
@@ -300,30 +60,9 @@ HOT_RELOAD=true
 # .env.production
 NODE_ENV=production
 PORT=3000
-LOG_LEVEL=info
-LOG_FORMAT=json
-
-# 数据库
-DATABASE_URL=postgresql://mcphub:secure-password@db.example.com:5432/mcphub
-DB_SSL=true
-DB_POOL_MAX=20
 
 # 安全
 JWT_SECRET=your-super-secure-production-secret
-SESSION_SECRET=your-session-secret
-BCRYPT_ROUNDS=14
-
-# 外部服务
-OPENAI_API_KEY=your-production-openai-key
-REDIS_URL=redis://redis.example.com:6379
-
-# 监控
-METRICS_ENABLED=true
-PERFORMANCE_MONITORING=true
-
-# 优化
-CLUSTER_MODE=true
-GC_OPTIMIZE=true
 ```
 
 ### Docker 环境
@@ -331,21 +70,10 @@ GC_OPTIMIZE=true
 ```env
 # .env.docker
 NODE_ENV=production
-HOST=0.0.0.0
 PORT=3000
 
-# 使用 Docker 网络的服务名
-DATABASE_URL=postgresql://mcphub:password@postgres:5432/mcphub
-REDIS_URL=redis://redis:6379
-
 # 安全
 JWT_SECRET_FILE=/run/secrets/jwt_secret
-DB_PASSWORD_FILE=/run/secrets/db_password
-
-# 容器中的文件路径
-MCP_SETTINGS_FILE=/app/mcp_settings.json
-UPLOAD_DIR=/app/data/uploads
-LOG_FILE=/app/logs/mcphub.log
 ```
 
 ## 环境变量加载
@@ -353,8 +81,8 @@ LOG_FILE=/app/logs/mcphub.log
 MCPHub 按以下顺序加载环境变量：
 
 1. 系统环境变量
-2. `.env.local`（被 git 忽略）
-3. `.env.{NODE_ENV}`（例如 `.env.production`）
+2. `.env.local` (被 git 忽略)
+3. `.env.{NODE_ENV}` (例如, `.env.production`)
 4. `.env`
 
 ### 使用 dotenv-expand
@@ -364,26 +92,13 @@ MCPHub 支持变量扩展：
 ```env
 BASE_URL=https://api.example.com
 API_ENDPOINT=${BASE_URL}/v1
-DATABASE_URL=postgresql://${DB_USER}:${DB_PASSWORD}@${DB_HOST}:${DB_PORT}/${DB_NAME}
 ```
 
 ## 安全最佳实践
 
-1. **永远不要提交密钥**到版本控制
-2. **为生产使用强唯一密钥**
+1. **永远不要将密钥提交**到版本控制
+2. **为生产环境使用强大、独特的密钥**
 3. **定期轮换密钥**
 4. **使用特定于环境的文件**
 5. **在启动时验证所有环境变量**
 6. **为容器部署使用 Docker 密钥**
-
-## 验证
-
-MCPHub 在启动时验证环境变量。无效配置将阻止应用程序启动并提供有用的错误消息。
-
-生产环境必需变量：
-
-- `JWT_SECRET`
-- `DATABASE_URL` 或单独的数据库组件
-- `OPENAI_API_KEY`（如果启用智能路由）
-
-这个全面的环境配置确保 MCPHub 可以为任何部署场景正确配置。

frontend/index.html

@@ -4,7 +4,7 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>MCP Hub Dashboard</title>
+  <title>MCPHub Dashboard</title>
   <link rel="icon" type="image/x-icon" href="/favicon.ico">
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>

frontend/src/components/ServerCard.tsx

@@ -4,6 +4,7 @@ import { Server } from '@/types'
 import { ChevronDown, ChevronRight, AlertCircle, Copy, Check } from 'lucide-react'
 import { StatusBadge } from '@/components/ui/Badge'
 import ToolCard from '@/components/ui/ToolCard'
+import PromptCard from '@/components/ui/PromptCard'
 import DeleteDialog from '@/components/ui/DeleteDialog'
 import { useToast } from '@/contexts/ToastContext'
 
@@ -107,7 +108,6 @@ const ServerCard = ({ server, onRemove, onEdit, onToggle, onRefresh }: ServerCar
     try {
       const { toggleTool } = await import('@/services/toolService')
       const result = await toggleTool(server.name, toolName, enabled)
-
       if (result.success) {
         showToast(
           t(enabled ? 'tool.enableSuccess' : 'tool.disableSuccess', { name: toolName }),
@@ -126,6 +126,28 @@ const ServerCard = ({ server, onRemove, onEdit, onToggle, onRefresh }: ServerCar
     }
   }
 
+  const handlePromptToggle = async (promptName: string, enabled: boolean) => {
+    try {
+      const { togglePrompt } = await import('@/services/promptService')
+      const result = await togglePrompt(server.name, promptName, enabled)
+      if (result.success) {
+        showToast(
+          t(enabled ? 'tool.enableSuccess' : 'tool.disableSuccess', { name: promptName }),
+          'success'
+        )
+        // Trigger refresh to update the prompt's state in the UI
+        if (onRefresh) {
+          onRefresh()
+        }
+      } else {
+        showToast(result.error || t('tool.toggleFailed'), 'error')
+      }
+    } catch (error) {
+      console.error('Error toggling prompt:', error)
+      showToast(t('tool.toggleFailed'), 'error')
+    }
+  }
+
   return (
     <>
       <div className={`bg-white shadow rounded-lg p-6 mb-6 page-card transition-all duration-200 ${server.enabled === false ? 'opacity-60' : ''}`}>
@@ -145,6 +167,15 @@ const ServerCard = ({ server, onRemove, onEdit, onToggle, onRefresh }: ServerCar
               <span>{server.tools?.length || 0} {t('server.tools')}</span>
             </div>
 
+            {/* Prompt count display */}
+            <div className="flex items-center px-2 py-1 bg-purple-50 text-purple-700 rounded-full text-sm btn-primary">
+              <svg className="w-4 h-4 mr-1" fill="currentColor" viewBox="0 0 20 20">
+                <path d="M2 5a2 2 0 012-2h7a2 2 0 012 2v4a2 2 0 01-2 2H9l-3 3v-3H4a2 2 0 01-2-2V5z" />
+                <path d="M15 7v2a4 4 0 01-4 4H9.828l-1.766 1.767c.28.149.599.233.938.233h2l3 3v-3h2a2 2 0 002-2V9a2 2 0 00-2-2h-1z" />
+              </svg>
+              <span>{server.prompts?.length || 0} {t('server.prompts')}</span>
+            </div>
+
             {server.error && (
               <div className="relative">
                 <div
@@ -236,15 +267,35 @@ const ServerCard = ({ server, onRemove, onEdit, onToggle, onRefresh }: ServerCar
           </div>
         </div>
 
-        {isExpanded && server.tools && (
-          <div className="mt-6">
-            <h6 className={`font-medium ${server.enabled === false ? 'text-gray-600' : 'text-gray-900'} mb-4`}>{t('server.tools')}</h6>
-            <div className="space-y-4">
-              {server.tools.map((tool, index) => (
-                <ToolCard key={index} server={server.name} tool={tool} onToggle={handleToolToggle} />
-              ))}
-            </div>
-          </div>
+        {isExpanded && (
+          <>
+            {server.tools && (
+              <div className="mt-6">
+                <h6 className={`font-medium ${server.enabled === false ? 'text-gray-600' : 'text-gray-900'} mb-4`}>{t('server.tools')}</h6>
+                <div className="space-y-4">
+                  {server.tools.map((tool, index) => (
+                    <ToolCard key={index} server={server.name} tool={tool} onToggle={handleToolToggle} />
+                  ))}
+                </div>
+              </div>
+            )}
+
+            {server.prompts && (
+              <div className="mt-6">
+                <h6 className={`font-medium ${server.enabled === false ? 'text-gray-600' : 'text-gray-900'} mb-4`}>{t('server.prompts')}</h6>
+                <div className="space-y-4">
+                  {server.prompts.map((prompt, index) => (
+                    <PromptCard 
+                      key={index} 
+                      server={server.name} 
+                      prompt={prompt} 
+                      onToggle={handlePromptToggle} 
+                    />
+                  ))}
+                </div>
+              </div>
+            )}
+          </>
         )}
       </div>
 

frontend/src/components/ui/PromptCard.tsx

@@ -0,0 +1,300 @@
+import { useState, useCallback, useRef, useEffect } from 'react'
+import { useTranslation } from 'react-i18next'
+import { Prompt } from '@/types'
+import { ChevronDown, ChevronRight, Play, Loader, Edit, Check } from '@/components/icons/LucideIcons'
+import { Switch } from './ToggleGroup'
+import { getPrompt, PromptCallResult } from '@/services/promptService'
+import DynamicForm from './DynamicForm'
+import PromptResult from './PromptResult'
+
+interface PromptCardProps {
+  server: string
+  prompt: Prompt
+  onToggle?: (promptName: string, enabled: boolean) => void
+  onDescriptionUpdate?: (promptName: string, description: string) => void
+}
+
+const PromptCard = ({ prompt, server, onToggle, onDescriptionUpdate }: PromptCardProps) => {
+  const { t } = useTranslation()
+  const [isExpanded, setIsExpanded] = useState(false)
+  const [showRunForm, setShowRunForm] = useState(false)
+  const [isRunning, setIsRunning] = useState(false)
+  const [result, setResult] = useState<PromptCallResult | null>(null)
+  const [isEditingDescription, setIsEditingDescription] = useState(false)
+  const [customDescription, setCustomDescription] = useState(prompt.description || '')
+  const descriptionInputRef = useRef<HTMLInputElement>(null)
+  const descriptionTextRef = useRef<HTMLSpanElement>(null)
+  const [textWidth, setTextWidth] = useState<number>(0)
+
+  // Focus the input when editing mode is activated
+  useEffect(() => {
+    if (isEditingDescription && descriptionInputRef.current) {
+      descriptionInputRef.current.focus()
+      // Set input width to match text width
+      if (textWidth > 0) {
+        descriptionInputRef.current.style.width = `${textWidth + 20}px` // Add some padding
+      }
+    }
+  }, [isEditingDescription, textWidth])
+
+  // Measure text width when not editing
+  useEffect(() => {
+    if (!isEditingDescription && descriptionTextRef.current) {
+      setTextWidth(descriptionTextRef.current.offsetWidth)
+    }
+  }, [isEditingDescription, customDescription])
+
+  // Generate a unique key for localStorage based on prompt name and server
+  const getStorageKey = useCallback(() => {
+    return `mcphub_prompt_form_${server ? `${server}_` : ''}${prompt.name}`
+  }, [prompt.name, server])
+
+  // Clear form data from localStorage
+  const clearStoredFormData = useCallback(() => {
+    localStorage.removeItem(getStorageKey())
+  }, [getStorageKey])
+
+  const handleToggle = (enabled: boolean) => {
+    if (onToggle) {
+      onToggle(prompt.name, enabled)
+    }
+  }
+
+  const handleDescriptionEdit = () => {
+    setIsEditingDescription(true)
+  }
+
+  const handleDescriptionSave = async () => {
+    // For now, we'll just update the local state
+    // In a real implementation, you would call an API to update the description
+    setIsEditingDescription(false)
+    if (onDescriptionUpdate) {
+      onDescriptionUpdate(prompt.name, customDescription)
+    }
+  }
+
+  const handleDescriptionChange = (e: React.ChangeEvent<HTMLInputElement>) => {
+    setCustomDescription(e.target.value)
+  }
+
+  const handleDescriptionKeyDown = (e: React.KeyboardEvent<HTMLInputElement>) => {
+    if (e.key === 'Enter') {
+      handleDescriptionSave()
+    } else if (e.key === 'Escape') {
+      setCustomDescription(prompt.description || '')
+      setIsEditingDescription(false)
+    }
+  }
+
+  const handleGetPrompt = async (arguments_: Record<string, any>) => {
+    setIsRunning(true)
+    try {
+      const result = await getPrompt({ promptName: prompt.name, arguments: arguments_ }, server)
+      console.log('GetPrompt result:', result)
+      setResult({
+        success: result.success,
+        data: result.data,
+        error: result.error
+      })
+      // Clear form data on successful submission
+      // clearStoredFormData()
+    } catch (error) {
+      setResult({
+        success: false,
+        error: error instanceof Error ? error.message : 'Unknown error occurred',
+      })
+    } finally {
+      setIsRunning(false)
+    }
+  }
+
+  const handleCancelRun = () => {
+    setShowRunForm(false)
+    // Clear form data when cancelled
+    clearStoredFormData()
+    setResult(null)
+  }
+
+  const handleCloseResult = () => {
+    setResult(null)
+  }
+
+  // Convert prompt arguments to ToolInputSchema format for DynamicForm
+  const convertToSchema = () => {
+    if (!prompt.arguments || prompt.arguments.length === 0) {
+      return { type: 'object', properties: {}, required: [] }
+    }
+
+    const properties: Record<string, any> = {}
+    const required: string[] = []
+
+    prompt.arguments.forEach(arg => {
+      properties[arg.name] = {
+        type: 'string', // Default to string for prompts
+        description: arg.description || ''
+      }
+
+      if (arg.required) {
+        required.push(arg.name)
+      }
+    })
+
+    return {
+      type: 'object',
+      properties,
+      required
+    }
+  }
+
+  return (
+    <div className="bg-white border border-gray-200 shadow rounded-lg p-4 mb-4">
+      <div
+        className="flex justify-between items-center cursor-pointer"
+        onClick={() => setIsExpanded(!isExpanded)}
+      >
+        <div className="flex-1">
+          <h3 className="text-lg font-medium text-gray-900">
+            {prompt.name.replace(server + '-', '')}
+            {prompt.title && (
+              <span className="ml-2 text-sm font-normal text-gray-600">
+                {prompt.title}
+              </span>
+            )}
+            <span className="ml-2 text-sm font-normal text-gray-500 inline-flex items-center">
+              {isEditingDescription ? (
+                <>
+                  <input
+                    ref={descriptionInputRef}
+                    type="text"
+                    className="px-2 py-1 border border-blue-300 rounded bg-white text-sm focus:outline-none form-input"
+                    value={customDescription}
+                    onChange={handleDescriptionChange}
+                    onKeyDown={handleDescriptionKeyDown}
+                    onClick={(e) => e.stopPropagation()}
+                    style={{
+                      minWidth: '100px',
+                      width: textWidth > 0 ? `${textWidth + 20}px` : 'auto'
+                    }}
+                  />
+                  <button
+                    className="ml-2 p-1 text-green-600 hover:text-green-800 cursor-pointer transition-colors"
+                    onClick={(e) => {
+                      e.stopPropagation()
+                      handleDescriptionSave()
+                    }}
+                  >
+                    <Check size={16} />
+                  </button>
+                </>
+              ) : (
+                <>
+                  <span ref={descriptionTextRef}>{customDescription || t('tool.noDescription')}</span>
+                  <button
+                    className="ml-2 p-1 text-gray-500 hover:text-blue-600 cursor-pointer transition-colors"
+                    onClick={(e) => {
+                      e.stopPropagation()
+                      handleDescriptionEdit()
+                    }}
+                  >
+                    <Edit size={14} />
+                  </button>
+                </>
+              )}
+            </span>
+          </h3>
+        </div>
+        <div className="flex items-center space-x-2">
+          <div
+            className="flex items-center space-x-2"
+            onClick={(e) => e.stopPropagation()}
+          >
+            {prompt.enabled !== undefined && (
+              <Switch
+                checked={prompt.enabled}
+                onCheckedChange={handleToggle}
+                disabled={isRunning}
+              />
+            )}
+          </div>
+          <button
+            onClick={(e) => {
+              e.stopPropagation()
+              setIsExpanded(true) // Ensure card is expanded when showing run form
+              setShowRunForm(true)
+            }}
+            className="flex items-center space-x-1 px-3 py-1 text-sm text-blue-600 bg-blue-50 hover:bg-blue-100 rounded-md transition-colors btn-primary"
+            disabled={isRunning || !prompt.enabled}
+          >
+            {isRunning ? (
+              <Loader size={14} className="animate-spin" />
+            ) : (
+              <Play size={14} />
+            )}
+            <span>{isRunning ? t('tool.running') : t('tool.run')}</span>
+          </button>
+          <button className="text-gray-400 hover:text-gray-600">
+            {isExpanded ? <ChevronDown size={18} /> : <ChevronRight size={18} />}
+          </button>
+        </div>
+      </div>
+
+      {isExpanded && (
+        <div className="mt-4 space-y-4">
+          {/* Run Form */}
+          {showRunForm && (
+            <div className="border border-gray-300 rounded-lg p-4">
+              <DynamicForm
+                schema={convertToSchema()}
+                onSubmit={handleGetPrompt}
+                onCancel={handleCancelRun}
+                loading={isRunning}
+                storageKey={getStorageKey()}
+                title={t('prompt.runPromptWithName', { name: prompt.name.replace(server + '-', '') })}
+              />
+              {/* Prompt Result */}
+              {result && (
+                <div className="mt-4">
+                  <PromptResult result={result} onClose={handleCloseResult} />
+                </div>
+              )}
+            </div>
+          )}
+
+          {/* Arguments Display (when not showing form) */}
+          {!showRunForm && prompt.arguments && prompt.arguments.length > 0 && (
+            <div className="bg-gray-50 rounded p-3 border border-gray-300">
+              <h4 className="text-sm font-medium text-gray-900 mb-2">{t('tool.parameters')}</h4>
+              <div className="space-y-2">
+                {prompt.arguments.map((arg, index) => (
+                  <div key={index} className="flex items-start">
+                    <div className="flex-1">
+                      <div className="flex items-center">
+                        <span className="font-medium text-gray-700">{arg.name}</span>
+                        {arg.required && <span className="text-red-500 ml-1">*</span>}
+                      </div>
+                      {arg.description && (
+                        <p className="text-sm text-gray-600 mt-1">{arg.description}</p>
+                      )}
+                    </div>
+                    <div className="text-xs text-gray-500 ml-2">
+                      {arg.title || ''}
+                    </div>
+                  </div>
+                ))}
+              </div>
+            </div>
+          )}
+
+          {/* Result Display (when not showing form) */}
+          {!showRunForm && result && (
+            <div className="mt-4">
+              <PromptResult result={result} onClose={handleCloseResult} />
+            </div>
+          )}
+        </div>
+      )}
+    </div>
+  )
+}
+
+export default PromptCard

frontend/src/components/ui/PromptResult.tsx

@@ -0,0 +1,158 @@
+import React from 'react';
+import { useTranslation } from 'react-i18next';
+import { CheckCircle, XCircle, AlertCircle } from '@/components/icons/LucideIcons';
+
+interface PromptResultProps {
+  result: {
+    success: boolean;
+    data?: any;
+    error?: string;
+    message?: string;
+  };
+  onClose: () => void;
+}
+
+const PromptResult: React.FC<PromptResultProps> = ({ result, onClose }) => {
+  const { t } = useTranslation();
+
+  const renderContent = (content: any): React.ReactNode => {
+    if (typeof content === 'string') {
+      return (
+        <div className="bg-gray-50 rounded-md p-3">
+          <pre className="whitespace-pre-wrap text-sm text-gray-800 font-mono">{content}</pre>
+        </div>
+      );
+    }
+
+    if (typeof content === 'object' && content !== null) {
+      // Handle the specific prompt data structure
+      if (content.description || content.messages) {
+        return (
+          <div className="space-y-4">
+            {content.description && (
+              <div>
+                <h4 className="text-sm font-medium text-gray-900 mb-2">{t('prompt.description')}</h4>
+                <div className="bg-gray-50 rounded-md p-3">
+                  <p className="text-sm text-gray-800">{content.description}</p>
+                </div>
+              </div>
+            )}
+            
+            {content.messages && (
+              <div>
+                <h4 className="text-sm font-medium text-gray-900 mb-2">{t('prompt.messages')}</h4>
+                <div className="space-y-3">
+                  {content.messages.map((message: any, index: number) => (
+                    <div key={index} className="bg-gray-50 rounded-md p-3">
+                      <div className="flex items-center mb-2">
+                        <span className="inline-block w-16 text-xs font-medium text-gray-500">
+                          {message.role}:
+                        </span>
+                      </div>
+                      {typeof message.content === 'string' ? (
+                        <pre className="whitespace-pre-wrap text-sm text-gray-800 font-mono">
+                          {message.content}
+                        </pre>
+                      ) : typeof message.content === 'object' && message.content.type === 'text' ? (
+                        <pre className="whitespace-pre-wrap text-sm text-gray-800 font-mono">
+                          {message.content.text}
+                        </pre>
+                      ) : (
+                        <pre className="text-sm text-gray-800 overflow-auto">
+                          {JSON.stringify(message.content, null, 2)}
+                        </pre>
+                      )}
+                    </div>
+                  ))}
+                </div>
+              </div>
+            )}
+          </div>
+        );
+      }
+
+      // For other structured content, try to parse as JSON
+      try {
+        const parsed = typeof content === 'string' ? JSON.parse(content) : content;
+
+        return (
+          <div className="bg-gray-50 rounded-md p-3">
+            <div className="text-xs text-gray-500 mb-2">{t('prompt.jsonResponse')}</div>
+            <pre className="text-sm text-gray-800 overflow-auto">{JSON.stringify(parsed, null, 2)}</pre>
+          </div>
+        );
+      } catch {
+        // If not valid JSON, show as string
+        return (
+          <div className="bg-gray-50 rounded-md p-3">
+            <pre className="whitespace-pre-wrap text-sm text-gray-800 font-mono">{String(content)}</pre>
+          </div>
+        );
+      }
+    }
+
+    return (
+      <div className="bg-gray-50 rounded-md p-3">
+        <pre className="whitespace-pre-wrap text-sm text-gray-800 font-mono">{String(content)}</pre>
+      </div>
+    );
+  };
+
+  return (
+    <div className="border border-gray-300 rounded-lg bg-white shadow-sm">
+      <div className="border-b border-gray-300 px-4 py-3 bg-gray-50 rounded-t-lg">
+        <div className="flex items-center justify-between">
+          <div className="flex items-center space-x-2">
+            {result.success ? (
+              <CheckCircle size={20} className="text-status-green" />
+            ) : (
+              <XCircle size={20} className="text-status-red" />
+            )}
+            <div>
+              <h4 className="text-sm font-medium text-gray-900">
+                {t('prompt.execution')} {result.success ? t('prompt.successful') : t('prompt.failed')}
+              </h4>
+            </div>
+          </div>
+          <button
+            onClick={onClose}
+            className="text-gray-400 hover:text-gray-600 text-sm"
+          >
+            ✕
+          </button>
+        </div>
+      </div>
+
+      <div className="p-4">
+        {result.success ? (
+          <div>
+            {result.data ? (
+              <div>
+                <div className="text-sm text-gray-600 mb-3">{t('prompt.result')}</div>
+                {renderContent(result.data)}
+              </div>
+            ) : (
+              <div className="text-sm text-gray-500 italic">
+                {t('prompt.noContent')}
+              </div>
+            )}
+          </div>
+        ) : (
+          <div>
+            <div className="flex items-center space-x-2 mb-3">
+              <AlertCircle size={16} className="text-red-500" />
+              <span className="text-sm font-medium text-red-700">{t('prompt.error')}</span>
+            </div>
+            <div className="bg-red-50 border border-red-300 rounded-md p-3">
+              <pre className="text-sm text-red-800 whitespace-pre-wrap">
+                {result.error || result.message || t('prompt.unknownError')}
+              </pre>
+            </div>
+          </div>
+        )}
+      </div>
+    </div>
+  );
+};
+
+export default PromptResult;

frontend/src/components/ui/ToolCard.tsx

@@ -14,6 +14,15 @@ interface ToolCardProps {
   onDescriptionUpdate?: (toolName: string, description: string) => void
 }
 
+// Helper to check for "empty" values
+function isEmptyValue(value: any): boolean {
+  if (value == null) return true; // null or undefined
+  if (typeof value === 'string') return value.trim() === '';
+  if (Array.isArray(value)) return value.length === 0;
+  if (typeof value === 'object') return Object.keys(value).length === 0;
+  return false;
+}
+
 const ToolCard = ({ tool, server, onToggle, onDescriptionUpdate }: ToolCardProps) => {
   const { t } = useTranslation()
   const [isExpanded, setIsExpanded] = useState(false)
@@ -100,6 +109,8 @@ const ToolCard = ({ tool, server, onToggle, onDescriptionUpdate }: ToolCardProps
   const handleRunTool = async (arguments_: Record<string, any>) => {
     setIsRunning(true)
     try {
+      // filter empty values
+      arguments_ = Object.fromEntries(Object.entries(arguments_).filter(([_, v]) => !isEmptyValue(v)))
       const result = await callTool({
         toolName: tool.name,
         arguments: arguments_,

frontend/src/hooks/useSettingsData.ts

@@ -79,7 +79,7 @@ export const useSettingsData = () => {
 
   const [mcpRouterConfig, setMCPRouterConfig] = useState<MCPRouterConfig>({
     apiKey: '',
-    referer: 'https://mcphub.app',
+    referer: 'https://www.mcphubx.com',
     title: 'MCPHub',
     baseUrl: 'https://api.mcprouter.to/v1',
   });
@@ -130,7 +130,7 @@ export const useSettingsData = () => {
       if (data.success && data.data?.systemConfig?.mcpRouter) {
         setMCPRouterConfig({
           apiKey: data.data.systemConfig.mcpRouter.apiKey || '',
-          referer: data.data.systemConfig.mcpRouter.referer || 'https://mcphub.app',
+          referer: data.data.systemConfig.mcpRouter.referer || 'https://www.mcphubx.com',
           title: data.data.systemConfig.mcpRouter.title || 'MCPHub',
           baseUrl: data.data.systemConfig.mcpRouter.baseUrl || 'https://api.mcprouter.to/v1',
         });

frontend/src/pages/Dashboard.tsx

@@ -139,6 +139,9 @@ const DashboardPage: React.FC = () => {
                   <th scope="col" className="px-6 py-5 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">
                     {t('server.tools')}
                   </th>
+                  <th scope="col" className="px-6 py-5 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">
+                    {t('server.prompts')}
+                  </th>
                   <th scope="col" className="px-6 py-5 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">
                     {t('server.enabled')}
                   </th>
@@ -163,6 +166,9 @@ const DashboardPage: React.FC = () => {
                     <td className="px-6 py-4 whitespace-nowrap text-sm text-gray-500">
                       {server.tools?.length || 0}
                     </td>
+                    <td className="px-6 py-4 whitespace-nowrap text-sm text-gray-500">
+                      {server.prompts?.length || 0}
+                    </td>
                     <td className="px-6 py-4 whitespace-nowrap text-sm text-gray-500">
                       {server.enabled !== false ? (
                         <span className="text-green-600">✓</span>

frontend/src/pages/LoginPage.tsx

@@ -41,67 +41,102 @@ const LoginPage: React.FC = () => {
   };
 
   return (
-    <div className="min-h-screen flex items-center justify-center bg-gray-50 dark:bg-gray-900 py-12 px-4 sm:px-6 lg:px-8 login-container">
-      <div className="absolute top-4 right-4 w-full max-w-xs flex justify-end">
+    <div className="relative min-h-screen w-full overflow-hidden bg-gray-50 dark:bg-gray-950">
+      {/* Top-right controls */}
+      <div className="absolute top-4 right-4 z-20 flex items-center gap-2">
         <ThemeSwitch />
         <LanguageSwitch />
       </div>
-      <div className="max-w-md w-full space-y-8 login-card p-8">
-        <div>
-          <h2 className="mt-6 text-center text-3xl font-extrabold text-gray-900 dark:text-white">
-            {t('auth.loginTitle')}
-          </h2>
+
+      {/* Tech background layer */}
+      <div
+        className="pointer-events-none absolute inset-0 -z-10 opacity-60 dark:opacity-70"
+        style={{
+          backgroundImage:
+            'radial-gradient(60rem 60rem at 20% -10%, rgba(99,102,241,0.25), transparent), radial-gradient(50rem 50rem at 120% 10%, rgba(168,85,247,0.15), transparent)',
+        }}
+      />
+      <div className="pointer-events-none absolute inset-0 -z-10">
+        <svg className="h-full w-full opacity-[0.08] dark:opacity-[0.12]" xmlns="http://www.w3.org/2000/svg">
+          <defs>
+            <pattern id="grid" width="32" height="32" patternUnits="userSpaceOnUse">
+              <path d="M 32 0 L 0 0 0 32" fill="none" stroke="currentColor" strokeWidth="0.5" />
+            </pattern>
+          </defs>
+          <rect width="100%" height="100%" fill="url(#grid)" className="text-gray-400 dark:text-gray-300" />
+        </svg>
+      </div>
+
+      {/* Main content */}
+      <div className="relative mx-auto flex min-h-screen w-full max-w-md items-center justify-center px-6 py-16">
+        <div className="w-full space-y-6">
+          {/* Centered slogan */}
+          <div className="flex justify-center w-full">
+            <h1 className="text-3xl font-extrabold leading-tight tracking-tight text-gray-900 dark:text-white sm:text-4xl whitespace-nowrap">
+              <span className="bg-gradient-to-r from-indigo-400 via-cyan-400 to-emerald-400 bg-clip-text text-transparent">
+                {t('auth.slogan')}
+              </span>
+            </h1>
+          </div>
+
+          {/* Centered login card */}
+          <div className="login-card relative w-full rounded-2xl border border-white/10 bg-white/60 p-8 shadow-xl backdrop-blur-md transition dark:border-white/10 dark:bg-gray-900/60">
+            <div className="absolute -top-24 right-12 h-40 w-40 -translate-y-6 rounded-full bg-indigo-500/30 blur-3xl" />
+            <div className="absolute -bottom-24 -left-12 h-40 w-40 translate-y-6 rounded-full bg-cyan-500/20 blur-3xl" />
+            <form className="mt-4 space-y-4" onSubmit={handleSubmit}>
+              <div className="space-y-4">
+                <div>
+                  <label htmlFor="username" className="sr-only">
+                    {t('auth.username')}
+                  </label>
+                  <input
+                    id="username"
+                    name="username"
+                    type="text"
+                    autoComplete="username"
+                    required
+                    className="login-input appearance-none relative block w-full rounded-md border border-gray-300/60 bg-white/70 px-3 py-3 text-gray-900 shadow-sm outline-none ring-0 transition-all placeholder:text-gray-500 focus:border-indigo-500 focus:ring-2 focus:ring-indigo-500 dark:border-gray-700/60 dark:bg-gray-800/70 dark:text-white dark:placeholder:text-gray-400"
+                    placeholder={t('auth.username')}
+                    value={username}
+                    onChange={(e) => setUsername(e.target.value)}
+                  />
+                </div>
+                <div>
+                  <label htmlFor="password" className="sr-only">
+                    {t('auth.password')}
+                  </label>
+                  <input
+                    id="password"
+                    name="password"
+                    type="password"
+                    autoComplete="current-password"
+                    required
+                    className="login-input appearance-none relative block w-full rounded-md border border-gray-300/60 bg-white/70 px-3 py-3 text-gray-900 shadow-sm outline-none ring-0 transition-all placeholder:text-gray-500 focus:border-indigo-500 focus:ring-2 focus:ring-indigo-500 dark:border-gray-700/60 dark:bg-gray-800/70 dark:text-white dark:placeholder:text-gray-400"
+                    placeholder={t('auth.password')}
+                    value={password}
+                    onChange={(e) => setPassword(e.target.value)}
+                  />
+                </div>
+              </div>
+
+              {error && (
+                <div className="error-box rounded border border-red-500/20 bg-red-500/10 p-2 text-center text-sm text-red-600 dark:text-red-400">
+                  {error}
+                </div>
+              )}
+
+              <div>
+                <button
+                  type="submit"
+                  disabled={loading}
+                  className="login-button btn-primary group relative flex w-full items-center justify-center rounded-md border border-transparent bg-indigo-600 px-4 py-2 text-sm font-medium text-white transition-all hover:bg-indigo-700 focus:outline-none focus:ring-2 focus:ring-indigo-500 focus:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-70"
+                >
+                  {loading ? t('auth.loggingIn') : t('auth.login')}
+                </button>
+              </div>
+            </form>
+          </div>
         </div>
-        <form className="mt-8 space-y-6" onSubmit={handleSubmit}>
-          <div className="space-y-4">
-            <div>
-              <label htmlFor="username" className="sr-only">
-                {t('auth.username')}
-              </label>
-              <input
-                id="username"
-                name="username"
-                type="text"
-                autoComplete="username"
-                required
-                className="appearance-none relative block w-full px-3 py-3 border border-gray-300 dark:border-gray-600 placeholder-gray-500 dark:placeholder-gray-400 text-gray-900 dark:text-white dark:bg-gray-800 rounded-md focus:outline-none focus:ring-2 focus:ring-indigo-500 focus:border-indigo-500 focus:z-10 sm:text-sm transition-all duration-200 form-input shadow-sm"
-                placeholder={t('auth.username')}
-                value={username}
-                onChange={(e) => setUsername(e.target.value)}
-              />
-            </div>
-            <div>
-              <label htmlFor="password" className="sr-only">
-                {t('auth.password')}
-              </label>
-              <input
-                id="password"
-                name="password"
-                type="password"
-                autoComplete="current-password"
-                required
-                className="appearance-none relative block w-full px-3 py-3 border border-gray-300 dark:border-gray-600 placeholder-gray-500 dark:placeholder-gray-400 text-gray-900 dark:text-white dark:bg-gray-800 rounded-md focus:outline-none focus:ring-2 focus:ring-indigo-500 focus:border-indigo-500 focus:z-10 sm:text-sm login-input transition-all duration-200 form-input shadow-sm"
-                placeholder={t('auth.password')}
-                value={password}
-                onChange={(e) => setPassword(e.target.value)}
-              />
-            </div>
-          </div>
-
-          {error && (
-            <div className="text-red-500 dark:text-red-400 text-sm text-center error-box p-2 rounded">{error}</div>
-          )}
-
-          <div>
-            <button
-              type="submit"
-              disabled={loading}
-              className="group relative w-full flex justify-center py-2 px-4 border border-transparent text-sm font-medium rounded-md text-white bg-indigo-600 hover:bg-indigo-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-indigo-500 login-button transition-all duration-200 btn-primary"
-            >
-              {loading ? t('auth.loggingIn') : t('auth.login')}
-            </button>
-          </div>
-        </form>
       </div>
     </div>
   );

frontend/src/pages/SettingsPage.tsx

@@ -43,7 +43,7 @@ const SettingsPage: React.FC = () => {
     baseUrl: string;
   }>({
     apiKey: '',
-    referer: 'https://mcphub.app',
+    referer: 'https://www.mcphubx.com',
     title: 'MCPHub',
     baseUrl: 'https://api.mcprouter.to/v1',
   });
@@ -88,7 +88,7 @@ const SettingsPage: React.FC = () => {
     if (mcpRouterConfig) {
       setTempMCPRouterConfig({
         apiKey: mcpRouterConfig.apiKey || '',
-        referer: mcpRouterConfig.referer || 'https://mcphub.app',
+        referer: mcpRouterConfig.referer || 'https://www.mcphubx.com',
         title: mcpRouterConfig.title || 'MCPHub',
         baseUrl: mcpRouterConfig.baseUrl || 'https://api.mcprouter.to/v1',
       });
@@ -399,54 +399,6 @@ const SettingsPage: React.FC = () => {
                 </div>
               </div>
 
-              <div className="p-3 bg-gray-50 rounded-md">
-                <div className="mb-2">
-                  <h3 className="font-medium text-gray-700">{t('settings.mcpRouterReferer')}</h3>
-                  <p className="text-sm text-gray-500">{t('settings.mcpRouterRefererDescription')}</p>
-                </div>
-                <div className="flex items-center gap-3">
-                  <input
-                    type="text"
-                    value={tempMCPRouterConfig.referer}
-                    onChange={(e) => handleMCPRouterConfigChange('referer', e.target.value)}
-                    placeholder={t('settings.mcpRouterRefererPlaceholder')}
-                    className="flex-1 mt-1 block w-full py-2 px-3 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-blue-500 focus:border-blue-500 sm:text-sm form-input"
-                    disabled={loading}
-                  />
-                  <button
-                    onClick={() => saveMCPRouterConfig('referer')}
-                    disabled={loading}
-                    className="mt-1 px-4 py-2 bg-blue-600 hover:bg-blue-700 text-white rounded-md text-sm font-medium disabled:opacity-50 btn-primary"
-                  >
-                    {t('common.save')}
-                  </button>
-                </div>
-              </div>
-
-              <div className="p-3 bg-gray-50 rounded-md">
-                <div className="mb-2">
-                  <h3 className="font-medium text-gray-700">{t('settings.mcpRouterTitle')}</h3>
-                  <p className="text-sm text-gray-500">{t('settings.mcpRouterTitleDescription')}</p>
-                </div>
-                <div className="flex items-center gap-3">
-                  <input
-                    type="text"
-                    value={tempMCPRouterConfig.title}
-                    onChange={(e) => handleMCPRouterConfigChange('title', e.target.value)}
-                    placeholder={t('settings.mcpRouterTitlePlaceholder')}
-                    className="flex-1 mt-1 block w-full py-2 px-3 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-blue-500 focus:border-blue-500 sm:text-sm form-input"
-                    disabled={loading}
-                  />
-                  <button
-                    onClick={() => saveMCPRouterConfig('title')}
-                    disabled={loading}
-                    className="mt-1 px-4 py-2 bg-blue-600 hover:bg-blue-700 text-white rounded-md text-sm font-medium disabled:opacity-50 btn-primary"
-                  >
-                    {t('common.save')}
-                  </button>
-                </div>
-              </div>
-
               <div className="p-3 bg-gray-50 rounded-md">
                 <div className="mb-2">
                   <h3 className="font-medium text-gray-700">{t('settings.mcpRouterBaseUrl')}</h3>

frontend/src/services/promptService.ts

@@ -0,0 +1,144 @@
+import { apiPost, apiPut } from '../utils/fetchInterceptor';
+
+export interface PromptCallRequest {
+  promptName: string;
+  arguments?: Record<string, any>;
+}
+
+export interface PromptCallResult {
+  success: boolean;
+  data?: any;
+  error?: string;
+  message?: string;
+}
+
+// GetPrompt result types
+export interface GetPromptResult {
+  success: boolean;
+  data?: any;
+  error?: string;
+}
+
+/**
+ * Call a MCP prompt via the call_prompt API
+ */
+export const callPrompt = async (
+  request: PromptCallRequest,
+  server?: string,
+): Promise<PromptCallResult> => {
+  try {
+    // Construct the URL with optional server parameter
+    const url = server ? `/prompts/call/${server}` : '/prompts/call';
+    const response = await apiPost<any>(url, {
+      promptName: request.promptName,
+      arguments: request.arguments,
+    });
+
+    if (!response.success) {
+      return {
+        success: false,
+        error: response.message || 'Prompt call failed',
+      };
+    }
+
+    return {
+      success: true,
+      data: response.data,
+    };
+  } catch (error) {
+    console.error('Error calling prompt:', error);
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'Unknown error occurred',
+    };
+  }
+};
+
+export const getPrompt = async (
+  request: PromptCallRequest,
+  server?: string,
+): Promise<GetPromptResult> => {
+  try {
+    const response = await apiPost(
+      `/mcp/${server}/prompts/${encodeURIComponent(request.promptName)}`,
+      {
+        name: request.promptName,
+        arguments: request.arguments,
+      },
+    );
+    
+    // apiPost already returns parsed data, not a Response object
+    if (!response.success) {
+      throw new Error(`Failed to get prompt: ${response.message || 'Unknown error'}`);
+    }
+    
+    return {
+      success: true,
+      data: response.data,
+    };
+  } catch (error) {
+    console.error('Error getting prompt:', error);
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'Unknown error occurred',
+    };
+  }
+};
+
+/**
+ * Toggle a prompt's enabled state for a specific server
+ */
+export const togglePrompt = async (
+  serverName: string,
+  promptName: string,
+  enabled: boolean,
+): Promise<{ success: boolean; error?: string }> => {
+  try {
+    const response = await apiPost<any>(`/servers/${serverName}/prompts/${promptName}/toggle`, {
+      enabled,
+    });
+
+    return {
+      success: response.success,
+      error: response.success ? undefined : response.message,
+    };
+  } catch (error) {
+    console.error('Error toggling prompt:', error);
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'Unknown error occurred',
+    };
+  }
+};
+
+/**
+ * Update a prompt's description for a specific server
+ */
+export const updatePromptDescription = async (
+  serverName: string,
+  promptName: string,
+  description: string,
+): Promise<{ success: boolean; error?: string }> => {
+  try {
+    const response = await apiPut<any>(
+      `/servers/${serverName}/prompts/${promptName}/description`,
+      { description },
+      {
+        headers: {
+          Authorization: `Bearer ${localStorage.getItem('mcphub_token')}`,
+        },
+      },
+    );
+
+    return {
+      success: response.success,
+      error: response.success ? undefined : response.message,
+    };
+  } catch (error) {
+    console.error('Error updating prompt description:', error);
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'Unknown error occurred',
+    };
+  }
+};

frontend/src/types/index.ts

@@ -91,6 +91,20 @@ export interface Tool {
   enabled?: boolean;
 }
 
+// Prompt types
+export interface Prompt {
+  name: string;
+  title?: string;
+  description?: string;
+  arguments?: Array<{
+    name: string;
+    title?: string;
+    description?: string;
+    required?: boolean;
+  }>;
+  enabled?: boolean;
+}
+
 // Server config types
 export interface ServerConfig {
   type?: 'stdio' | 'sse' | 'streamable-http' | 'openapi';
@@ -101,6 +115,7 @@ export interface ServerConfig {
   headers?: Record<string, string>;
   enabled?: boolean;
   tools?: Record<string, { enabled: boolean; description?: string }>; // Tool-specific configurations with enable/disable state and custom descriptions
+  prompts?: Record<string, { enabled: boolean; description?: string }>; // Prompt-specific configurations with enable/disable state and custom descriptions
   options?: {
     timeout?: number; // Request timeout in milliseconds
     resetTimeoutOnProgress?: boolean; // Reset timeout on progress notifications
@@ -153,6 +168,7 @@ export interface Server {
   status: ServerStatus;
   error?: string;
   tools?: Tool[];
+  prompts?: Prompt[];
   config?: ServerConfig;
   enabled?: boolean;
 }

locales/en.json

@@ -1,6 +1,6 @@
 {
   "app": {
-    "title": "MCP Hub Dashboard",
+    "title": "MCPHub Dashboard",
     "error": "Error",
     "closeButton": "Close",
     "noServers": "No MCP servers available",
@@ -10,11 +10,11 @@
     "changePassword": "Change Password",
     "toggleSidebar": "Toggle Sidebar",
     "welcomeUser": "Welcome, {{username}}",
-    "name": "MCP Hub"
+    "name": "MCPHub"
   },
   "about": {
     "title": "About",
-    "versionInfo": "MCP Hub Version: {{version}}",
+    "versionInfo": "MCPHub Version: {{version}}",
     "newVersion": "New version available!",
     "currentVersion": "Current version",
     "newVersionAvailable": "New version {{version}} is available",
@@ -30,7 +30,7 @@
     "label": "Sponsor",
     "title": "Support the Project",
     "rewardAlt": "Reward QR Code",
-    "supportMessage": "Support the development of MCP Hub by buying me a coffee!",
+    "supportMessage": "Support the development of MCPHub by buying me a coffee!",
     "supportButton": "Support on Ko-fi"
   },
   "wechat": {
@@ -52,7 +52,9 @@
   },
   "auth": {
     "login": "Login",
-    "loginTitle": "Login to MCP Hub",
+    "loginTitle": "Login to MCPHub",
+    "slogan": "The Unified Hub for MCP Servers",
+    "subtitle": "Centralized management platform for Model Context Protocol servers. Organize, monitor, and scale multiple MCP servers with flexible routing strategies.",
     "username": "Username",
     "password": "Password",
     "loggingIn": "Logging in...",
@@ -78,6 +80,7 @@
     "deleteWarning": "Deleting server '{{name}}' will remove it and all its data. This action cannot be undone.",
     "status": "Status",
     "tools": "Tools",
+    "prompts": "Prompts",
     "name": "Server Name",
     "url": "Server URL",
     "apiKey": "API Key",
@@ -412,6 +415,23 @@
     "addItem": "Add {{key}} item",
     "enterKey": "Enter {{key}}"
   },
+  "prompt": {
+    "run": "Get",
+    "running": "Getting...",
+    "result": "Prompt Result",
+    "error": "Prompt Error",
+    "execution": "Prompt Execution",
+    "successful": "Successful",
+    "failed": "Failed",
+    "errorDetails": "Error Details:",
+    "noContent": "Prompt executed successfully but returned no content.",
+    "unknownError": "Unknown error occurred",
+    "jsonResponse": "JSON Response:",
+    "description": "Description",
+    "messages": "Messages",
+    "noDescription": "No description available",
+    "runPromptWithName": "Get Prompt: {{name}}"
+  },
   "settings": {
     "enableGlobalRoute": "Enable Global Route",
     "enableGlobalRouteDescription": "Allow connections to /sse endpoint without specifying a group ID",
@@ -454,7 +474,7 @@
     "mcpRouterApiKeyPlaceholder": "Enter MCPRouter API key",
     "mcpRouterReferer": "Referer",
     "mcpRouterRefererDescription": "Referer header for MCPRouter API requests",
-    "mcpRouterRefererPlaceholder": "https://mcphub.app",
+    "mcpRouterRefererPlaceholder": "https://www.mcphubx.com",
     "mcpRouterTitle": "Title",
     "mcpRouterTitleDescription": "Title header for MCPRouter API requests",
     "mcpRouterTitlePlaceholder": "MCPHub",
@@ -526,6 +546,7 @@
   "api": {
     "errors": {
       "readonly": "Readonly for demo environment",
+      "invalid_credentials": "Invalid username or password",
       "serverNameRequired": "Server name is required",
       "serverConfigRequired": "Server configuration is required",
       "serverConfigInvalid": "Server configuration must include either a URL, OpenAPI specification URL or schema, or command with arguments",

locales/zh.json

@@ -1,6 +1,6 @@
 {
   "app": {
-    "title": "MCP Hub 控制面板",
+    "title": "MCPHub 控制面板",
     "error": "错误",
     "closeButton": "关闭",
     "noServers": "没有可用的 MCP 服务器",
@@ -10,11 +10,11 @@
     "changePassword": "修改密码",
     "toggleSidebar": "切换侧边栏",
     "welcomeUser": "欢迎, {{username}}",
-    "name": "MCP Hub"
+    "name": "MCPHub"
   },
   "about": {
     "title": "关于",
-    "versionInfo": "MCP Hub 版本: {{version}}",
+    "versionInfo": "MCPHub 版本: {{version}}",
     "newVersion": "有新版本可用！",
     "currentVersion": "当前版本",
     "newVersionAvailable": "新版本 {{version}} 已发布",
@@ -30,7 +30,7 @@
     "label": "赞助",
     "title": "支持项目",
     "rewardAlt": "赞赏码",
-    "supportMessage": "通过捐赠支持 MCP Hub 的开发！",
+    "supportMessage": "通过捐赠支持 MCPHub 的开发！",
     "supportButton": "在 Ko-fi 上支持"
   },
   "wechat": {
@@ -52,7 +52,9 @@
   },
   "auth": {
     "login": "登录",
-    "loginTitle": "登录 MCP Hub",
+    "loginTitle": "登录 MCPHub",
+    "slogan": "统一的 MCP 服务器管理平台",
+    "subtitle": "模型上下文协议服务器的集中管理平台，通过灵活的路由策略组织、监控和扩展多个 MCP 服务器。",
     "username": "用户名",
     "password": "密码",
     "loggingIn": "登录中...",
@@ -78,6 +80,7 @@
     "deleteWarning": "删除服务器 '{{name}}' 将会移除该服务器及其所有数据。此操作无法撤销。",
     "status": "状态",
     "tools": "工具",
+    "prompts": "提示词",
     "name": "服务器名称",
     "url": "服务器 URL",
     "apiKey": "API 密钥",
@@ -413,6 +416,23 @@
     "addItem": "添加 {{key}} 项目",
     "enterKey": "输入 {{key}}"
   },
+  "prompt": {
+    "run": "获取",
+    "running": "获取中...",
+    "result": "提示词结果",
+    "error": "提示词错误",
+    "execution": "提示词执行",
+    "successful": "成功",
+    "failed": "失败",
+    "errorDetails": "错误详情：",
+    "noContent": "提示词执行成功但未返回内容。",
+    "unknownError": "发生未知错误",
+    "jsonResponse": "JSON 响应：",
+    "description": "描述",
+    "messages": "消息",
+    "noDescription": "无描述信息",
+    "runPromptWithName": "获取提示词: {{name}}"
+  },
   "settings": {
     "enableGlobalRoute": "启用全局路由",
     "enableGlobalRouteDescription": "允许不指定组 ID 就连接到 /sse 端点",
@@ -456,7 +476,7 @@
     "mcpRouterApiKeyPlaceholder": "请输入 MCPRouter API 密钥",
     "mcpRouterReferer": "引用地址",
     "mcpRouterRefererDescription": "MCPRouter API 请求的引用地址头",
-    "mcpRouterRefererPlaceholder": "https://mcphub.app",
+    "mcpRouterRefererPlaceholder": "https://www.mcphubx.com",
     "mcpRouterTitle": "标题",
     "mcpRouterTitleDescription": "MCPRouter API 请求的标题头",
     "mcpRouterTitlePlaceholder": "MCPHub",
@@ -528,6 +548,7 @@
   "api": {
     "errors": {
       "readonly": "演示环境无法修改数据",
+      "invalid_credentials": "用户名或密码错误",
       "serverNameRequired": "服务器名称是必需的",
       "serverConfigRequired": "服务器配置是必需的",
       "serverConfigInvalid": "服务器配置必须包含 URL、OpenAPI 规范 URL 或模式，或者带参数的命令",

package.json

@@ -46,81 +46,89 @@
   "license": "ISC",
   "dependencies": {
     "@apidevtools/swagger-parser": "^11.0.1",
-    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@modelcontextprotocol/sdk": "^1.17.4",
     "@types/adm-zip": "^0.5.7",
     "@types/multer": "^1.4.13",
-    "@types/pg": "^8.15.2",
+    "@types/pg": "^8.15.5",
     "adm-zip": "^0.5.16",
-    "axios": "^1.10.0",
+    "axios": "^1.11.0",
     "bcryptjs": "^3.0.2",
-    "dotenv": "^16.3.1",
+    "cors": "^2.8.5",
+    "dotenv": "^16.6.1",
     "dotenv-expand": "^12.0.2",
     "express": "^4.21.2",
     "express-validator": "^7.2.1",
     "i18next-fs-backend": "^2.6.0",
     "jsonwebtoken": "^9.0.2",
-    "multer": "^2.0.1",
-    "openai": "^4.103.0",
+    "multer": "^2.0.2",
+    "openai": "^4.104.0",
     "openapi-types": "^12.1.3",
-    "pg": "^8.16.0",
+    "pg": "^8.16.3",
     "pgvector": "^0.2.1",
     "postgres": "^3.4.7",
     "reflect-metadata": "^0.2.2",
-    "typeorm": "^0.3.24",
+    "typeorm": "^0.3.26",
     "uuid": "^11.1.0"
   },
   "devDependencies": {
-    "@radix-ui/react-accordion": "^1.2.3",
-    "@radix-ui/react-slot": "^1.1.2",
+    "@radix-ui/react-accordion": "^1.2.12",
+    "@radix-ui/react-slot": "^1.2.3",
     "@shadcn/ui": "^0.0.4",
-    "@swc/core": "^1.13.0",
+    "@swc/core": "^1.13.5",
     "@swc/jest": "^0.2.39",
     "@tailwindcss/line-clamp": "^0.4.4",
-    "@tailwindcss/postcss": "^4.1.3",
-    "@tailwindcss/vite": "^4.1.7",
+    "@tailwindcss/postcss": "^4.1.12",
+    "@tailwindcss/vite": "^4.1.12",
     "@types/bcryptjs": "^3.0.0",
-    "@types/express": "^4.17.21",
-    "@types/jest": "^29.5.5",
-    "@types/jsonwebtoken": "^9.0.9",
-    "@types/node": "^22.15.21",
-    "@types/react": "^19.0.12",
-    "@types/react-dom": "^19.0.4",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^4.17.23",
+    "@types/jest": "^29.5.14",
+    "@types/jsonwebtoken": "^9.0.10",
+    "@types/node": "^22.17.2",
+    "@types/react": "^19.1.11",
+    "@types/react-dom": "^19.1.7",
     "@types/supertest": "^6.0.3",
     "@types/uuid": "^10.0.0",
-    "@typescript-eslint/eslint-plugin": "^6.7.4",
-    "@typescript-eslint/parser": "^6.7.4",
-    "@vitejs/plugin-react": "^4.4.1",
+    "@typescript-eslint/eslint-plugin": "^6.21.0",
+    "@typescript-eslint/parser": "^6.21.0",
+    "@vitejs/plugin-react": "^4.7.0",
     "autoprefixer": "^10.4.21",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "concurrently": "^9.1.2",
-    "eslint": "^8.50.0",
+    "concurrently": "^9.2.0",
+    "eslint": "^8.57.1",
     "i18next": "^24.2.3",
-    "i18next-browser-languagedetector": "^8.0.4",
+    "i18next-browser-languagedetector": "^8.2.0",
     "jest": "^29.7.0",
-    "jest-environment-node": "^30.0.0",
+    "jest-environment-node": "^30.0.5",
     "jest-mock-extended": "4.0.0-beta1",
     "lucide-react": "^0.486.0",
-    "next": "^15.2.4",
-    "postcss": "^8.5.3",
-    "prettier": "^3.0.3",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
-    "react-i18next": "^15.4.1",
-    "react-router-dom": "^7.6.0",
-    "supertest": "^7.1.1",
-    "tailwind-merge": "^3.1.0",
+    "next": "^15.5.0",
+    "postcss": "^8.5.6",
+    "prettier": "^3.6.2",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
+    "react-i18next": "^15.7.2",
+    "react-router-dom": "^7.8.2",
+    "supertest": "^7.1.4",
+    "tailwind-merge": "^3.3.1",
     "tailwind-scrollbar-hide": "^2.0.0",
-    "tailwindcss": "^4.0.17",
-    "ts-jest": "^29.1.1",
+    "tailwindcss": "^4.1.12",
+    "ts-jest": "^29.4.1",
     "ts-node-dev": "^2.0.0",
-    "tsx": "^4.7.0",
-    "typescript": "^5.2.2",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2",
     "vite": "^6.3.5",
-    "zod": "^3.24.2"
+    "zod": "^3.25.76"
   },
   "engines": {
     "node": "^18.0.0 || >=20.0.0"
   },
-  "packageManager": "pnpm@10.12.4+sha256.cadfd9e6c9fcc2cb76fe7c0779a5250b632898aea5f53d833a73690c77a778d9"
+  "packageManager": "pnpm@10.12.4+sha256.cadfd9e6c9fcc2cb76fe7c0779a5250b632898aea5f53d833a73690c77a778d9",
+  "pnpm": {
+    "overrides": {
+      "brace-expansion@1.1.11": "1.1.12",
+      "brace-expansion@2.0.1": "2.0.2"
+    }
+  }
 }

src/config/index.ts

@@ -11,7 +11,6 @@ dotenv.config();
 const defaultConfig = {
   port: process.env.PORT || 3000,
   initTimeout: process.env.INIT_TIMEOUT || 300000,
-  timeout: process.env.REQUEST_TIMEOUT || 60000,
   basePath: process.env.BASE_PATH || '',
   readonly: 'true' === process.env.READONLY || false,
   mcpHubName: 'mcphub',

src/config/jwt.ts

@@ -0,0 +1,13 @@
+import crypto from 'crypto';
+
+let jwtSecret = process.env.JWT_SECRET;
+if (!jwtSecret) {
+  jwtSecret = crypto.randomBytes(32).toString('hex');
+  if (process.env.NODE_ENV === 'production') {
+    console.warn(
+      'Warning: JWT_SECRET is not set. Using a temporary secret. Please set a strong, persistent secret in your environment variables for production.',
+    );
+  }
+}
+
+export const JWT_SECRET = jwtSecret;

src/controllers/authController.ts

@@ -9,11 +9,10 @@ import {
 } from '../models/User.js';
 import { getDataService } from '../services/services.js';
 import { DataService } from '../services/dataService.js';
+import { JWT_SECRET } from '../config/jwt.js';
 
 const dataService: DataService = getDataService();
 
-// Default secret key - in production, use an environment variable
-const JWT_SECRET = process.env.JWT_SECRET || 'your-secret-key-change-this';
 const TOKEN_EXPIRY = '24h';
 
 // Login user

src/controllers/openApiController.ts

@@ -0,0 +1,134 @@
+import { Request, Response } from 'express';
+import { 
+  generateOpenAPISpec, 
+  getAvailableServers, 
+  getToolStats,
+  OpenAPIGenerationOptions 
+} from '../services/openApiGeneratorService.js';
+
+/**
+ * Controller for OpenAPI generation endpoints
+ * Provides OpenAPI specifications for MCP tools to enable OpenWebUI integration
+ */
+
+/**
+ * Generate and return OpenAPI specification
+ * GET /api/openapi.json
+ */
+export const getOpenAPISpec = (req: Request, res: Response): void => {
+  try {
+    const options: OpenAPIGenerationOptions = {
+      title: req.query.title as string,
+      description: req.query.description as string,
+      version: req.query.version as string,
+      serverUrl: req.query.serverUrl as string,
+      includeDisabledTools: req.query.includeDisabled === 'true',
+      groupFilter: req.query.group as string,
+      serverFilter: req.query.servers ? (req.query.servers as string).split(',') : undefined
+    };
+
+    const openApiSpec = generateOpenAPISpec(options);
+    
+    res.setHeader('Content-Type', 'application/json');
+    res.setHeader('Access-Control-Allow-Origin', '*');
+    res.setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS');
+    res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
+    
+    res.json(openApiSpec);
+  } catch (error) {
+    console.error('Error generating OpenAPI specification:', error);
+    res.status(500).json({
+      error: 'Failed to generate OpenAPI specification',
+      message: error instanceof Error ? error.message : 'Unknown error'
+    });
+  }
+};
+
+/**
+ * Get available servers for filtering
+ * GET /api/openapi/servers
+ */
+export const getOpenAPIServers = (req: Request, res: Response): void => {
+  try {
+    const servers = getAvailableServers();
+    res.json({
+      success: true,
+      data: servers
+    });
+  } catch (error) {
+    console.error('Error getting available servers:', error);
+    res.status(500).json({
+      success: false,
+      error: 'Failed to get available servers',
+      message: error instanceof Error ? error.message : 'Unknown error'
+    });
+  }
+};
+
+/**
+ * Get tool statistics
+ * GET /api/openapi/stats
+ */
+export const getOpenAPIStats = (req: Request, res: Response): void => {
+  try {
+    const stats = getToolStats();
+    res.json({
+      success: true,
+      data: stats
+    });
+  } catch (error) {
+    console.error('Error getting tool statistics:', error);
+    res.status(500).json({
+      success: false,
+      error: 'Failed to get tool statistics',
+      message: error instanceof Error ? error.message : 'Unknown error'
+    });
+  }
+};
+
+/**
+ * Execute tool via OpenAPI-compatible endpoint
+ * This allows OpenWebUI to call MCP tools directly
+ * POST /api/tools/:serverName/:toolName
+ * GET /api/tools/:serverName/:toolName (for simple tools)
+ */
+export const executeToolViaOpenAPI = async (req: Request, res: Response): Promise<void> => {
+  try {
+    const { serverName, toolName } = req.params;
+    
+    // Import handleCallToolRequest function
+    const { handleCallToolRequest } = await import('../services/mcpService.js');
+    
+    // Prepare arguments from query params (GET) or body (POST)
+    const args = req.method === 'GET' 
+      ? req.query 
+      : req.body || {};
+    
+    // Create a mock request structure that matches what handleCallToolRequest expects
+    const mockRequest = {
+      params: {
+        name: toolName, // Just use the tool name without server prefix as it gets added by handleCallToolRequest
+        arguments: args,
+      },
+    };
+    
+    const extra = {
+      sessionId: req.headers['x-session-id'] as string || 'openapi-session',
+      server: serverName,
+    };
+
+    console.log(`OpenAPI tool execution: ${serverName}/${toolName} with args:`, args);
+    
+    const result = await handleCallToolRequest(mockRequest, extra);
+    
+    // Return the result in OpenAPI format (matching MCP tool response structure)
+    res.json(result);
+    
+  } catch (error) {
+    console.error('Error executing tool via OpenAPI:', error);
+    res.status(500).json({
+      error: 'Failed to execute tool',
+      message: error instanceof Error ? error.message : 'Unknown error'
+    });
+  }
+};

src/controllers/promptController.ts

@@ -0,0 +1,45 @@
+import { Request, Response } from 'express';
+import { ApiResponse } from '../types/index.js';
+import { handleGetPromptRequest } from '../services/mcpService.js';
+
+/**
+ * Get a specific prompt by server and prompt name
+ */
+export const getPrompt = async (req: Request, res: Response): Promise<void> => {
+  try {
+    const { serverName, promptName } = req.params;
+    if (!serverName || !promptName) {
+      res.status(400).json({
+        success: false,
+        message: 'serverName and promptName are required',
+      });
+      return;
+    }
+
+    const promptArgs = {
+      params: req.body as { [key: string]: any }
+    };
+    const result = await handleGetPromptRequest(promptArgs, serverName);
+    if (result.isError) {
+      res.status(500).json({
+        success: false,
+        message: 'Failed to get prompt',
+      });
+      return;
+    }
+
+    const response: ApiResponse = {
+      success: true,
+      data: result,
+    };
+
+    res.json(response);
+  } catch (error) {
+    console.error('Error getting prompt:', error);
+    res.status(500).json({
+      success: false,
+      message: 'Failed to get prompt',
+      error: error instanceof Error ? error.message : 'Unknown error occurred',
+    });
+  }
+};

src/controllers/serverController.ts

@@ -562,7 +562,7 @@ export const updateSystemConfig = (req: Request, res: Response): void => {
         },
         mcpRouter: {
           apiKey: '',
-          referer: 'https://mcphub.app',
+          referer: 'https://www.mcphubx.com',
           title: 'MCPHub',
           baseUrl: 'https://api.mcprouter.to/v1',
         },
@@ -600,7 +600,7 @@ export const updateSystemConfig = (req: Request, res: Response): void => {
     if (!settings.systemConfig.mcpRouter) {
       settings.systemConfig.mcpRouter = {
         apiKey: '',
-        referer: 'https://mcphub.app',
+        referer: 'https://www.mcphubx.com',
         title: 'MCPHub',
         baseUrl: 'https://api.mcprouter.to/v1',
       };
@@ -739,3 +739,131 @@ export const updateSystemConfig = (req: Request, res: Response): void => {
     });
   }
 };
+
+// Toggle prompt status for a specific server
+export const togglePrompt = async (req: Request, res: Response): Promise<void> => {
+  try {
+    const { serverName, promptName } = req.params;
+    const { enabled } = req.body;
+
+    if (!serverName || !promptName) {
+      res.status(400).json({
+        success: false,
+        message: 'Server name and prompt name are required',
+      });
+      return;
+    }
+
+    if (typeof enabled !== 'boolean') {
+      res.status(400).json({
+        success: false,
+        message: 'Enabled status must be a boolean',
+      });
+      return;
+    }
+
+    const settings = loadSettings();
+    if (!settings.mcpServers[serverName]) {
+      res.status(404).json({
+        success: false,
+        message: 'Server not found',
+      });
+      return;
+    }
+
+    // Initialize prompts config if it doesn't exist
+    if (!settings.mcpServers[serverName].prompts) {
+      settings.mcpServers[serverName].prompts = {};
+    }
+
+    // Set the prompt's enabled state
+    settings.mcpServers[serverName].prompts![promptName] = { enabled };
+
+    if (!saveSettings(settings)) {
+      res.status(500).json({
+        success: false,
+        message: 'Failed to save settings',
+      });
+      return;
+    }
+
+    // Notify that tools have changed (as prompts are part of the tool listing)
+    notifyToolChanged();
+
+    res.json({
+      success: true,
+      message: `Prompt ${promptName} ${enabled ? 'enabled' : 'disabled'} successfully`,
+    });
+  } catch (error) {
+    res.status(500).json({
+      success: false,
+      message: 'Internal server error',
+    });
+  }
+};
+
+// Update prompt description for a specific server
+export const updatePromptDescription = async (req: Request, res: Response): Promise<void> => {
+  try {
+    const { serverName, promptName } = req.params;
+    const { description } = req.body;
+
+    if (!serverName || !promptName) {
+      res.status(400).json({
+        success: false,
+        message: 'Server name and prompt name are required',
+      });
+      return;
+    }
+
+    if (typeof description !== 'string') {
+      res.status(400).json({
+        success: false,
+        message: 'Description must be a string',
+      });
+      return;
+    }
+
+    const settings = loadSettings();
+    if (!settings.mcpServers[serverName]) {
+      res.status(404).json({
+        success: false,
+        message: 'Server not found',
+      });
+      return;
+    }
+
+    // Initialize prompts config if it doesn't exist
+    if (!settings.mcpServers[serverName].prompts) {
+      settings.mcpServers[serverName].prompts = {};
+    }
+
+    // Set the prompt's description
+    if (!settings.mcpServers[serverName].prompts![promptName]) {
+      settings.mcpServers[serverName].prompts![promptName] = { enabled: true };
+    }
+
+    settings.mcpServers[serverName].prompts![promptName].description = description;
+
+    if (!saveSettings(settings)) {
+      res.status(500).json({
+        success: false,
+        message: 'Failed to save settings',
+      });
+      return;
+    }
+
+    // Notify that tools have changed (as prompts are part of the tool listing)
+    notifyToolChanged();
+
+    res.json({
+      success: true,
+      message: `Prompt ${promptName} description updated successfully`,
+    });
+  } catch (error) {
+    res.status(500).json({
+      success: false,
+      message: 'Internal server error',
+    });
+  }
+};

src/middlewares/auth.ts

@@ -2,9 +2,7 @@ import { Request, Response, NextFunction } from 'express';
 import jwt from 'jsonwebtoken';
 import { loadSettings } from '../config/index.js';
 import defaultConfig from '../config/index.js';
-
-// Default secret key - in production, use an environment variable
-const JWT_SECRET = process.env.JWT_SECRET || 'your-secret-key-change-this';
+import { JWT_SECRET } from '../config/jwt.js';
 
 const validateBearerAuth = (req: Request, routingConfig: any): boolean => {
   if (!routingConfig.enableBearerAuth) {

src/middlewares/index.ts

@@ -2,7 +2,6 @@ import express, { Request, Response, NextFunction } from 'express';
 import { auth } from './auth.js';
 import { userContextMiddleware } from './userContext.js';
 import { i18nMiddleware } from './i18n.js';
-import { initializeDefaultUser } from '../models/User.js';
 import config from '../config/index.js';
 
 export const errorHandler = (
@@ -46,11 +45,6 @@ export const initMiddlewares = (app: express.Application): void => {
     }
   });
 
-  // Initialize default admin user if no users exist
-  initializeDefaultUser().catch((err) => {
-    console.error('Error initializing default user:', err);
-  });
-
   // Protect API routes with authentication middleware, but exclude auth endpoints
   app.use(`${config.basePath}/api`, (req, res, next) => {
     // Skip authentication for login endpoint

src/routes/index.ts

@@ -10,6 +10,8 @@ import {
   toggleServer,
   toggleTool,
   updateToolDescription,
+  togglePrompt,
+  updatePromptDescription,
   updateSystemConfig,
 } from '../controllers/serverController.js';
 import {
@@ -58,8 +60,15 @@ import { login, register, getCurrentUser, changePassword } from '../controllers/
 import { getAllLogs, clearLogs, streamLogs } from '../controllers/logController.js';
 import { getRuntimeConfig, getPublicConfig } from '../controllers/configController.js';
 import { callTool } from '../controllers/toolController.js';
+import { getPrompt } from '../controllers/promptController.js';
 import { uploadDxtFile, uploadMiddleware } from '../controllers/dxtController.js';
 import { healthCheck } from '../controllers/healthController.js';
+import {
+  getOpenAPISpec,
+  getOpenAPIServers,
+  getOpenAPIStats,
+  executeToolViaOpenAPI,
+} from '../controllers/openApiController.js';
 import { auth } from '../middlewares/auth.js';
 
 const router = express.Router();
@@ -77,6 +86,8 @@ export const initRoutes = (app: express.Application): void => {
   router.post('/servers/:name/toggle', toggleServer);
   router.post('/servers/:serverName/tools/:toolName/toggle', toggleTool);
   router.put('/servers/:serverName/tools/:toolName/description', updateToolDescription);
+  router.post('/servers/:serverName/prompts/:promptName/toggle', togglePrompt);
+  router.put('/servers/:serverName/prompts/:promptName/description', updatePromptDescription);
   router.put('/system-config', updateSystemConfig);
 
   // Group management routes
@@ -106,6 +117,9 @@ export const initRoutes = (app: express.Application): void => {
   // Tool management routes
   router.post('/tools/call/:server', callTool);
 
+  // Prompt management routes
+  router.post('/mcp/:serverName/prompts/:promptName', getPrompt);
+
   // DXT upload routes
   router.post('/dxt/upload', uploadMiddleware, uploadDxtFile);
 
@@ -172,6 +186,15 @@ export const initRoutes = (app: express.Application): void => {
   // Public configuration endpoint (no auth required to check skipAuth setting)
   app.get(`${config.basePath}/public-config`, getPublicConfig);
 
+  // OpenAPI generation endpoints (no auth required for OpenWebUI integration)
+  app.get(`${config.basePath}/api/openapi.json`, getOpenAPISpec);
+  app.get(`${config.basePath}/api/openapi/servers`, getOpenAPIServers);
+  app.get(`${config.basePath}/api/openapi/stats`, getOpenAPIStats);
+
+  // OpenAPI-compatible tool execution endpoints (no auth required for OpenWebUI integration)
+  app.get(`${config.basePath}/api/tools/:serverName/:toolName`, executeToolViaOpenAPI);
+  app.post(`${config.basePath}/api/tools/:serverName/:toolName`, executeToolViaOpenAPI);
+
   app.use(`${config.basePath}/api`, router);
 };
 

src/server.ts

@@ -1,4 +1,5 @@
 import express from 'express';
+import cors from 'cors';
 import config from './config/index.js';
 import path from 'path';
 import fs from 'fs';
@@ -26,6 +27,7 @@ export class AppServer {
 
   constructor() {
     this.app = express();
+    this.app.use(cors());
     this.port = config.port;
     this.basePath = config.basePath;
   }

src/services/cloudService.ts

@@ -19,7 +19,7 @@ const getMCPRouterConfig = () => {
 
   return {
     apiKey: mcpRouterConfig?.apiKey || process.env.MCPROUTER_API_KEY || '',
-    referer: mcpRouterConfig?.referer || process.env.MCPROUTER_REFERER || 'https://mcphub.app',
+    referer: mcpRouterConfig?.referer || process.env.MCPROUTER_REFERER || 'https://www.mcphubx.com',
     title: mcpRouterConfig?.title || process.env.MCPROUTER_TITLE || 'MCPHub',
     baseUrl:
       mcpRouterConfig?.baseUrl || process.env.MCPROUTER_API_BASE || DEFAULT_MCPROUTER_API_BASE,
@@ -33,7 +33,7 @@ const getAxiosConfig = (): AxiosRequestConfig => {
   return {
     headers: {
       Authorization: mcpRouterConfig.apiKey ? `Bearer ${mcpRouterConfig.apiKey}` : '',
-      'HTTP-Referer': mcpRouterConfig.referer || 'https://mcphub.app',
+      'HTTP-Referer': mcpRouterConfig.referer || 'https://www.mcphubx.com',
       'X-Title': mcpRouterConfig.title || 'MCPHub',
       'Content-Type': 'application/json',
     },

src/services/mcpService.ts

@@ -1,10 +1,16 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  ListPromptsRequestSchema,
+  GetPromptRequestSchema,
+  ServerCapabilities,
+} from '@modelcontextprotocol/sdk/types.js';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
 import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
 import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
-import { ServerInfo, ServerConfig, ToolInfo } from '../types/index.js';
+import { ServerInfo, ServerConfig, Tool } from '../types/index.js';
 import { loadSettings, saveSettings, expandEnvVars, replaceEnvVars } from '../config/index.js';
 import config from '../config/index.js';
 import { getGroup } from './sseService.js';
@@ -343,6 +349,7 @@ export const initializeClientsFromSettings = async (
         status: 'disconnected',
         error: null,
         tools: [],
+        prompts: [],
         createTime: Date.now(),
         enabled: false,
       });
@@ -376,6 +383,7 @@ export const initializeClientsFromSettings = async (
           status: 'disconnected',
           error: 'Missing OpenAPI specification URL or schema',
           tools: [],
+          prompts: [],
           createTime: Date.now(),
         });
         continue;
@@ -388,6 +396,7 @@ export const initializeClientsFromSettings = async (
         status: 'connecting',
         error: null,
         tools: [],
+        prompts: [],
         createTime: Date.now(),
         enabled: conf.enabled === undefined ? true : conf.enabled,
       };
@@ -404,7 +413,7 @@ export const initializeClientsFromSettings = async (
 
         // Convert OpenAPI tools to MCP tool format
         const openApiTools = openApiClient.getTools();
-        const mcpTools: ToolInfo[] = openApiTools.map((tool) => ({
+        const mcpTools: Tool[] = openApiTools.map((tool) => ({
           name: `${name}-${tool.name}`,
           description: tool.description,
           inputSchema: cleanInputSchema(tool.inputSchema),
@@ -469,6 +478,7 @@ export const initializeClientsFromSettings = async (
       status: 'connecting',
       error: null,
       tools: [],
+      prompts: [],
       client,
       transport,
       options: requestOptions,
@@ -480,32 +490,63 @@ export const initializeClientsFromSettings = async (
       .connect(transport, initRequestOptions || requestOptions)
       .then(() => {
         console.log(`Successfully connected client for server: ${name}`);
-        client
-          .listTools({}, initRequestOptions || requestOptions)
-          .then((tools) => {
-            console.log(`Successfully listed ${tools.tools.length} tools for server: ${name}`);
+        const capabilities: ServerCapabilities | undefined = client.getServerCapabilities();
+        console.log(`Server capabilities: ${JSON.stringify(capabilities)}`);
 
-            serverInfo.tools = tools.tools.map((tool) => ({
-              name: `${name}-${tool.name}`,
-              description: tool.description || '',
-              inputSchema: cleanInputSchema(tool.inputSchema || {}),
-            }));
-            serverInfo.status = 'connected';
-            serverInfo.error = null;
+        let dataError: Error | null = null;
+        if (capabilities?.tools) {
+          client
+            .listTools({}, initRequestOptions || requestOptions)
+            .then((tools) => {
+              console.log(`Successfully listed ${tools.tools.length} tools for server: ${name}`);
+              serverInfo.tools = tools.tools.map((tool) => ({
+                name: `${name}-${tool.name}`,
+                description: tool.description || '',
+                inputSchema: cleanInputSchema(tool.inputSchema || {}),
+              }));
+              // Save tools as vector embeddings for search
+              saveToolsAsVectorEmbeddings(name, serverInfo.tools);
+            })
+            .catch((error) => {
+              console.error(
+                `Failed to list tools for server ${name} by error: ${error} with stack: ${error.stack}`,
+              );
+              dataError = error;
+            });
+        }
 
-            // Set up keep-alive ping for SSE connections
-            setupKeepAlive(serverInfo, conf);
+        if (capabilities?.prompts) {
+          client
+            .listPrompts({}, initRequestOptions || requestOptions)
+            .then((prompts) => {
+              console.log(
+                `Successfully listed ${prompts.prompts.length} prompts for server: ${name}`,
+              );
+              serverInfo.prompts = prompts.prompts.map((prompt) => ({
+                name: `${name}-${prompt.name}`,
+                title: prompt.title,
+                description: prompt.description,
+                arguments: prompt.arguments,
+              }));
+            })
+            .catch((error) => {
+              console.error(
+                `Failed to list prompts for server ${name} by error: ${error} with stack: ${error.stack}`,
+              );
+              dataError = error;
+            });
+        }
 
-            // Save tools as vector embeddings for search
-            saveToolsAsVectorEmbeddings(name, serverInfo.tools);
-          })
-          .catch((error) => {
-            console.error(
-              `Failed to list tools for server ${name} by error: ${error} with stack: ${error.stack}`,
-            );
-            serverInfo.status = 'disconnected';
-            serverInfo.error = `Failed to list tools: ${error.stack} `;
-          });
+        if (!dataError) {
+          serverInfo.status = 'connected';
+          serverInfo.error = null;
+
+          // Set up keep-alive ping for SSE connections
+          setupKeepAlive(serverInfo, conf);
+        } else {
+          serverInfo.status = 'disconnected';
+          serverInfo.error = `Failed to list data: ${dataError} `;
+        }
       })
       .catch((error) => {
         console.error(
@@ -532,7 +573,7 @@ export const getServersInfo = (): Omit<ServerInfo, 'client' | 'transport'>[] =>
   const filterServerInfos: ServerInfo[] = dataService.filterData
     ? dataService.filterData(serverInfos)
     : serverInfos;
-  const infos = filterServerInfos.map(({ name, status, tools, createTime, error }) => {
+  const infos = filterServerInfos.map(({ name, status, tools, prompts, createTime, error }) => {
     const serverConfig = settings.mcpServers[name];
     const enabled = serverConfig ? serverConfig.enabled !== false : true;
 
@@ -546,11 +587,21 @@ export const getServersInfo = (): Omit<ServerInfo, 'client' | 'transport'>[] =>
       };
     });
 
+    const promptsWithEnabled = prompts.map((prompt) => {
+      const promptConfig = serverConfig?.prompts?.[prompt.name];
+      return {
+        ...prompt,
+        description: promptConfig?.description || prompt.description, // Use custom description if available
+        enabled: promptConfig?.enabled !== false, // Default to true if not explicitly disabled
+      };
+    });
+
     return {
       name,
       status,
       error,
       tools: toolsWithEnabled,
+      prompts: promptsWithEnabled,
       createTime,
       enabled,
     };
@@ -568,7 +619,7 @@ const getServerByName = (name: string): ServerInfo | undefined => {
 };
 
 // Filter tools by server configuration
-const filterToolsByConfig = (serverName: string, tools: ToolInfo[]): ToolInfo[] => {
+const filterToolsByConfig = (serverName: string, tools: Tool[]): Tool[] => {
   const settings = loadSettings();
   const serverConfig = settings.mcpServers[serverName];
 
@@ -634,32 +685,6 @@ export const removeServer = (name: string): { success: boolean; message?: string
   }
 };
 
-// Update existing server
-export const updateMcpServer = async (
-  name: string,
-  config: ServerConfig,
-): Promise<{ success: boolean; message?: string }> => {
-  try {
-    const settings = loadSettings();
-    if (!settings.mcpServers[name]) {
-      return { success: false, message: 'Server not found' };
-    }
-
-    settings.mcpServers[name] = config;
-    if (!saveSettings(settings)) {
-      return { success: false, message: 'Failed to save settings' };
-    }
-
-    closeServer(name);
-
-    serverInfos = serverInfos.filter((serverInfo) => serverInfo.name !== name);
-    return { success: true, message: 'Server updated successfully' };
-  } catch (error) {
-    console.error(`Failed to update server: ${name}`, error);
-    return { success: false, message: 'Failed to update server' };
-  }
-};
-
 // Add or update server (supports overriding existing servers for DXT)
 export const addOrUpdateServer = async (
   name: string,
@@ -948,7 +973,7 @@ export const handleCallToolRequest = async (request: any, extra: any) => {
           if (tool.name) {
             const serverName = searchResults.find((r) => r.toolName === tool.name)?.serverName;
             if (serverName) {
-              const enabledTools = filterToolsByConfig(serverName, [tool as ToolInfo]);
+              const enabledTools = filterToolsByConfig(serverName, [tool as Tool]);
               return enabledTools.length > 0;
             }
           }
@@ -1139,6 +1164,119 @@ export const handleCallToolRequest = async (request: any, extra: any) => {
   }
 };
 
+export const handleGetPromptRequest = async (request: any, extra: any) => {
+  try {
+    const { name, arguments: promptArgs } = request.params;
+    let server: ServerInfo | undefined;
+    if (extra && extra.server) {
+      server = getServerByName(extra.server);
+    } else {
+      // Find the first server that has this tool
+      server = serverInfos.find(
+        (serverInfo) =>
+          serverInfo.status === 'connected' &&
+          serverInfo.enabled !== false &&
+          serverInfo.prompts.find((prompt) => prompt.name === name),
+      );
+    }
+    if (!server) {
+      throw new Error(`Server not found: ${name}`);
+    }
+
+    // Remove server prefix from prompt name if present
+    const cleanPromptName = name.startsWith(`${server.name}-`)
+      ? name.replace(`${server.name}-`, '')
+      : name;
+
+    const promptParams = {
+      name: cleanPromptName || '',
+      arguments: promptArgs,
+    };
+    // Log the final promptParams
+    console.log(`Calling getPrompt with params: ${JSON.stringify(promptParams)}`);
+    const prompt = await server.client?.getPrompt(promptParams);
+    console.log(`Received prompt: ${JSON.stringify(prompt)}`);
+    if (!prompt) {
+      throw new Error(`Prompt not found: ${cleanPromptName}`);
+    }
+
+    return prompt;
+  } catch (error) {
+    console.error(`Error handling GetPromptRequest: ${error}`);
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `Error: ${error}`,
+        },
+      ],
+      isError: true,
+    };
+  }
+};
+
+export const handleListPromptsRequest = async (_: any, extra: any) => {
+  const sessionId = extra.sessionId || '';
+  const group = getGroup(sessionId);
+  console.log(`Handling ListPromptsRequest for group: ${group}`);
+
+  const allServerInfos = getDataService()
+    .filterData(serverInfos)
+    .filter((serverInfo) => {
+      if (serverInfo.enabled === false) return false;
+      if (!group) return true;
+      const serversInGroup = getServersInGroup(group);
+      if (!serversInGroup || serversInGroup.length === 0) return serverInfo.name === group;
+      return serversInGroup.includes(serverInfo.name);
+    });
+
+  const allPrompts: any[] = [];
+  for (const serverInfo of allServerInfos) {
+    if (serverInfo.prompts && serverInfo.prompts.length > 0) {
+      // Filter prompts based on server configuration
+      const settings = loadSettings();
+      const serverConfig = settings.mcpServers[serverInfo.name];
+
+      let enabledPrompts = serverInfo.prompts;
+      if (serverConfig && serverConfig.prompts) {
+        enabledPrompts = serverInfo.prompts.filter((prompt: any) => {
+          const promptConfig = serverConfig.prompts?.[prompt.name];
+          // If prompt is not in config, it's enabled by default
+          return promptConfig?.enabled !== false;
+        });
+      }
+
+      // If this is a group request, apply group-level prompt filtering
+      if (group) {
+        const serverConfigInGroup = getServerConfigInGroup(group, serverInfo.name);
+        if (
+          serverConfigInGroup &&
+          serverConfigInGroup.tools !== 'all' &&
+          Array.isArray(serverConfigInGroup.tools)
+        ) {
+          // Note: Group config uses 'tools' field but we're filtering prompts here
+          // This might be a design decision to control access at the server level
+        }
+      }
+
+      // Apply custom descriptions from server configuration
+      const promptsWithCustomDescriptions = enabledPrompts.map((prompt: any) => {
+        const promptConfig = serverConfig?.prompts?.[prompt.name];
+        return {
+          ...prompt,
+          description: promptConfig?.description || prompt.description, // Use custom description if available
+        };
+      });
+
+      allPrompts.push(...promptsWithCustomDescriptions);
+    }
+  }
+
+  return {
+    prompts: allPrompts,
+  };
+};
+
 // Create McpServer instance
 export const createMcpServer = (name: string, version: string, group?: string): Server => {
   // Determine server name based on routing type
@@ -1157,8 +1295,13 @@ export const createMcpServer = (name: string, version: string, group?: string):
   }
   // If no group, use default name (global routing)
 
-  const server = new Server({ name: serverName, version }, { capabilities: { tools: {} } });
+  const server = new Server(
+    { name: serverName, version },
+    { capabilities: { tools: {}, prompts: {}, resources: {} } },
+  );
   server.setRequestHandler(ListToolsRequestSchema, handleListToolsRequest);
   server.setRequestHandler(CallToolRequestSchema, handleCallToolRequest);
+  server.setRequestHandler(GetPromptRequestSchema, handleGetPromptRequest);
+  server.setRequestHandler(ListPromptsRequestSchema, handleListPromptsRequest);
   return server;
 };

src/services/openApiGeneratorService.ts

@@ -0,0 +1,316 @@
+import { OpenAPIV3 } from 'openapi-types';
+import { Tool } from '../types/index.js';
+import { getServersInfo } from './mcpService.js';
+import config from '../config/index.js';
+import { loadSettings } from '../config/index.js';
+
+/**
+ * Service for generating OpenAPI 3.x specifications from MCP tools
+ * This enables integration with OpenWebUI and other OpenAPI-compatible systems
+ */
+
+export interface OpenAPIGenerationOptions {
+  title?: string;
+  description?: string;
+  version?: string;
+  serverUrl?: string;
+  includeDisabledTools?: boolean;
+  groupFilter?: string;
+  serverFilter?: string[];
+}
+
+/**
+ * Convert MCP tool input schema to OpenAPI parameter or request body schema
+ */
+function convertToolSchemaToOpenAPI(tool: Tool): {
+  parameters?: OpenAPIV3.ParameterObject[];
+  requestBody?: OpenAPIV3.RequestBodyObject;
+} {
+  const schema = tool.inputSchema as any;
+
+  if (!schema || typeof schema !== 'object') {
+    return {};
+  }
+
+  // If schema has properties, convert them to parameters or request body
+  if (schema.properties && typeof schema.properties === 'object') {
+    const properties = schema.properties;
+    const required = Array.isArray(schema.required) ? schema.required : [];
+
+    // For simple tools with only primitive parameters, use query parameters
+    const hasComplexTypes = Object.values(properties).some(
+      (prop: any) =>
+        prop.type === 'object' ||
+        prop.type === 'array' ||
+        (prop.type === 'string' && prop.enum && prop.enum.length > 10),
+    );
+
+    if (!hasComplexTypes && Object.keys(properties).length <= 10) {
+      // Use query parameters for simple tools
+      const parameters: OpenAPIV3.ParameterObject[] = Object.entries(properties).map(
+        ([name, prop]: [string, any]) => ({
+          name,
+          in: 'query',
+          required: required.includes(name),
+          description: prop.description || `Parameter ${name}`,
+          schema: {
+            type: prop.type || 'string',
+            ...(prop.enum && { enum: prop.enum }),
+            ...(prop.default !== undefined && { default: prop.default }),
+            ...(prop.format && { format: prop.format }),
+          },
+        }),
+      );
+
+      return { parameters };
+    } else {
+      // Use request body for complex tools
+      const requestBody: OpenAPIV3.RequestBodyObject = {
+        required: required.length > 0,
+        content: {
+          'application/json': {
+            schema: {
+              type: 'object',
+              properties,
+              ...(required.length > 0 && { required }),
+            },
+          },
+        },
+      };
+
+      return { requestBody };
+    }
+  }
+
+  return {};
+}
+
+/**
+ * Generate OpenAPI operation from MCP tool
+ */
+function generateOperationFromTool(tool: Tool, serverName: string): OpenAPIV3.OperationObject {
+  const { parameters, requestBody } = convertToolSchemaToOpenAPI(tool);
+  const operation: OpenAPIV3.OperationObject = {
+    summary: tool.description || `Execute ${tool.name} tool`,
+    description: tool.description || `Execute the ${tool.name} tool from ${serverName} server`,
+    operationId: `${serverName}_${tool.name}`,
+    tags: [serverName],
+    ...(parameters && parameters.length > 0 && { parameters }),
+    ...(requestBody && { requestBody }),
+    responses: {
+      '200': {
+        description: 'Successful tool execution',
+        content: {
+          'application/json': {
+            schema: {
+              type: 'object',
+              properties: {
+                content: {
+                  type: 'array',
+                  items: {
+                    type: 'object',
+                    properties: {
+                      type: { type: 'string' },
+                      text: { type: 'string' },
+                    },
+                  },
+                },
+                isError: { type: 'boolean' },
+              },
+            },
+          },
+        },
+      },
+      '400': {
+        description: 'Bad request - invalid parameters',
+        content: {
+          'application/json': {
+            schema: {
+              type: 'object',
+              properties: {
+                error: { type: 'string' },
+                message: { type: 'string' },
+              },
+            },
+          },
+        },
+      },
+      '500': {
+        description: 'Internal server error',
+        content: {
+          'application/json': {
+            schema: {
+              type: 'object',
+              properties: {
+                error: { type: 'string' },
+                message: { type: 'string' },
+              },
+            },
+          },
+        },
+      },
+    },
+  };
+
+  return operation;
+}
+
+/**
+ * Generate OpenAPI specification from MCP tools
+ */
+export function generateOpenAPISpec(options: OpenAPIGenerationOptions = {}): OpenAPIV3.Document {
+  const serverInfos = getServersInfo();
+
+  // Filter servers based on options
+  const filteredServers = serverInfos.filter(
+    (server) =>
+      server.status === 'connected' &&
+      (!options.serverFilter || options.serverFilter.includes(server.name)),
+  );
+
+  // Collect all tools from filtered servers
+  const allTools: Array<{ tool: Tool; serverName: string }> = [];
+
+  for (const serverInfo of filteredServers) {
+    const tools = options.includeDisabledTools
+      ? serverInfo.tools
+      : serverInfo.tools.filter((tool) => tool.enabled !== false);
+
+    for (const tool of tools) {
+      allTools.push({ tool, serverName: serverInfo.name });
+    }
+  }
+
+  // Generate paths from tools
+  const paths: OpenAPIV3.PathsObject = {};
+
+  for (const { tool, serverName } of allTools) {
+    const operation = generateOperationFromTool(tool, serverName);
+    const { requestBody } = convertToolSchemaToOpenAPI(tool);
+
+    // Create path for the tool
+    const pathName = `/tools/${serverName}/${tool.name}`;
+    const method = requestBody ? 'post' : 'get';
+
+    if (!paths[pathName]) {
+      paths[pathName] = {};
+    }
+
+    paths[pathName][method] = operation;
+  }
+
+  const settings = loadSettings();
+  // Get server URL
+  const baseUrl =
+    options.serverUrl ||
+    settings.systemConfig?.install?.baseUrl ||
+    `http://localhost:${config.port}`;
+  const serverUrl = `${baseUrl}${config.basePath}/api`;
+
+  // Generate OpenAPI document
+  const openApiDoc: OpenAPIV3.Document = {
+    openapi: '3.0.3',
+    info: {
+      title: options.title || 'MCPHub API',
+      description:
+        options.description ||
+        'OpenAPI specification for MCP tools managed by MCPHub. This enables integration with OpenWebUI and other OpenAPI-compatible systems.',
+      version: options.version || '1.0.0',
+      contact: {
+        name: 'MCPHub',
+        url: 'https://github.com/samanhappy/mcphub',
+      },
+      license: {
+        name: 'ISC',
+        url: 'https://github.com/samanhappy/mcphub/blob/main/LICENSE',
+      },
+    },
+    servers: [
+      {
+        url: serverUrl,
+        description: 'MCPHub API Server',
+      },
+    ],
+    paths,
+    components: {
+      schemas: {
+        ToolResponse: {
+          type: 'object',
+          properties: {
+            content: {
+              type: 'array',
+              items: {
+                type: 'object',
+                properties: {
+                  type: { type: 'string' },
+                  text: { type: 'string' },
+                },
+              },
+            },
+            isError: { type: 'boolean' },
+          },
+        },
+        ErrorResponse: {
+          type: 'object',
+          properties: {
+            error: { type: 'string' },
+            message: { type: 'string' },
+          },
+        },
+      },
+      securitySchemes: {
+        bearerAuth: {
+          type: 'http',
+          scheme: 'bearer',
+          bearerFormat: 'JWT',
+        },
+      },
+    },
+    security: [
+      {
+        bearerAuth: [],
+      },
+    ],
+    tags: filteredServers.map((server) => ({
+      name: server.name,
+      description: `Tools from ${server.name} server`,
+    })),
+  };
+
+  return openApiDoc;
+}
+
+/**
+ * Get available server names for filtering
+ */
+export function getAvailableServers(): string[] {
+  const serverInfos = getServersInfo();
+  return serverInfos.filter((server) => server.status === 'connected').map((server) => server.name);
+}
+
+/**
+ * Get statistics about available tools
+ */
+export function getToolStats(): {
+  totalServers: number;
+  totalTools: number;
+  serverBreakdown: Array<{ name: string; toolCount: number; status: string }>;
+} {
+  const serverInfos = getServersInfo();
+
+  const serverBreakdown = serverInfos.map((server) => ({
+    name: server.name,
+    toolCount: server.tools.length,
+    status: server.status,
+  }));
+
+  const totalTools = serverInfos
+    .filter((server) => server.status === 'connected')
+    .reduce((sum, server) => sum + server.tools.length, 0);
+
+  return {
+    totalServers: serverInfos.filter((server) => server.status === 'connected').length,
+    totalTools,
+    serverBreakdown,
+  };
+}

src/services/vectorSearchService.ts

@@ -1,6 +1,6 @@
 import { getRepositoryFactory } from '../db/index.js';
 import { VectorEmbeddingRepository } from '../db/repositories/index.js';
-import { ToolInfo } from '../types/index.js';
+import { Tool } from '../types/index.js';
 import { getAppDataSource, initializeDatabase } from '../db/connection.js';
 import { getSmartRoutingConfig } from '../utils/smartRouting.js';
 import OpenAI from 'openai';
@@ -190,7 +190,7 @@ function generateFallbackEmbedding(text: string): number[] {
  */
 export const saveToolsAsVectorEmbeddings = async (
   serverName: string,
-  tools: ToolInfo[],
+  tools: Tool[],
 ): Promise<void> => {
   try {
     if (tools.length === 0) {

src/types/index.ts

@@ -178,6 +178,7 @@ export interface ServerConfig {
   owner?: string; // Owner of the server, defaults to 'admin' user
   keepAliveInterval?: number; // Keep-alive ping interval in milliseconds (default: 60000ms for SSE servers)
   tools?: Record<string, { enabled: boolean; description?: string }>; // Tool-specific configurations with enable/disable state and custom descriptions
+  prompts?: Record<string, { enabled: boolean; description?: string }>; // Prompt-specific configurations with enable/disable state and custom descriptions
   options?: Partial<Pick<RequestOptions, 'timeout' | 'resetTimeoutOnProgress' | 'maxTotalTimeout'>>; // MCP request options configuration
   // OpenAPI specific configuration
   openapi?: {
@@ -226,7 +227,8 @@ export interface ServerInfo {
   owner?: string; // Owner of the server, defaults to 'admin' user
   status: 'connected' | 'connecting' | 'disconnected'; // Current connection status
   error: string | null; // Error message if any
-  tools: ToolInfo[]; // List of tools available on the server
+  tools: Tool[]; // List of tools available on the server
+  prompts: Prompt[]; // List of prompts available on the server
   client?: Client; // Client instance for communication (MCP clients)
   transport?: SSEClientTransport | StdioClientTransport | StreamableHTTPClientTransport; // Transport mechanism used
   openApiClient?: any; // OpenAPI client instance for openapi type servers
@@ -237,13 +239,27 @@ export interface ServerInfo {
 }
 
 // Details about a tool available on the server
-export interface ToolInfo {
+export interface Tool {
   name: string; // Name of the tool
   description: string; // Brief description of the tool
   inputSchema: Record<string, unknown>; // Input schema for the tool
   enabled?: boolean; // Whether the tool is enabled (optional, defaults to true)
 }
 
+export interface Prompt {
+  name: string; // Name of the prompt
+  title?: string; // Title of the prompt
+  description?: string; // Brief description of the prompt
+  arguments?: PromptArgument[]; // Input schema for the prompt
+}
+
+export interface PromptArgument {
+  name: string; // Name of the argument
+  title?: string; // Title of the argument
+  description?: string; // Brief description of the argument
+  required?: boolean; // Whether the argument is required
+}
+
 // Standardized API response structure
 export interface ApiResponse<T = unknown> {
   success: boolean; // Indicates if the operation was successful

tests/services/openApiGeneratorService.test.ts

@@ -0,0 +1,69 @@
+import { generateOpenAPISpec, getToolStats } from '../../src/services/openApiGeneratorService';
+
+describe('OpenAPI Generator Service', () => {
+  describe('generateOpenAPISpec', () => {
+    it('should generate a valid OpenAPI specification', () => {
+      const spec = generateOpenAPISpec();
+      
+      // Check basic structure
+      expect(spec).toHaveProperty('openapi');
+      expect(spec).toHaveProperty('info');
+      expect(spec).toHaveProperty('servers');
+      expect(spec).toHaveProperty('paths');
+      expect(spec).toHaveProperty('components');
+      
+      // Check OpenAPI version
+      expect(spec.openapi).toBe('3.0.3');
+      
+      // Check info section
+      expect(spec.info).toHaveProperty('title');
+      expect(spec.info).toHaveProperty('description');
+      expect(spec.info).toHaveProperty('version');
+      
+      // Check components
+      expect(spec.components).toHaveProperty('schemas');
+      expect(spec.components).toHaveProperty('securitySchemes');
+      
+      // Check security schemes
+      expect(spec.components?.securitySchemes).toHaveProperty('bearerAuth');
+    });
+
+    it('should generate spec with custom options', () => {
+      const options = {
+        title: 'Custom API',
+        description: 'Custom description',
+        version: '2.0.0',
+        serverUrl: 'https://custom.example.com'
+      };
+      
+      const spec = generateOpenAPISpec(options);
+      
+      expect(spec.info.title).toBe('Custom API');
+      expect(spec.info.description).toBe('Custom description');
+      expect(spec.info.version).toBe('2.0.0');
+      expect(spec.servers[0].url).toContain('https://custom.example.com');
+    });
+    
+    it('should handle empty server list gracefully', () => {
+      const spec = generateOpenAPISpec();
+      
+      // Should not throw and should have valid structure
+      expect(spec).toHaveProperty('paths');
+      expect(typeof spec.paths).toBe('object');
+    });
+  });
+
+  describe('getToolStats', () => {
+    it('should return valid tool statistics', () => {
+      const stats = getToolStats();
+      
+      expect(stats).toHaveProperty('totalServers');
+      expect(stats).toHaveProperty('totalTools');
+      expect(stats).toHaveProperty('serverBreakdown');
+      
+      expect(typeof stats.totalServers).toBe('number');
+      expect(typeof stats.totalTools).toBe('number');
+      expect(Array.isArray(stats.serverBreakdown)).toBe(true);
+    });
+  });
+});