@samanhappy/mcphub 1.0.35 → 1.0.37

package/README.fr.md

@@ -1,6 +1,13 @@
 # MCPHub
 
-> Une passerelle MCP et plateforme de gestion auto-hébergées pour connecter, gérer et exploiter des serveurs MCP.
+> Une passerelle et un plan de contrôle MCP open source et auto-hébergés pour connecter, contrôler et exploiter des serveurs MCP.
+
+[![CI](https://github.com/samanhappy/mcphub/actions/workflows/ci.yml/badge.svg)](https://github.com/samanhappy/mcphub/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@samanhappy/mcphub)](https://www.npmjs.com/package/@samanhappy/mcphub)
+[![Docker pulls](https://img.shields.io/docker/pulls/samanhappy/mcphub)](https://hub.docker.com/r/samanhappy/mcphub)
+[![License](https://img.shields.io/github/license/samanhappy/mcphub)](LICENSE)
+[![Discord](https://img.shields.io/badge/discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/2BJehJZVH5)
+[![GitHub stars](https://img.shields.io/github/stars/samanhappy/mcphub?style=social)](https://github.com/samanhappy/mcphub/stargazers)
 
 [English](README.md) | Français | [中文版](README.zh.md)
 
@@ -10,32 +17,59 @@ MCPHub offre une manière unifiée de connecter et de gérer plusieurs serveurs
 
 ## 🌐 Démo en direct et Documentation
 
+- **Site web** : [mcphub.app](https://www.mcphub.app/)
 - **Documentation** : [docs.mcphub.app](https://docs.mcphub.app/)
 - **Environnement de démo** : [demo.mcphub.app](https://demo.mcphub.app/)
 
 ## 🚀 Fonctionnalités
 
+### Connecter une fois, exposer partout
+
+- **Routage intelligent** ⭐ - Découverte d'outils propulsée par IA utilisant la recherche sémantique vectorielle ([En savoir plus](https://docs.mcphub.app/features/smart-routing))
 - **Passerelle MCP unifiée** - Exposez tous les serveurs connectés via des points de terminaison MCP stables, avec des routes pour les groupes et les serveurs individuels
-- **Gestion des serveurs et des groupes** - Organisez les serveurs en groupes, gérez leur visibilité et contrôlez l'exposition des Tools, Prompts et Resources
+- **Alias et routage des serveurs** - Définissez des alias et routez les clients vers tous les serveurs, des groupes, un serveur individuel ou le routage intelligent
 - **Prise en charge SSE / Streamable HTTP / stdio** - Connectez des serveurs MCP locaux et distants via les transports pris en charge
+- **Configuration à chaud** - Ajoutez, supprimez ou mettez à jour les serveurs sans temps d'arrêt
+
+### Contrôler les accès et les identifiants
+
+- **Identifiants personnels** ⭐ - Associez une clé par utilisateur à un serveur partagé, avec stockage chiffré et processus stdio isolés ([En savoir plus](docs/features/per-user-credentials.mdx))
 - **Authentification et contrôle d'accès** - Utilisez OAuth 2.0, des bearer keys et la visibilité des serveurs ou groupes pour gérer les accès
-- **Alias et routage des serveurs** - Définissez des alias et routez les clients vers tous les serveurs, des groupes, un serveur individuel ou le routage intelligent
+- **Support OAuth 2.0** ⭐ - Modes client et serveur pour une authentification sécurisée ([En savoir plus](https://docs.mcphub.app/features/oauth))
+- **Connexion sociale** - Support de connexion GitHub et Google via Better Auth (nécessite le mode Base de données)
+- **Gestion des serveurs et des groupes** - Organisez les serveurs en groupes, gérez leur visibilité et contrôlez l'exposition des Tools, Prompts et Resources
+
+### Exploiter en confiance
+
 - **Journaux et observabilité** - Consultez l'activité des appels d'outils, l'état des requêtes, la latence et les journaux des serveurs
 - **Vérifications de santé** - Surveillez la santé des connexions et l'état des serveurs depuis un même endroit
 - **Tableau de bord Web** - Gérez la configuration et le fonctionnement des serveurs depuis un navigateur
-- **Routage intelligent** - Découverte d'outils propulsée par IA utilisant la recherche sémantique vectorielle ([En savoir plus](https://docs.mcphub.app/features/smart-routing))
 - **Compression des résultats d'outils** - Réduisez automatiquement les grands résultats texte avant qu'ils n'atteignent les clients
-- **Configuration à chaud** - Ajoutez, supprimez ou mettez à jour les serveurs sans temps d'arrêt
-- **Support OAuth 2.0** - Modes client et serveur pour une authentification sécurisée ([En savoir plus](https://docs.mcphub.app/features/oauth))
-- **Connexion Sociale** - Support de connexion GitHub et Google via Better Auth (nécessite le mode Base de données)
 - **Mode Base de données** - Stockez la configuration dans PostgreSQL pour les environnements de production ([En savoir plus](https://docs.mcphub.app/configuration/database-configuration))
 - **Prêt pour Docker** - Déployez instantanément avec la configuration conteneurisée
 
 ## 🔧 Démarrage rapide
 
+### Prérequis
+
+- **Docker** (recommandé) — le moyen le plus rapide d'exécuter MCPHub ; toutes les commandes ci-dessous l'utilisent
+- **Node.js** `^18.0.0 || >=20.0.0` et **pnpm** `10.12.4` — uniquement pour exécuter depuis les sources ou développer localement (voir [Développement local](#développement-local))
+
+### Démarrer avec Docker
+
+```bash
+docker run -p 3000:3000 -v ./data:/app/data samanhappy/mcphub
+```
+
+Ouvrez `http://localhost:3000` et connectez-vous avec le nom d'utilisateur `admin`. Au premier lancement, si la variable d'environnement `ADMIN_PASSWORD` n'est pas définie, un mot de passe aléatoire est généré et affiché dans les logs du serveur.
+
+La configuration, les utilisateurs et les identifiants persistent dans `./data` par défaut.
+
+Avec vos propres serveurs ? Avant le premier lancement, créez `data/mcp_settings.json` (voir [Configuration](#configuration)). Ensuite, ajoutez des serveurs dans le tableau de bord ou modifiez le fichier existant et redémarrez MCPHub.
+
 ### Configuration
 
-Créez un fichier `mcp_settings.json` :
+Avant le premier lancement, créez `data/mcp_settings.json` :
 
 ```json
 {
@@ -56,13 +90,7 @@ Créez un fichier `mcp_settings.json` :
 
 ### Déploiement avec Docker
 
-```bash
-# Exécutez avec une configuration personnalisée (recommandé)
-docker run -p 3000:3000 -v ./mcp_settings.json:/app/mcp_settings.json -v ./data:/app/data samanhappy/mcphub
-
-# Ou exécutez avec les paramètres par défaut (montez ./data pour préserver l'état entre redémarrages)
-docker run -p 3000:3000 -v ./data:/app/data samanhappy/mcphub
-```
+Voir [Démarrer avec Docker](#démarrer-avec-docker) pour la commande prête à copier. Gardez `./data` monté pour conserver la configuration, les utilisateurs et les identifiants après la recréation du conteneur.
 
 Deux variantes d'image sont publiées sous `samanhappy/mcphub` :
 
@@ -73,11 +101,11 @@ Voir [Configuration Docker](https://docs.mcphub.app/configuration/docker-setup)
 
 ### Accéder au tableau de bord
 
-Ouvrez `http://localhost:3000` et connectez-vous avec le nom d'utilisateur `admin`. Au premier lancement, si la variable d'environnement `ADMIN_PASSWORD` n'est pas définie, un mot de passe aléatoire est généré et affiché dans les logs du serveur. Vous pouvez également prédéfinir le mot de passe :
+Ouvrez `http://localhost:3000` (voir [Démarrer avec Docker](#démarrer-avec-docker) pour la connexion). Vous pouvez également prédéfinir le mot de passe :
 
 ```bash
 # Docker : définir le mot de passe admin via une variable d'environnement
-docker run -p 3000:3000 -e ADMIN_PASSWORD=your-secure-password samanhappy/mcphub
+docker run -p 3000:3000 -v ./data:/app/data -e ADMIN_PASSWORD=your-secure-password samanhappy/mcphub
 ```
 
 > **Conseil :** Changez le mot de passe admin après la première connexion pour plus de sécurité.
@@ -109,6 +137,7 @@ http://localhost:3000/mcp/$smart/{group}  # Routage intelligent dans un groupe
 | [Mode Base de données](https://docs.mcphub.app/configuration/database-configuration) | Configuration PostgreSQL pour la production |
 | [OAuth](https://docs.mcphub.app/features/oauth)                                      | Configuration client et serveur OAuth 2.0   |
 | [Routage intelligent](https://docs.mcphub.app/features/smart-routing)                | Découverte d'outils propulsée par IA        |
+| [Guide CLI](https://docs.mcphub.app/features/cli)                                 | Gérer et appeler le hub depuis un terminal  |
 | [Configuration Docker](https://docs.mcphub.app/configuration/docker-setup)           | Guide de déploiement Docker                 |
 
 ## 🧑‍💻 Développement local
@@ -142,6 +171,8 @@ Les contributions sont les bienvenues ! Rejoignez notre [communauté Discord](ht
 
 [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/samanhappy)
 
+Les utilisateurs en Chine peuvent aussi soutenir via WeChat Pay — voir [中文版](README.zh.md).
+
 ## 🌟 Historique des étoiles
 
 [![Historique des étoiles](https://star-history.dera.page/svg?repos=samanhappy/mcphub&type=Date)](https://star-history.dera.page/#samanhappy/mcphub&Date)

package/README.md

@@ -1,12 +1,19 @@
 # MCPHub
 
-> A self-hosted MCP gateway and management platform for connecting, managing, and operating MCP servers.
+> An open-source, self-hosted MCP gateway and control plane for connecting, controlling, and operating MCP servers.
 
-[![MCP Toplist](https://mcptoplist.com/badge/glama%2Fsamanhappy%2Fmcphub.svg)](https://mcptoplist.com/server/glama%2Fsamanhappy%2Fmcphub)
+[![CI](https://github.com/samanhappy/mcphub/actions/workflows/ci.yml/badge.svg)](https://github.com/samanhappy/mcphub/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@samanhappy/mcphub)](https://www.npmjs.com/package/@samanhappy/mcphub)
+[![Docker pulls](https://img.shields.io/docker/pulls/samanhappy/mcphub)](https://hub.docker.com/r/samanhappy/mcphub)
+[![License](https://img.shields.io/github/license/samanhappy/mcphub)](LICENSE)
+[![Discord](https://img.shields.io/badge/discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/2BJehJZVH5)
+[![GitHub stars](https://img.shields.io/github/stars/samanhappy/mcphub?style=social)](https://github.com/samanhappy/mcphub/stargazers)
 
 English | [Français](README.fr.md) | [中文版](README.zh.md)
 
-MCPHub provides a unified way to connect and manage multiple MCP servers, organize them into groups, control access, and expose stable MCP endpoints for clients such as Claude Code, Cursor, Cherry Studio, OpenWebUI, and other MCP-compatible applications.
+MCPHub provides a unified control point between AI clients and MCP servers. Connect local and remote MCP servers once, organize and route their capabilities through stable endpoints, control access with authentication, scoped credentials, and per-user visibility, and operate everything with centralized logs, activity tracking, and health monitoring.
+
+It works with MCP clients such as Claude Code, Cursor, Cherry Studio, OpenWebUI, and other MCP-compatible applications.
 
 ![Dashboard Preview](assets/dashboard.png)
 
@@ -18,28 +25,54 @@ MCPHub provides a unified way to connect and manage multiple MCP servers, organi
 
 ## 🚀 Features
 
+### Connect once, expose everywhere
+
+- **Smart Routing** ⭐ - AI-powered tool discovery using vector semantic search ([Learn more](https://docs.mcphub.app/features/smart-routing))
 - **Unified MCP Gateway** - Expose all connected servers through stable MCP endpoints, including routes for groups and individual servers
-- **Server and Group Management** - Organize servers into groups, manage visibility, and control Tool, Prompt, and Resource exposure
+- **Server Aliases and Routing** - Define aliases and route clients to all servers, specific groups, individual servers, or smart routing
 - **SSE / Streamable HTTP / stdio Support** - Connect local and remote MCP servers over the supported transports
+- **Hot-Swappable Config** - Add, remove, or update servers without downtime
+
+### Control access and credentials
+
+- **Per-user Credentials** ⭐ - Bind personal keys to one shared server, with encrypted storage and isolated stdio runtimes ([Learn more](docs/features/per-user-credentials.mdx))
 - **Authentication and Access Control** - Use OAuth 2.0, bearer keys, and server or group visibility controls to manage access
-- **Server Aliases and Routing** - Define aliases and route clients to all servers, specific groups, individual servers, or smart routing
+- **OAuth 2.0 Support** ⭐ - Both client and server modes for secure authentication ([Learn more](https://docs.mcphub.app/features/oauth))
+- **Social Login** - Seamless GitHub and Google login support with Better Auth integration (requires Database Mode)
+- **Server and Group Management** - Organize servers into groups, manage visibility, and control Tool, Prompt, and Resource exposure
+
+### Operate with confidence
+
 - **Logs and Observability** - Inspect tool-call activity, request status, latency, and server logs
 - **Health Checks** - Monitor connection health and server status from one place
 - **Web Dashboard** - Manage server configuration and runtime operations from a browser
-- **Smart Routing** - AI-powered tool discovery using vector semantic search ([Learn more](https://docs.mcphub.app/features/smart-routing))
 - **MCP Apps Proxy** - Transparently forward interactive MCP Apps on single-server routes ([Learn more](https://docs.mcphub.app/features/mcp-apps))
 - **Tool Result Compression** - Transparently reduce large text tool outputs before they reach clients
-- **Hot-Swappable Config** - Add, remove, or update servers without downtime
-- **OAuth 2.0 Support** - Both client and server modes for secure authentication ([Learn more](https://docs.mcphub.app/features/oauth))
-- **Social Login** - Seamless GitHub and Google login support with Better Auth integration (requires Database Mode)
 - **Database Mode** - Store configuration in PostgreSQL for production environments ([Learn more](https://docs.mcphub.app/configuration/database-configuration))
 - **Docker-Ready** - Deploy instantly with containerized setup
 
 ## 🔧 Quick Start
 
+### Prerequisites
+
+- **Docker** (recommended) — the fastest way to run MCPHub; all commands below use it
+- **Node.js** `^18.0.0 || >=20.0.0` and **pnpm** `10.12.4` — only needed to run from source or develop locally (see [Local Development](#local-development))
+
+### Start with Docker
+
+```bash
+docker run -p 3000:3000 -v ./data:/app/data samanhappy/mcphub
+```
+
+Open `http://localhost:3000` and log in with username `admin`. On first launch, if no `ADMIN_PASSWORD` environment variable is set, a random password is generated and printed to the server logs.
+
+Settings, users, and credential bindings persist in `./data` by default.
+
+Want your own servers? Before the first launch, create `data/mcp_settings.json` (see [Configuration](#configuration)). After launch, add servers in the dashboard or edit the existing file and restart MCPHub.
+
 ### Configuration
 
-Create a `mcp_settings.json` file:
+Create `data/mcp_settings.json` before the first launch:
 
 ```json
 {
@@ -60,13 +93,7 @@ Create a `mcp_settings.json` file:
 
 ### Docker Deployment
 
-```bash
-# Run with custom config (recommended)
-docker run -p 3000:3000 -v ./mcp_settings.json:/app/mcp_settings.json -v ./data:/app/data samanhappy/mcphub
-
-# Or run with default settings (also mount ./data so credentials and state survive restarts)
-docker run -p 3000:3000 -v ./data:/app/data samanhappy/mcphub
-```
+See [Start with Docker](#start-with-docker) for the copy-paste command. Keep `./data` mounted so settings, users, and credential bindings survive container recreation.
 
 Two image variants are published under `samanhappy/mcphub`:
 
@@ -77,11 +104,11 @@ See [Docker Setup](https://docs.mcphub.app/configuration/docker-setup) for build
 
 ### Access Dashboard
 
-Open `http://localhost:3000` and log in with username `admin`. On first launch, if no `ADMIN_PASSWORD` environment variable is set, a random password is generated and printed to the server logs. You can also pre-set the password:
+Open `http://localhost:3000` (see [Start with Docker](#start-with-docker) for login details). You can also pre-set the password:
 
 ```bash
 # Docker: set admin password via environment variable
-docker run -p 3000:3000 -e ADMIN_PASSWORD=your-secure-password samanhappy/mcphub
+docker run -p 3000:3000 -v ./data:/app/data -e ADMIN_PASSWORD=your-secure-password samanhappy/mcphub
 ```
 
 > **Tip:** Change the admin password after first login for security.
@@ -104,24 +131,6 @@ http://localhost:3000/mcp/$smart/{group}  # Smart routing within group
 
 📖 See [API Reference](https://docs.mcphub.app/api-reference) for detailed endpoint documentation.
 
-### Manage From the Terminal
-
-The same `mcphub` binary doubles as a CLI for the running hub — no extra install needed.
-
-```bash
-mcphub login --url http://localhost:3000 --username admin
-mcphub servers list
-mcphub servers add fetch --type stdio --command uvx --arg mcp-server-fetch
-mcphub tools list                              # discover what tools are available
-mcphub tools get fetch_url                     # see required params + sample command
-mcphub call fetch_url url=https://example.com --json
-mcphub keys create --name ci --access-type all
-```
-
-It also speaks the public marketplace API (`mcphub discover`, `mcphub install ...`) so server lookup and one-command install work against any hub with discovery enabled.
-
-📖 See [CLI Guide](https://docs.mcphub.app/features/cli) for every subcommand, profiles, and CI usage.
-
 ## 📚 Documentation
 
 | Topic                                                                          | Description                       |
@@ -162,8 +171,8 @@ Local development uses `admin` / `admin123` and stores its writable settings cop
 
 Running MCPHub in production?
 
-Work directly with the maintainer on production deployment, OAuth/OIDC,
-access control, credential management, audit, Kubernetes, and HA readiness.
+Work directly with the maintainer on production architecture, OAuth/OIDC,
+identity and access control, credential management, audit, Kubernetes, and HA readiness.
 
 [Discuss a production pilot →](https://www.mcphub.app/pricing)
 
@@ -175,6 +184,8 @@ Contributions welcome! See our [Discord community](https://discord.gg/2BJehJZVH5
 
 [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/samanhappy)
 
+Chinese users can also support via WeChat Pay — see [中文版](README.zh.md).
+
 ## 🌟 Star History
 
 [![Star History Chart](https://star-history.dera.page/svg?repos=samanhappy/mcphub&type=Date)](https://star-history.dera.page/#samanhappy/mcphub&Date)

package/README.zh.md

@@ -1,10 +1,19 @@
 # MCPHub
 
-> 自托管的 MCP 网关与管理平台，用于连接、管理和运行 MCP 服务器。
+> 开源、自托管的 MCP 网关与控制平面，用于连接、控制和运行 MCP 服务器。
+
+[![CI](https://github.com/samanhappy/mcphub/actions/workflows/ci.yml/badge.svg)](https://github.com/samanhappy/mcphub/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@samanhappy/mcphub)](https://www.npmjs.com/package/@samanhappy/mcphub)
+[![Docker pulls](https://img.shields.io/docker/pulls/samanhappy/mcphub)](https://hub.docker.com/r/samanhappy/mcphub)
+[![License](https://img.shields.io/github/license/samanhappy/mcphub)](LICENSE)
+[![Discord](https://img.shields.io/badge/discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/2BJehJZVH5)
+[![GitHub stars](https://img.shields.io/github/stars/samanhappy/mcphub?style=social)](https://github.com/samanhappy/mcphub/stargazers)
 
 [English](README.md) | [Français](README.fr.md) | 中文版
 
-MCPHub 提供统一的方式来连接和管理多个 MCP 服务器，将它们组织成分组、控制访问权限，并为 Claude Code、Cursor、Cherry Studio、OpenWebUI 及其他兼容 MCP 的应用提供稳定的 MCP 端点。
+MCPHub 是 AI 客户端与 MCP 服务器之间的统一控制点。一次连接本地和远程 MCP 服务器，通过稳定端点组织和路由其能力，借助身份认证、限定作用域的凭据和用户级可见性控制访问，并通过集中日志、活动追踪和健康监控统一运行与管理。
+
+兼容 Claude Code、Cursor、Cherry Studio、OpenWebUI 及其他支持 MCP 的应用。
 
 ![控制面板预览](assets/dashboard.zh.png)
 
@@ -16,27 +25,53 @@ MCPHub 提供统一的方式来连接和管理多个 MCP 服务器，将它们
 
 ## 🚀 功能亮点
 
+### 一次连接，随处暴露
+
+- **智能路由** ⭐ - 基于向量语义搜索的 AI 工具发现 ([了解更多](https://docs.mcphub.app/zh/features/smart-routing))
 - **统一 MCP 网关** - 通过稳定的 MCP 端点暴露所有已连接的服务器，也支持分组和单服务器路由
-- **服务器与分组管理** - 组织服务器分组，管理可见性，并控制 Tool、Prompt 与 Resource 的暴露范围
+- **服务器别名与路由** - 设置别名，并将客户端路由到所有服务器、指定分组、单个服务器或智能路由
 - **SSE / Streamable HTTP / stdio 支持** - 通过支持的传输方式连接本地和远程 MCP 服务器
+- **热插拔配置** - 无需停机即可添加、移除或更新服务器
+
+### 管控访问与凭据
+
+- **个人凭据** ⭐ - 一个共享服务器支持每位用户独立绑定密钥，加密保存并隔离 stdio 运行进程（[了解更多](docs/zh/features/per-user-credentials.mdx)）
 - **身份认证与访问控制** - 使用 OAuth 2.0、Bearer Key 以及服务器或分组可见性控制访问权限
-- **服务器别名与路由** - 设置别名，并将客户端路由到所有服务器、指定分组、单个服务器或智能路由
+- **OAuth 2.0 支持** ⭐ - 客户端和服务端模式，实现安全认证 ([了解更多](https://docs.mcphub.app/zh/features/oauth))
+- **社交一键登录** - 通过 Better Auth 集成支持 GitHub 和 Google 快捷登录（需启用数据库模式）
+- **服务器与分组管理** - 组织服务器分组，管理可见性，并控制 Tool、Prompt 与 Resource 的暴露范围
+
+### 稳定运行
+
 - **日志与可观测性** - 查看工具调用活动、请求状态、延迟和服务器日志
 - **健康检查** - 在一个地方监控连接健康状况和服务器状态
 - **Web 控制台** - 通过浏览器管理服务器配置和运行状态
-- **智能路由** - 基于向量语义搜索的 AI 工具发现 ([了解更多](https://docs.mcphub.app/zh/features/smart-routing))
 - **工具结果压缩** - 在返回客户端前透明压缩大型文本工具输出
-- **热插拔配置** - 无需停机即可添加、移除或更新服务器
-- **OAuth 2.0 支持** - 客户端和服务端模式，实现安全认证 ([了解更多](https://docs.mcphub.app/zh/features/oauth))
-- **社交一键登录** - 通过 Better Auth 集成支持 GitHub 和 Google 快捷登录（需启用数据库模式）
 - **数据库模式** - 将配置存储在 PostgreSQL 中，适用于生产环境 ([了解更多](https://docs.mcphub.app/zh/configuration/database-configuration))
 - **Docker 就绪** - 容器化部署，开箱即用
 
 ## 🔧 快速开始
 
+### 前置条件
+
+- **Docker**（推荐）—— 运行 MCPHub 最快的方式，下面的命令都基于它
+- **Node.js** `^18.0.0 || >=20.0.0` 和 **pnpm** `10.12.4` —— 仅从源码运行或参与本地开发时需要（见[本地开发](#本地开发)）
+
+### 使用 Docker 启动
+
+```bash
+docker run -p 3000:3000 -v ./data:/app/data samanhappy/mcphub
+```
+
+打开 `http://localhost:3000`，使用用户名 `admin` 登录。首次启动时，如果未设置 `ADMIN_PASSWORD` 环境变量，系统将自动生成随机密码并输出到服务器日志中。
+
+配置、用户和凭据绑定默认持久化到 `./data`。
+
+想用自己的服务器？首次启动前，创建 `data/mcp_settings.json`（见[配置](#配置)）。启动后，可在控制台添加服务器，或编辑现有配置文件并重启 MCPHub。
+
 ### 配置
 
-创建 `mcp_settings.json` 文件：
+首次启动前，创建 `data/mcp_settings.json` 文件：
 
 ```json
 {
@@ -57,13 +92,7 @@ MCPHub 提供统一的方式来连接和管理多个 MCP 服务器，将它们
 
 ### Docker 部署
 
-```bash
-# 挂载自定义配置运行（推荐）
-docker run -p 3000:3000 -v ./mcp_settings.json:/app/mcp_settings.json -v ./data:/app/data samanhappy/mcphub
-
-# 或使用默认配置运行（仍建议挂载 ./data，避免容器删除后数据丢失）
-docker run -p 3000:3000 -v ./data:/app/data samanhappy/mcphub
-```
+可复制的命令见[使用 Docker 启动](#使用-docker-启动)。请保持挂载 `./data`，这样配置、用户和凭据绑定在容器重建后不会丢失。
 
 `samanhappy/mcphub` 提供两种镜像变体：
 
@@ -74,11 +103,11 @@ docker run -p 3000:3000 -v ./data:/app/data samanhappy/mcphub
 
 ### 访问控制台
 
-打开 `http://localhost:3000`，使用用户名 `admin` 登录。首次启动时，如果未设置 `ADMIN_PASSWORD` 环境变量，系统将自动生成随机密码并输出到服务器日志中。也可以预先设置密码：
+打开 `http://localhost:3000`（登录方式见[使用 Docker 启动](#使用-docker-启动)）。也可以预先设置密码：
 
 ```bash
 # Docker：通过环境变量设置管理员密码
-docker run -p 3000:3000 -e ADMIN_PASSWORD=your-secure-password samanhappy/mcphub
+docker run -p 3000:3000 -v ./data:/app/data -e ADMIN_PASSWORD=your-secure-password samanhappy/mcphub
 ```
 
 > **提示：** 首次登录后请及时修改管理员密码以确保安全。
@@ -101,24 +130,6 @@ http://localhost:3000/mcp/$smart/{group}  # 智能路由（特定分组）
 
 📖 查看 [API 参考](https://docs.mcphub.app/zh/api-reference)了解详细的端点文档。
 
-### 终端管理
-
-`mcphub` 同一个二进制兼任 CLI，无需额外安装。
-
-```bash
-mcphub login --url http://localhost:3000 --username admin
-mcphub servers list
-mcphub servers add fetch --type stdio --command uvx --arg mcp-server-fetch
-mcphub tools list                              # 看有哪些 tool 可调
-mcphub tools get fetch_url                     # 看必填参数和样例命令
-mcphub call fetch_url url=https://example.com --json
-mcphub keys create --name ci --access-type all
-```
-
-CLI 同样对接公共市场接口（`mcphub discover`、`mcphub install ...`），可对任意开启了 discovery 的 hub 做检索与一键安装。
-
-📖 查看 [CLI 指南](https://docs.mcphub.app/zh/features/cli)了解全部子命令、profile 管理与 CI 用法。
-
 ## 📚 文档
 
 | 主题                                                                           | 描述                         |
@@ -158,7 +169,7 @@ pnpm dev
 
 正在生产环境使用 MCPHub？
 
-可以直接与维护者合作，解决生产部署、OAuth/OIDC、访问控制、
+可以直接与维护者合作，解决生产架构、OAuth/OIDC、身份与访问控制、
 凭据管理、审计、Kubernetes 和高可用准备等问题。
 
 [讨论 Production Pilot →](https://www.mcphub.app/zh/pricing)
@@ -173,6 +184,8 @@ pnpm dev
 
 <img src="assets/reward.png" width="350">
 
+海外用户可通过 [ko-fi](https://ko-fi.com/samanhappy) 支持。
+
 ## 致谢
 
 感谢以下朋友的赞赏：小白、唐秀川、琛、孔、黄祥取、兰军飞、无名之辈、Kyle，以及其他匿名支持者。

package/dist/clients/openapi.js

@@ -1,3 +1,4 @@
+import { AxiosHeaders } from 'axios';
 import axios from 'axios';
 import { randomUUID } from 'node:crypto';
 import { readFile } from 'node:fs/promises';
@@ -657,13 +658,34 @@ export class OpenAPIClient {
             }
             // Build query parameters
             const queryParams = {};
+            const serializedArrayQueryParams = new URLSearchParams();
             const queryParamDefs = tool.parameters?.filter((p) => p.in === 'query') || [];
             for (const param of queryParamDefs) {
                 const value = args[param.name];
                 if (value !== undefined) {
-                    queryParams[param.name] = value;
+                    // OpenAPI query parameters default to style=form and explode=true.
+                    // Axios serializes arrays as `name[]=value`, which differs from the
+                    // OpenAPI default of repeated `name=value` pairs. Keep non-form
+                    // styles with Axios so this focused fix does not alter their current
+                    // behavior.
+                    if (Array.isArray(value) &&
+                        (param.style === undefined || param.style === 'form') &&
+                        param.explode !== false) {
+                        for (const item of value) {
+                            if (item !== undefined) {
+                                serializedArrayQueryParams.append(param.name, String(item));
+                            }
+                        }
+                    }
+                    else {
+                        queryParams[param.name] = value;
+                    }
                 }
             }
+            const serializedArrayQuery = serializedArrayQueryParams.toString();
+            if (serializedArrayQuery) {
+                url += `${url.includes('?') ? '&' : '?'}${serializedArrayQuery}`;
+            }
             // Prepare request configuration
             const requestConfig = {
                 method: tool.method,
@@ -775,6 +797,15 @@ export class OpenAPIClient {
             if ((cookieSessionEnabled || this.staticCookieHeader) && resolvedTarget) {
                 this.applyRequestCookies(requestConfig, resolvedTarget.href, cookieSessionEnabled ? sessionId : undefined);
             }
+            // Bound headers take precedence over tool parameters, cookies and static auth.
+            if (this.config.credentialTemplate?.length) {
+                const headers = AxiosHeaders.from(requestConfig.headers);
+                for (const slot of this.config.credentialTemplate) {
+                    if (slot.target === 'headers')
+                        headers.set(slot.name, this.config.headers?.[slot.name]);
+                }
+                requestConfig.headers = headers;
+            }
             authorizationUsedForRequest = this.getDefaultAuthorizationHeader();
             attemptedUpstreamRequest = true;
             const response = await this.httpClient.request(requestConfig);