temba-mcp 0.1.3 → 0.3.0

package/package.json

@@ -1,23 +1,25 @@
 {
   "name": "temba-mcp",
-  "version": "0.1.3",
+  "version": "0.3.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/src/cli.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { startMcpServer } from './mcp.js'
+
+const args = process.argv.slice(2)
+const isDebug = args.includes('--debug')
+
+if (isDebug) {
+  console.error('✨ Temba Docs MCP running in DEBUG mode')
+}
+
+startMcpServer({ debug: isDebug }).catch(console.error)

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

@@ -4,15 +4,22 @@ 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,
-  })
+const LOG_FILE = path.join(process.cwd(), 'temba-mcp.log')
+
+function log(message) {
+  const timestamp = new Date().toISOString()
+  const entry = `[${timestamp}] ${message}\n`
+  fs.appendFileSync(LOG_FILE, entry)
+}
+
+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) {
@@ -25,9 +32,17 @@ export const startMcpServer = async () => {
     }
 
     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 ({ debug = false } = {}) => {
+  const server = new McpServer({
+    name: 'temba-docs-mcp',
+    version,
+  })
 
   // Register the tool
   server.tool(
@@ -35,8 +50,13 @@ 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 (debug) {
+        log(`Query: "${query}" | Results: ${results.length}`)
+      }
+
       if (results.length === 0) {
         return {
           content: [{ type: 'text', text: 'No documentation found for your query.' }],

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/cli.js

@@ -1,6 +0,0 @@
-#!/usr/bin/env node
-import { startMcpServer } from './mcp.js'
-
-console.error('✨ Temba Docs MCP starting...')
-
-startMcpServer().catch(console.error)

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))),
-  )
-}