From 7977fcf9301bad0bdf80ce5b3020dafe6bdd89e8 Mon Sep 17 00:00:00 2001
From: Lei Xu <leixu@leansoftx.com>
Date: Sun, 20 Apr 2025 15:53:39 +0000
Subject: [PATCH 1/4] add Category page and update server category display
 logic

---
 client/src/App.tsx                 |  3 +++
 client/src/pages/Category.tsx      | 21 +++++++++++++++++++++
 client/src/pages/ServerDetails.tsx |  2 +-
 3 files changed, 25 insertions(+), 1 deletion(-)
 create mode 100644 client/src/pages/Category.tsx

diff --git a/client/src/App.tsx b/client/src/App.tsx
index 310301fe..cdb07945 100644
--- a/client/src/App.tsx
+++ b/client/src/App.tsx
@@ -5,6 +5,7 @@ import { Docs } from './pages/Docs';
 import { About } from './pages/About';
 import { ServerDetails } from './pages/ServerDetails';
 import { Submit } from './pages/Submit';
+import { Category } from './pages/Category';
 import { Header } from './components/Header';
 import { Footer } from './components/Footer';
 import { LanguageProvider } from './contexts/LanguageContext';
@@ -21,6 +22,8 @@ function App() {
             <Route path="/about" element={<About />} />
             <Route path="/submit" element={<Submit />} />
             <Route path="/server/:hubId" element={<ServerDetails />} />
+            <Route path="/category" element={<Category />} />
+            <Route path="/category/:categoryKey" element={<Category />} />
           </Routes>
           <Footer />
         </div>
diff --git a/client/src/pages/Category.tsx b/client/src/pages/Category.tsx
new file mode 100644
index 00000000..9c33e98a
--- /dev/null
+++ b/client/src/pages/Category.tsx
@@ -0,0 +1,21 @@
+import React from 'react';
+import { useParams } from 'react-router-dom';
+import { useLanguage } from '../contexts/LanguageContext';
+
+export function Category() {
+  const { t } = useLanguage();
+  const { categoryKey } = useParams();
+  
+  return (
+    <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-16">
+      <h1 className="text-3xl font-bold text-gray-900 mb-6">hello category</h1>
+      
+      {categoryKey && (
+        <div className="bg-white rounded-xl shadow-md p-6 mb-6">
+          <h2 className="text-2xl font-semibold text-gray-800 mb-4">Category Key: {categoryKey}</h2>
+          <p className="text-gray-600">You are viewing content for the <span className="font-medium text-blue-600">{categoryKey}</span> category.</p>
+        </div>
+      )}
+    </div>
+  );
+}
diff --git a/client/src/pages/ServerDetails.tsx b/client/src/pages/ServerDetails.tsx
index 13e9183a..82f6b7ba 100644
--- a/client/src/pages/ServerDetails.tsx
+++ b/client/src/pages/ServerDetails.tsx
@@ -203,7 +203,7 @@ export function ServerDetails() {
               <div className="flex flex-wrap items-center justify-start gap-4">
                 <div className="flex items-center">
                   <span className="text-sm font-medium text-gray-500 mr-2">{t('details.category')}:</span>
-                  <span className="text-gray-900">{server.category || t('details.notSpecified')}</span>
+                  <span className="text-gray-900">{server.category ? t(`category.${server.category}`) : t('details.notSpecified')}</span>
                 </div>
                 <div className="flex items-center">
                   <span className="text-sm font-medium text-gray-500 mr-2">{t('details.requiresApiKey')}:</span>

From 8bb2fbc9671948884666fc215b683647d0f88c8b Mon Sep 17 00:00:00 2001
From: Lei Xu <leixu@leansoftx.com>
Date: Sun, 20 Apr 2025 16:06:45 +0000
Subject: [PATCH 2/4] add search_servers endpoint to filter server data by
 category and locale

---
 server/src/routes/hub.ts | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/server/src/routes/hub.ts b/server/src/routes/hub.ts
index 9cff8d15..159063fe 100644
--- a/server/src/routes/hub.ts
+++ b/server/src/routes/hub.ts
@@ -98,6 +98,33 @@ router.get('/servers', async (req: Request, res: Response): Promise<void> => {
   }
 });
 
+// GET /search_servers - returns server data filtered by category and locale
+router.get('/search_servers', async (req: Request, res: Response): Promise<void> => {
+  try {
+    console.log('api /search_servers called: req.query = ', req.query);
+    // Get parameters from query
+    const categoryKey = req.query.categoryKey as string;
+    const requestedLocale = (req.query.locale as string) || 'en';
+    
+    // Get servers from cache for the requested locale
+    const mcpServersCache = await refreshCacheIfNeeded(requestedLocale);
+    
+    // Filter by category if categoryKey is provided
+    let filteredServers = mcpServersCache;
+    if (categoryKey) {
+      filteredServers = mcpServersCache.filter(server => server.category === categoryKey);
+      console.log(`Filtered servers by category: ${categoryKey}, found ${filteredServers.length} servers`);
+    }
+    
+    // Return filtered data
+    res.json(filteredServers);
+    console.log(`v1/hub/search_servers Served filtered MCP servers data for locale: ${requestedLocale}${categoryKey ? `, category: ${categoryKey}` : ''} at ${new Date().toISOString()}`);
+  } catch (error) {
+    console.error('Error serving filtered MCP servers:', error);
+    res.status(500).json({ error: 'Internal server error' });
+  }
+});
+
 // GET /servers/:hubId - returns a specific server by hubId with enriched data from GitHub README
 router.get('/servers/:hubId', async (req: Request, res: Response): Promise<void> => {
   try {

From 2cb670305214a094568a4ba9b87ce97b6c172d21 Mon Sep 17 00:00:00 2001
From: Lei Xu <leixu@leansoftx.com>
Date: Sun, 20 Apr 2025 16:44:05 +0000
Subject: [PATCH 3/4] add category page with server fetching and loading states

---
 client/src/locale/de.json      |  15 +++-
 client/src/locale/en.json      |  15 +++-
 client/src/locale/es.json      |  15 +++-
 client/src/locale/ja.json      |  15 +++-
 client/src/locale/zh-hans.json |  15 +++-
 client/src/locale/zh-hant.json |  15 +++-
 client/src/pages/Category.tsx  | 137 ++++++++++++++++++++++++++++++---
 7 files changed, 212 insertions(+), 15 deletions(-)

diff --git a/client/src/locale/de.json b/client/src/locale/de.json
index 6015c3b9..cce4ab90 100644
--- a/client/src/locale/de.json
+++ b/client/src/locale/de.json
@@ -80,7 +80,20 @@
   },
   "common": {
     "yes": "Ja",
-    "no": "Nein"
+    "no": "Nein",
+    "loading": "Wird geladen...",
+    "server": "Server",
+    "servers": "Server",
+    "recommended": "Empfohlen",
+    "siteName": "MCP Agents Hub"
+  },
+  "category": {
+    "lastUpdated": "Zuletzt aktualisiert",
+    "noServers": "Keine Server gefunden",
+    "noServersDescription": "In dieser Kategorie sind derzeit keine Server verfügbar.",
+    "fetchError": "Fehler beim Abrufen der Kategorie-Server",
+    "of": "von",
+    "showing": "{count} von {total}"
   },
   "submit": {
     "title": "Ihren MCP-Server einreichen",
diff --git a/client/src/locale/en.json b/client/src/locale/en.json
index c8914c2d..32780174 100644
--- a/client/src/locale/en.json
+++ b/client/src/locale/en.json
@@ -80,7 +80,20 @@
   },
   "common": {
     "yes": "Yes",
-    "no": "No"
+    "no": "No",
+    "loading": "Loading...",
+    "server": "Server",
+    "servers": "Servers",
+    "recommended": "Recommended",
+    "siteName": "MCP Hub"
+  },
+  "category": {
+    "lastUpdated": "Last Updated",
+    "noServers": "No Servers Found",
+    "noServersDescription": "There are no servers available in this category at the moment.",
+    "fetchError": "Failed to fetch category servers",
+    "of": "of",
+    "showing": "{count} of {total}"
   },
   "submit": {
     "title": "Submit Your MCP Server",
diff --git a/client/src/locale/es.json b/client/src/locale/es.json
index a9e67fa7..37deed0f 100644
--- a/client/src/locale/es.json
+++ b/client/src/locale/es.json
@@ -78,7 +78,20 @@
   },
   "common": {
     "yes": "Sí",
-    "no": "No"
+    "no": "No",
+    "loading": "Cargando...",
+    "server": "Servidor",
+    "servers": "Servidores",
+    "recommended": "Recomendado",
+    "siteName": "MCP Hub"
+  },
+  "category": {
+    "lastUpdated": "Última Actualización",
+    "noServers": "No Se Encontraron Servidores",
+    "noServersDescription": "No hay servidores disponibles en esta categoría en este momento.",
+    "fetchError": "Error al obtener servidores de categoría",
+    "of": "de",
+    "showing": "{count} de {total}"
   },
   "submit": {
     "title": "Enviar Su Servidor MCP",
diff --git a/client/src/locale/ja.json b/client/src/locale/ja.json
index 8695f5ef..353d2797 100644
--- a/client/src/locale/ja.json
+++ b/client/src/locale/ja.json
@@ -79,7 +79,20 @@
   },
   "common": {
     "yes": "はい",
-    "no": "いいえ"
+    "no": "いいえ",
+    "loading": "読み込み中...",
+    "server": "サーバー",
+    "servers": "サーバー",
+    "recommended": "おすすめ",
+    "siteName": "MCP Hub"
+  },
+  "category": {
+    "lastUpdated": "最終更新",
+    "noServers": "サーバーが見つかりません",
+    "noServersDescription": "現在、このカテゴリにはサーバーがありません。",
+    "fetchError": "カテゴリサーバーの取得に失敗しました",
+    "of": "/",
+    "showing": "{count} / {total}"
   },
   "submit": {
     "title": "MCPサーバーを提出",
diff --git a/client/src/locale/zh-hans.json b/client/src/locale/zh-hans.json
index fa0ae8a4..b54e9890 100644
--- a/client/src/locale/zh-hans.json
+++ b/client/src/locale/zh-hans.json
@@ -78,7 +78,20 @@
   },
   "common": {
     "yes": "是",
-    "no": "否"
+    "no": "否",
+    "loading": "加载中...",
+    "server": "服务器",
+    "servers": "服务器",
+    "recommended": "推荐",
+    "siteName": "MCP 智能体中心"
+  },
+  "category": {
+    "lastUpdated": "最后更新",
+    "noServers": "未找到服务器",
+    "noServersDescription": "此类别暂时没有可用的服务器。",
+    "fetchError": "获取类别服务器失败",
+    "of": "共",
+    "showing": "{count} / {total}"
   },
   "submit": {
     "title": "提交您的 MCP 服务器",
diff --git a/client/src/locale/zh-hant.json b/client/src/locale/zh-hant.json
index cd35e735..29547b48 100644
--- a/client/src/locale/zh-hant.json
+++ b/client/src/locale/zh-hant.json
@@ -78,7 +78,20 @@
   },
   "common": {
     "yes": "是",
-    "no": "否"
+    "no": "否",
+    "loading": "載入中...",
+    "server": "伺服器",
+    "servers": "伺服器",
+    "recommended": "推薦",
+    "siteName": "MCP Agents 中心"
+  },
+  "category": {
+    "lastUpdated": "最後更新",
+    "noServers": "未找到伺服器",
+    "noServersDescription": "此分類目前沒有可用的伺服器。",
+    "fetchError": "獲取分類伺服器失敗",
+    "of": "共",
+    "showing": "{count} / {total}"
   },
   "submit": {
     "title": "提交您的 MCP 伺服器",
diff --git a/client/src/pages/Category.tsx b/client/src/pages/Category.tsx
index 9c33e98a..1ea8fb09 100644
--- a/client/src/pages/Category.tsx
+++ b/client/src/pages/Category.tsx
@@ -1,19 +1,138 @@
-import React from 'react';
+import { useState, useEffect, useMemo } from 'react';
 import { useParams } from 'react-router-dom';
 import { useLanguage } from '../contexts/LanguageContext';
+import { ServerCard } from '../components/ServerCard';
+import { MCPServer } from '../types';
+import { ChevronRight } from 'lucide-react';
 
 export function Category() {
-  const { t } = useLanguage();
+  const { t, language } = useLanguage();
   const { categoryKey } = useParams();
-  
-  return (
-    <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-16">
-      <h1 className="text-3xl font-bold text-gray-900 mb-6">hello category</h1>
+  const [servers, setServers] = useState<MCPServer[]>([]);
+  const [isLoading, setIsLoading] = useState(true);
+  const [visibleCount, setVisibleCount] = useState(12);
+  const LOAD_MORE_STEP = 12;
+
+  useEffect(() => {
+    const fetchCategoryServers = async () => {
+      if (!categoryKey) return;
       
+      try {
+        setIsLoading(true);
+        const url = `/v1/hub/search_servers?categoryKey=${categoryKey}&locale=${language || 'en'}`;
+        const response = await fetch(url);
+        
+        if (!response.ok) {
+          throw new Error(t('category.fetchError') || 'Failed to fetch category servers');
+        }
+        
+        const data = await response.json();
+        setServers(data);
+      } catch (error) {
+        console.error('Error fetching category servers:', error);
+        setServers([]);
+      } finally {
+        setIsLoading(false);
+      }
+    };
+
+    fetchCategoryServers();
+    // Reset visible count when category changes
+    setVisibleCount(12);
+  }, [categoryKey, language]);
+
+  const visibleServers = useMemo(() => {
+    return servers.slice(0, visibleCount);
+  }, [servers, visibleCount]);
+
+  const handleLoadMore = () => {
+    setVisibleCount(prev => Math.min(prev + LOAD_MORE_STEP, servers.length));
+  };
+
+  const formatCategoryName = (key: string) => {
+    return key
+      .split('-')
+      .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+      .join(' ');
+  };
+
+  return (
+    <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-8">
+      {/* Breadcrumbs */}
       {categoryKey && (
-        <div className="bg-white rounded-xl shadow-md p-6 mb-6">
-          <h2 className="text-2xl font-semibold text-gray-800 mb-4">Category Key: {categoryKey}</h2>
-          <p className="text-gray-600">You are viewing content for the <span className="font-medium text-blue-600">{categoryKey}</span> category.</p>
+        <nav className="mb-4">
+          <ol className="flex items-center space-x-2 text-sm text-gray-600">
+            <li>
+              <a href="/" className="hover:text-indigo-600 transition-colors duration-200">
+                {t('home.title') || 'MCP Hub'}
+              </a>
+            </li>
+            <li className="flex items-center">
+              <svg className="h-4 w-4 text-gray-400" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5l7 7-7 7" />
+              </svg>
+            </li>
+            <li className="font-medium text-gray-900">
+              {t(`category.${categoryKey}`) || t(`category-common.${categoryKey}`) || formatCategoryName(categoryKey)}
+            </li>
+          </ol>
+        </nav>
+      )}
+      
+      {/* Toolbar with statistics */}
+      {!isLoading && servers.length > 0 && (
+        <div className="bg-white rounded-lg shadow-sm border border-gray-100 p-4 flex items-center justify-between mb-6">
+          <div className="flex items-center space-x-4">
+            <div className="px-3 py-1 bg-blue-50 rounded-md text-blue-700 font-medium text-sm">
+              {servers.length} {servers.length === 1 ? t('common.server') : t('common.servers')}
+            </div>
+            <div className="text-sm text-gray-600">
+              <span className="font-medium">{servers.filter(s => s.isRecommended).length}</span> {t('common.recommended')}
+            </div>
+          </div>
+          <div className="text-sm text-gray-500">
+            {t('details.lastUpdated') || t('category.lastUpdated') || "Last Updated"}: {new Date().toLocaleDateString(language === 'en' ? 'en-US' : language === 'ja' ? 'ja-JP' : language === 'es' ? 'es-ES' : language === 'de' ? 'de-DE' : language === 'zh-hans' ? 'zh-CN' : language === 'zh-hant' ? 'zh-TW' : 'en-US')}
+          </div>
+        </div>
+      )}
+
+      {isLoading ? (
+        <div className="py-12 text-center">
+          <div className="inline-block h-8 w-8 animate-spin rounded-full border-4 border-solid border-indigo-600 border-r-transparent"></div>
+          <p className="mt-4 text-gray-600">{t('common.loading')}</p>
+        </div>
+      ) : servers.length === 0 ? (
+        <div className="bg-white rounded-xl shadow-md p-8 text-center">
+          <h2 className="text-xl font-semibold text-gray-800 mb-2">
+            {t('category.noServers')}
+          </h2>
+          <p className="text-gray-600">
+            {t('category.noServersDescription')}
+          </p>
+        </div>
+      ) : (
+        <div>
+          <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
+            {visibleServers.map((server) => (
+              <ServerCard key={server.mcpId} server={server} />
+            ))}
+          </div>
+          
+          {visibleCount < servers.length && (
+            <div className="flex justify-end mt-6">
+              <button 
+                onClick={handleLoadMore}
+                className="text-indigo-600 hover:text-indigo-800 transition-colors duration-300 
+                flex items-center text-sm font-medium group"
+              >
+                <span>{t('home.loadMore')}</span>
+                <span className="text-xs mx-2">
+                  ({visibleCount} {t('home.of')} {servers.length})
+                </span>
+                <ChevronRight className="h-5 w-5 ml-1 group-hover:translate-x-1 transition-transform" strokeWidth={2.5} />
+              </button>
+            </div>
+          )}
         </div>
       )}
     </div>

From 91302b8ffea0676354b4a6b460b4b26a24611400 Mon Sep 17 00:00:00 2001
From: Lei Xu <leixu@leansoftx.com>
Date: Sun, 20 Apr 2025 16:47:31 +0000
Subject: [PATCH 4/4] sort filtered servers by recommendation status in
 search_servers endpoint

---
 server/src/routes/hub.ts | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/server/src/routes/hub.ts b/server/src/routes/hub.ts
index 159063fe..ca4e4817 100644
--- a/server/src/routes/hub.ts
+++ b/server/src/routes/hub.ts
@@ -116,9 +116,19 @@ router.get('/search_servers', async (req: Request, res: Response): Promise<void>
       console.log(`Filtered servers by category: ${categoryKey}, found ${filteredServers.length} servers`);
     }
     
-    // Return filtered data
+    // Sort servers so that isRecommended: true servers appear first
+    filteredServers.sort((a, b) => {
+      // If a is recommended and b is not, a comes first
+      if (a.isRecommended && !b.isRecommended) return -1;
+      // If b is recommended and a is not, b comes first
+      if (!a.isRecommended && b.isRecommended) return 1;
+      // If both have the same recommendation status, maintain original order
+      return 0;
+    });
+    
+    // Return filtered and sorted data
     res.json(filteredServers);
-    console.log(`v1/hub/search_servers Served filtered MCP servers data for locale: ${requestedLocale}${categoryKey ? `, category: ${categoryKey}` : ''} at ${new Date().toISOString()}`);
+    console.log(`v1/hub/search_servers Served filtered and sorted MCP servers data (recommended first) for locale: ${requestedLocale}${categoryKey ? `, category: ${categoryKey}` : ''} at ${new Date().toISOString()}`);
   } catch (error) {
     console.error('Error serving filtered MCP servers:', error);
     res.status(500).json({ error: 'Internal server error' });