temba-mcp 0.1.2 → 0.2.0

package/package.json

@@ -1,23 +1,25 @@
 {
   "name": "temba-mcp",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "MCP for Temba documentation",
   "author": "Bouwe (https://bouwe.io)",
   "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest --watch",
     "update": "npx -y jelmerro/nus"
   },
   "bin": {
-    "temba-mcp": "./cli.js"
+    "temba-mcp": "./src/cli.js"
   },
   "type": "module",
   "files": [
-    "cli.js",
-    "mcp.js",
-    "searchDocs.js",
-    "version.js"
+    "src"
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.18"
   }
 }

package/{mcp.js → src/mcp.js}

@@ -4,21 +4,37 @@ import { z } from 'zod'
 import { searchDocs } from './searchDocs.js'
 import { version } from './version.js'
 
-export const startMcpServer = async () => {
-  const server = new McpServer({
-    name: 'temba-docs-mcp',
-    version,
-  })
+let index = []
+let lastFetched = 0
+const CACHE_TTL = 3600000 // 1 hour in milliseconds
+const searchIndexUrl = 'https://docs.temba.io/search-index.json'
+
+async function ensureFreshIndex() {
+  if (Date.now() - lastFetched < CACHE_TTL && index.length > 0) return
 
-  // Fetch the index once on startup
-  let index = []
-  const searchIndexUrl = 'https://temba.bouwe.io/search-index.json'
   try {
     const response = await fetch(searchIndexUrl)
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status} ${response.statusText}`)
+    }
+
+    const contentType = response.headers.get('content-type') || ''
+    if (!contentType.includes('application/json')) {
+      throw new Error(`Expected JSON, received ${contentType || 'unknown content type'}`)
+    }
+
     index = await response.json()
+    lastFetched = Date.now()
   } catch (e) {
-    console.error('Failed to fetch ' + searchIndexUrl, e)
+    console.error('Refresh failed, using stale index:', e)
   }
+}
+
+export const startMcpServer = async () => {
+  const server = new McpServer({
+    name: 'temba-docs-mcp',
+    version,
+  })
 
   // Register the tool
   server.tool(
@@ -26,6 +42,7 @@ export const startMcpServer = async () => {
     'Search the library documentation',
     { query: z.string() },
     async ({ query }) => {
+      await ensureFreshIndex()
       const results = searchDocs(query, index).slice(0, 5) // Limit to top 5 results
 
       if (results.length === 0) {

package/src/searchDocs.js

@@ -0,0 +1,16 @@
+export const searchDocs = (query, index) => {
+  const lowerQuery = query?.toLowerCase().trim()
+
+  if (!lowerQuery) {
+    return []
+  }
+
+  return (
+    index?.filter(
+      (page) =>
+        page.content.toLowerCase().includes(lowerQuery) ||
+        page.title.toLowerCase().includes(lowerQuery) ||
+        (page.keywords && page.keywords.some((k) => k.toLowerCase().includes(lowerQuery))),
+    ) || []
+  )
+}

package/src/version.js

@@ -0,0 +1 @@
+export const version = '0.1.3'

package/searchDocs.js

@@ -1,9 +0,0 @@
-export const searchDocs = (query, index) => {
-  const lowerQuery = query.toLowerCase()
-  return index.filter(
-    (page) =>
-      page.content.toLowerCase().includes(lowerQuery) ||
-      page.title.toLowerCase().includes(lowerQuery) ||
-      (page.keywords && page.keywords.some((k) => k.toLowerCase().includes(lowerQuery))),
-  )
-}

package/version.js

@@ -1 +0,0 @@
-export const version = '0.1.2'