fix(mcp): fix MCP infinite loading issue (#220)

Co-authored-by: choi sung keun <86150470+cgoinglove@users.noreply.github.com>
Co-authored-by: cgoing <neo.cgoing@gmail.com>

Author: cgoing-bot

.env.example

@@ -21,12 +21,21 @@ BETTER_AUTH_URL=
 # If you don't have PostgreSQL running locally, start it with: pnpm docker:pg
 POSTGRES_URL=postgres://your_username:your_password@localhost:5432/your_database_name
 
+# (Optional)
+# When running multiple server instances (load balancing, clustering):
+# - With Redis: Real-time MCP synchronization + reduced polling
+# - Without Redis: Polling-only synchronization (single instance or dev mode)
+# redis://localhost:6379
+REDIS_URL=
+
+
 # (Optional)
 # === Tools === 
 # Exa AI for web search and content extraction (optional, but recommended for @web and research features)
 EXA_API_KEY=
 
 
+# (Optional)
 # Whether to use file-based MCP config (default: false)
 FILE_BASED_MCP_CONFIG=false
 
@@ -53,12 +62,14 @@ MICROSOFT_TENANT_ID=
 # Set to 1 to force account selection
 MICROSOFT_FORCE_ACCOUNT_SELECTION=
 
-
+# (Optional)
 # Set this to 1 to disable email sign in
 DISABLE_EMAIL_SIGN_IN=
 
+# (Optional)
 # Set this to 1 to disable user sign-ups.
 DISABLE_SIGN_UP=
 
+# (Optional)
 # Set this to 1 to disallow adding MCP servers.
 NOT_ALLOW_ADD_MCP_SERVERS=

README.md

@@ -4,9 +4,8 @@
 [![Local First](https://img.shields.io/badge/Local-First-blue)](https://localfirstweb.dev/)
 [![Discord](https://img.shields.io/discord/1374047276074537103?label=Discord&logo=discord&color=5865F2)](https://discord.gg/gCRu69Upnp)
 
-[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/cgoinglove/better-chatbot&env=BETTER_AUTH_SECRET&env=OPENAI_API_KEY&env=GOOGLE_GENERATIVE_AI_API_KEY&env=ANTHROPIC_API_KEY&envDescription=Learn+more+about+how+to+get+the+API+Keys+for+the+application&envLink=https://github.com/cgoinglove/better-chatbot/blob/main/.env.example&demo-title=better-chatbot&demo-description=An+Open-Source+Chatbot+Template+Built+With+Next.js+and+the+AI+SDK+by+Vercel.&products=[{"type":"integration","protocol":"storage","productSlug":"neon","integrationSlug":"neon"}])
+[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/cgoinglove/better-chatbot&env=BETTER_AUTH_SECRET&env=OPENAI_API_KEY&env=GOOGLE_GENERATIVE_AI_API_KEY&env=ANTHROPIC_API_KEY&envDescription=BETTER_AUTH_SECRET+is+required+(enter+any+secret+value).+At+least+one+LLM+provider+API+key+(OpenAI,+Claude,+or+Google)+is+required,+but+you+can+add+all+of+them.+See+the+link+below+for+details.&envLink=https://github.com/cgoinglove/better-chatbot/blob/main/.env.example&demo-title=better-chatbot&demo-description=An+Open-Source+Chatbot+Template+Built+With+Next.js+and+the+AI+SDK+by+Vercel.&products=[{"type":"integration","protocol":"storage","productSlug":"neon","integrationSlug":"neon"},{"type":"integration","protocol":"storage","productSlug":"upstash-kv","integrationSlug":"upstash"}])
 
-Our goal is to create the best possible chatbot UX — focusing on the joy and intuitiveness users feel when calling and interacting with AI tools.
 
 See the experience in action in the [preview](#preview) below!
 
@@ -63,20 +62,21 @@ Open [http://localhost:3000](http://localhost:3000) in your browser to get start
   - [🛠️ Default Tools](#️-default-tools)
     - [🌐 Web Search](#-web-search)
     - [⚡️ JS Executor](#️-js-executor)
+    - [📊 Data Visualization Tools](#-data-visualization-tools)
 - [Getting Started](#getting-started)
   - [Quick Start (Docker Compose Version) 🐳](#quick-start-docker-compose-version-)
   - [Quick Start (Local Version) 🚀](#quick-start-local-version-)
   - [Environment Variables](#environment-variables)
 - [📘 Guides](#-guides)
-  - [🔌 MCP Server Setup \& Tool Testing](#-mcp-server-setup--tool-testing)
-  - [🐳 Docker Hosting Guide](#-docker-hosting-guide)
-  - [▲ Vercel Hosting Guide](#-vercel-hosting-guide)
-  - [🎯 System Prompts \& Chat Customization](#-system-prompts--chat-customization)
-  - [🔐 OAuth Sign-In Setup](#-oauth-sign-in-setup)
-  - [🕵🏿 Adding openAI like providers](#-adding-openai-like-providers)
+    - [🔌 MCP Server Setup \& Tool Testing](#-mcp-server-setup--tool-testing)
+    - [🐳 Docker Hosting Guide](#-docker-hosting-guide)
+    - [▲ Vercel Hosting Guide](#-vercel-hosting-guide)
+    - [🎯 System Prompts \& Chat Customization](#-system-prompts--chat-customization)
+    - [🔐 OAuth Sign-In Setup](#-oauth-sign-in-setup)
+    - [🕵🏿 Adding openAI like providers](#-adding-openai-like-providers)
 - [💡 Tips](#-tips)
-  - [🧠 Agentic Chatbot with Project Instructions](#-agentic-chatbot-with-project-instructions)
-  - [💬 Temporary Chat Windows](#-temporary-chat-windows)
+    - [🧠 Agentic Chatbot with Project Instructions](#-agentic-chatbot-with-project-instructions)
+    - [💬 Temporary Chat Windows](#-temporary-chat-windows)
 - [🗺️ Roadmap](#️-roadmap)
 - [🙌 Contributing](#-contributing)
 - [💬 Join Our Discord](#-join-our-discord)

docs/tips-guides/vercel.md

@@ -1,8 +1,7 @@
 # Vercel Deployment Guide
 
 1. **Click this button** to start the deployment process:
-
-   [![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/cgoinglove/better-chatbot&env=OPENAI_API_KEY&env=BETTER_AUTH_SECRET&envDescription=Learn+more+about+how+to+get+the+API+Keys+for+the+application&envLink=https://github.com/cgoinglove/better-chatbot/blob/main/.env.example&demo-title=better-chatbot&demo-description=An+Open-Source+Chatbot+Template+Built+With+Next.js+and+the+AI+SDK+by+Vercel.&products=[{"type":"integration","protocol":"storage","productSlug":"neon","integrationSlug":"neon"}])
+[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/cgoinglove/better-chatbot&env=BETTER_AUTH_SECRET&env=OPENAI_API_KEY&env=GOOGLE_GENERATIVE_AI_API_KEY&env=ANTHROPIC_API_KEY&envDescription=BETTER_AUTH_SECRET+is+required+(enter+any+secret+value).+At+least+one+LLM+provider+API+key+(OpenAI,+Claude,+or+Google)+is+required,+but+you+can+add+all+of+them.+See+the+link+below+for+details.&envLink=https://github.com/cgoinglove/better-chatbot/blob/main/.env.example&demo-title=better-chatbot&demo-description=An+Open-Source+Chatbot+Template+Built+With+Next.js+and+the+AI+SDK+by+Vercel.&products=[{"type":"integration","protocol":"storage","productSlug":"neon","integrationSlug":"neon"},{"type":"integration","protocol":"storage","productSlug":"upstash-kv","integrationSlug":"upstash"}])
 
 2. **Click the "Create" button** on Vercel to begin setting up your project.
 

messages/en.json

@@ -44,6 +44,10 @@
     "youAreAnExpertIn": "You are an expert in {role}"
   },
   "Error": {},
+  "Info": {
+    "mcpAddingDisabled": "MCP server addition has been disabled by the administrator.",
+    "vercelSyncDelay": "Running on Vercel\n\nMCP changes may take 10-15 seconds to sync. Please wait a moment after adding, editing, or deleting servers if changes don't appear immediately."
+  },
   "Workflow": {
     "title": "Workflow",
     "createWorkflow": "Create Workflow",

messages/es.json

@@ -321,6 +321,10 @@
     "mcpServerCustomizationPlaceholder": "ej. Si el valor de entrada es email, siempre ingresa el email en el formato ejemplo@ejemplo.com."
   },
   "Error": {},
+  "Info": {
+    "mcpAddingDisabled": "La adición de servidores MCP ha sido deshabilitada por el administrador.",
+    "vercelSyncDelay": "Ejecutándose en Vercel\n\nLos cambios de MCP pueden tardar 10-15 segundos en sincronizarse. Por favor espera un momento si los cambios no aparecen inmediatamente después de agregar, editar o eliminar servidores."
+  },
   "Workflow": {
     "title": "Flujo de Trabajo",
     "createWorkflow": "Crear Flujo de Trabajo",

messages/fr.json

@@ -321,6 +321,10 @@
     "mcpServerCustomizationPlaceholder": "ex. Si la valeur d'entrée est un email, toujours entrer l'email au format exemple@exemple.com."
   },
   "Error": {},
+  "Info": {
+    "mcpAddingDisabled": "L'ajout de serveurs MCP a été désactivé par l'administrateur.",
+    "vercelSyncDelay": "Fonctionnement sur Vercel\n\nLes modifications MCP peuvent prendre 10-15 secondes à se synchroniser. Veuillez patienter un moment si les changements n'apparaissent pas immédiatement après avoir ajouté, modifié ou supprimé des serveurs."
+  },
   "Workflow": {
     "title": "Flux de Travail",
     "createWorkflow": "Créer Flux de Travail",

messages/ja.json

@@ -320,6 +320,10 @@
     "mcpServerCustomizationPlaceholder": "例：入力値がメールの場合、常にexample@example.comの形式でメールを入力してください。"
   },
   "Error": {},
+  "Info": {
+    "mcpAddingDisabled": "管理者によりMCPサーバーの追加が無効化されています。",
+    "vercelSyncDelay": "Vercel上で動作中\n\nMCP変更の同期には10-15秒かかる場合があります。サーバーの追加、編集、または削除後に変更が即座に表示されない場合は、しばらくお待ちください。"
+  },
   "Workflow": {
     "title": "ワークフロー",
     "createWorkflow": "ワークフローを作成",

messages/ko.json

@@ -321,6 +321,10 @@
     "mcpServerCustomizationPlaceholder": "예) 이 MCP 서버의 툴중에 입력값이 email인 경우 항상 example@example.com 형식으로 입력해주세요."
   },
   "Error": {},
+  "Info": {
+    "mcpAddingDisabled": "관리자에 의해 MCP 서버 추가가 비활성화되었습니다.",
+    "vercelSyncDelay": "Vercel에서 실행 중\n\nMCP 변경사항은 동기화에 10-15초 정도 소요될 수 있습니다. 서버 추가, 편집 또는 삭제 후 변경사항이 즉시 보이지 않으면 잠시 기다려주세요."
+  },
   "Workflow": {
     "title": "워크플로우",
     "createWorkflow": "워크플로우 생성",

messages/zh.json

@@ -322,6 +322,10 @@
     "mcpServerCustomizationPlaceholder": "例如：如果输入值是电子邮件，始终以 example@example.com 格式输入电子邮件。"
   },
   "Error": {},
+  "Info": {
+    "mcpAddingDisabled": "管理员已禁用MCP服务器添加功能。",
+    "vercelSyncDelay": "在Vercel上运行\n\nMCP更改同步可能需要10-15秒。如果添加、编辑或删除服务器后更改未立即显示，请稍等片刻。"
+  },
   "Workflow": {
     "title": "工作流",
     "createWorkflow": "创建工作流",

package.json

@@ -35,6 +35,7 @@
     "docker-compose:ps": "docker-compose -f docker/compose.yml ps",
     "docker-compose:update": "git pull && docker-compose -f docker/compose.yml up -d --build",
     "docker:pg": "docker run --name better-chatbot-pg -e POSTGRES_PASSWORD=your_password -e POSTGRES_USER=your_username -e POSTGRES_DB=your_database_name -p 5432:5432 -d postgres",
+    "docker:redis": "docker run --name better-chatbot-redis -p 6379:6379 -d redis:7-alpine",
     "docker:app": "docker build -f docker/Dockerfile -t better-chatbot . && docker run -p 3000:3000 -e NO_HTTPS=1 better-chatbot",
     "prepare": "husky",
     "check": "pnpm lint:fix && pnpm check-types && pnpm test"
@@ -46,7 +47,7 @@
     "@ai-sdk/openai-compatible": "^0.2.16",
     "@ai-sdk/react": "^1.2.12",
     "@ai-sdk/xai": "^1.2.18",
-    "@modelcontextprotocol/sdk": "^1.17.0",
+    "@modelcontextprotocol/sdk": "^1.17.1",
     "@openrouter/ai-sdk-provider": "^0.4.6",
     "@radix-ui/react-accordion": "^1.2.11",
     "@radix-ui/react-avatar": "^1.1.10",
@@ -84,8 +85,9 @@
     "dotenv": "^16.6.1",
     "drizzle-orm": "^0.41.0",
     "emoji-picker-react": "^4.13.2",
-    "framer-motion": "^12.23.10",
+    "framer-motion": "^12.23.12",
     "hast-util-to-jsx-runtime": "^2.3.6",
+    "ioredis": "^5.7.0",
     "json-schema": "^0.4.0",
     "lucide-react": "^0.486.0",
     "mermaid": "^11.9.0",
@@ -96,42 +98,42 @@
     "ogl": "^1.0.11",
     "ollama-ai-provider": "^1.2.0",
     "pg": "^8.16.3",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
     "react-markdown": "^10.1.0",
     "react-resizable-panels": "^2.1.9",
     "recharts": "^2.15.4",
     "remark-gfm": "^4.0.1",
     "server-only": "^0.0.1",
-    "shiki": "^3.8.1",
-    "sonner": "^2.0.6",
+    "shiki": "^3.9.2",
+    "sonner": "^2.0.7",
     "swr": "^2.3.4",
     "tailwind-merge": "^3.3.1",
     "ts-edge": "^1.0.4",
     "ts-safe": "^0.0.5",
     "tw-animate-css": "^1.3.6",
     "vaul": "^1.1.2",
     "zod": "^3.25.76",
-    "zustand": "^5.0.6"
+    "zustand": "^5.0.7"
   },
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
     "@tailwindcss/postcss": "^4.1.11",
     "@types/json-schema": "^7.0.15",
     "@types/node": "^20.19.9",
-    "@types/pg": "^8.15.4",
-    "@types/react": "^19.1.8",
-    "@types/react-dom": "^19.1.6",
+    "@types/pg": "^8.15.5",
+    "@types/react": "^19.1.9",
+    "@types/react-dom": "^19.1.7",
     "cross-env": "^7.0.3",
     "drizzle-kit": "^0.30.6",
     "eslint": "^9.32.0",
     "eslint-config-next": "15.3.0",
     "husky": "^9.1.7",
-    "lint-staged": "^16.1.2",
+    "lint-staged": "^16.1.4",
     "rimraf": "^6.0.1",
     "tailwindcss": "^4.1.11",
     "tsx": "^4.20.3",
-    "typescript": "^5.8.3",
+    "typescript": "^5.9.2",
     "vite-tsconfig-paths": "^5.1.4",
     "vitest": "^3.2.4"
   },