@vdpeijl/kb-mcp 0.1.2

package/README.md

@@ -0,0 +1,416 @@
+# @vdpeijl/kb-mcp
+
+MCP (Model Context Protocol) server that indexes multiple Zendesk Help Center knowledge bases and exposes them as searchable tools for AI coding assistants.
+
+## Features
+
+- 🔍 **Vector Search**: Semantic search using Ollama embeddings (nomic-embed-text)
+- 📚 **Multiple Sources**: Index and search across multiple Zendesk knowledge bases
+- 🔄 **Incremental Sync**: Efficient updates - only process changed articles
+- 🚀 **Easy Setup**: Interactive CLI wizard for first-time configuration
+- 🎯 **MCP Compatible**: Works with Claude Code, Cursor, Windsurf, Continue.dev, and Zed
+
+## Prerequisites
+
+### Node.js 20+
+
+Check your version:
+```bash
+node --version
+```
+
+If you need to install or update Node.js, visit [nodejs.org](https://nodejs.org)
+
+### Ollama
+
+Ollama is required for generating embeddings.
+
+**macOS:**
+```bash
+brew install ollama
+```
+
+**Linux:**
+```bash
+curl -fsSL https://ollama.com/install.sh | sh
+```
+
+**Arch Linux:**
+```bash
+pacman -S ollama
+```
+
+**Start Ollama and pull the embedding model:**
+```bash
+ollama serve &
+ollama pull nomic-embed-text
+```
+
+## Installation
+
+### From npm (once published)
+
+```bash
+npm install -g @vdpeijl/kb-mcp
+```
+
+### From source (during development)
+
+```bash
+git clone https://github.com/paragin/kb-mcp.git
+cd kb-mcp
+npm install
+npm run build
+npm link
+```
+
+## Quick Start
+
+### 1. Run interactive setup
+
+```bash
+kb-mcp init
+```
+
+This will:
+- Check if Ollama is running
+- Verify the embedding model is available
+- Help you add your first knowledge base
+- Create the configuration file
+
+### 2. Sync your knowledge base
+
+```bash
+kb-mcp sync
+```
+
+This will:
+- Fetch all articles from your Zendesk Help Center
+- Parse HTML content
+- Split into chunks (~500 tokens with overlap)
+- Generate embeddings using Ollama
+- Store in a local SQLite database with vector search
+
+### 3. Configure your MCP client
+
+```bash
+kb-mcp setup cursor    # or: claude-code, windsurf, continue, zed
+```
+
+Copy the printed configuration to your MCP client's config file.
+
+### 4. Restart your MCP client
+
+The knowledge base will now be available for search!
+
+## Commands
+
+### `kb-mcp init`
+
+Interactive setup wizard. Creates configuration and helps you add your first knowledge base.
+
+### `kb-mcp sync`
+
+Sync all enabled knowledge bases. Only processes articles that have changed since the last sync.
+
+**Options:**
+- `--source <id>` - Sync specific source only
+- `--full` - Full re-sync (re-embed everything)
+
+**Examples:**
+```bash
+kb-mcp sync                    # Sync all enabled sources
+kb-mcp sync --source myco      # Sync specific source
+kb-mcp sync --full             # Full re-sync
+```
+
+### `kb-mcp sources`
+
+Manage knowledge base sources.
+
+**Subcommands:**
+- `list` - List all sources with stats (default)
+- `add` - Add a new source (interactive or with flags)
+- `remove <id>` - Remove a source and its data
+- `enable <id>` - Enable a disabled source
+- `disable <id>` - Disable without removing data
+
+**Examples:**
+```bash
+kb-mcp sources                                    # List all sources
+kb-mcp sources add                                # Interactive add
+kb-mcp sources add --id myco --name "My Company" --url https://support.myco.com --locale en-us
+kb-mcp sources remove myco                        # Remove source
+kb-mcp sources disable myco                       # Disable source
+kb-mcp sources enable myco                        # Enable source
+```
+
+### `kb-mcp serve`
+
+Start the MCP server (stdio). This is normally called by your MCP client, not manually.
+
+### `kb-mcp setup [client]`
+
+Print MCP client configuration. Supports: claude-code, cursor, windsurf, continue, zed.
+
+**Examples:**
+```bash
+kb-mcp setup              # List all clients
+kb-mcp setup cursor       # Show config for Cursor
+```
+
+### `kb-mcp doctor`
+
+Run diagnostics to check:
+- Node.js version
+- Configuration validity
+- Ollama connection
+- Embedding model availability
+- Database accessibility
+- sqlite-vec extension
+
+### `kb-mcp stats`
+
+Show database statistics:
+- Total sources, articles, chunks
+- Database file size
+- Per-source breakdown
+
+## MCP Client Configuration
+
+### Claude Code
+
+Add to `~/.claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "knowledge-base": {
+      "command": "kb-mcp",
+      "args": ["serve"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Go to **Settings → Features → MCP Servers**, then add:
+
+```json
+{
+  "mcpServers": {
+    "knowledge-base": {
+      "command": "kb-mcp",
+      "args": ["serve"]
+    }
+  }
+}
+```
+
+### Windsurf
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "knowledge-base": {
+      "command": "kb-mcp",
+      "args": ["serve"]
+    }
+  }
+}
+```
+
+### Continue.dev
+
+Add to `~/.continue/config.json`:
+
+```json
+{
+  "experimental": {
+    "modelContextProtocolServers": [
+      {
+        "transport": {
+          "type": "stdio",
+          "command": "kb-mcp",
+          "args": ["serve"]
+        }
+      }
+    ]
+  }
+}
+```
+
+### Zed
+
+Add to `~/.config/zed/settings.json`:
+
+```json
+{
+  "context_servers": {
+    "knowledge-base": {
+      "command": {
+        "path": "kb-mcp",
+        "args": ["serve"]
+      }
+    }
+  }
+}
+```
+
+## MCP Tools
+
+The server exposes two tools to MCP clients:
+
+### `search_knowledge_base`
+
+Search the knowledge base for documentation, guides, and help articles.
+
+**Parameters:**
+- `query` (required): Natural language search query
+- `sources` (optional): Filter by source IDs (array of strings)
+- `limit` (optional): Maximum results (default: 5, max: 20)
+
+**Example usage in Claude Code:**
+> "Search the knowledge base for how to create a new user account"
+
+### `list_sources`
+
+List all configured knowledge base sources and their sync status.
+
+**Example usage in Claude Code:**
+> "List available knowledge bases"
+
+## Configuration
+
+Configuration is stored in XDG-compliant locations:
+
+- **Config**: `~/.config/kb-mcp/config.json`
+- **Data**: `~/.local/share/kb-mcp/kb.sqlite`
+- **Logs**: `~/.local/share/kb-mcp/logs/`
+
+On Windows, these paths use `%APPDATA%` and `%LOCALAPPDATA%` instead.
+
+### Config file structure
+
+```json
+{
+  "ollama": {
+    "baseUrl": "http://localhost:11434",
+    "model": "nomic-embed-text"
+  },
+  "sync": {
+    "chunkSize": 500,
+    "chunkOverlap": 50
+  },
+  "sources": [
+    {
+      "id": "myco",
+      "name": "My Company",
+      "baseUrl": "https://support.myco.com",
+      "locale": "en-us",
+      "enabled": true
+    }
+  ]
+}
+```
+
+## Debug Logging
+
+Enable debug logging with the `DEBUG` environment variable:
+
+```bash
+DEBUG=kb-mcp:* kb-mcp sync
+```
+
+Available namespaces:
+- `kb-mcp:sync` - Sync operations
+- `kb-mcp:embed` - Embedding generation
+- `kb-mcp:search` - Search operations
+- `kb-mcp:mcp` - MCP server
+- `kb-mcp:db` - Database operations
+- `kb-mcp:cli` - CLI commands
+
+## Troubleshooting
+
+### Cannot connect to Ollama
+
+Make sure Ollama is running:
+```bash
+ollama serve
+```
+
+Check if it's accessible:
+```bash
+curl http://localhost:11434/api/tags
+```
+
+### Model not found
+
+Pull the embedding model:
+```bash
+ollama pull nomic-embed-text
+```
+
+### sqlite-vec extension not loaded
+
+Try reinstalling:
+```bash
+npm install -g @vdpeijl/kb-mcp --force
+```
+
+Or manually download from: https://github.com/asg017/sqlite-vec/releases
+
+### Rate limited by Zendesk
+
+The sync process includes exponential backoff for rate limiting. If you're still hitting limits, try:
+- Syncing one source at a time: `kb-mcp sync --source <id>`
+- Waiting a few minutes between syncs
+
+## Testing
+
+### Test MCP server with Inspector
+
+```bash
+npx @modelcontextprotocol/inspector kb-mcp serve
+```
+
+This opens a web interface where you can:
+- See available tools
+- Call tools with test queries
+- Inspect responses
+
+## Development
+
+### Publishing a new version
+
+This project uses GitHub Actions to automatically publish to npm when the version changes in `package.json`.
+
+To release a new version:
+
+```bash
+# Bump version (choose one)
+npm version patch  # Bug fixes (0.1.0 → 0.1.1)
+npm version minor  # New features (0.1.0 → 0.2.0)
+npm version major  # Breaking changes (0.1.0 → 1.0.0)
+
+# Push to GitHub (this triggers the publish workflow)
+git push origin main --follow-tags
+```
+
+The GitHub Action will automatically:
+- Build the project
+- Publish to npm
+- Create a GitHub release
+
+See [.github/workflows/README.md](.github/workflows/README.md) for setup instructions.
+
+## License
+
+MIT
+
+## Author
+
+vdpeijl

package/dist/scripts/postinstall.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=postinstall.d.ts.map

package/dist/scripts/postinstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.d.ts","sourceRoot":"","sources":["../../scripts/postinstall.ts"],"names":[],"mappings":""}

package/dist/scripts/postinstall.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+import { mkdir, chmod } from 'node:fs/promises';
+import { get } from 'node:https';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createGunzip } from 'node:zlib';
+import { extract } from 'tar';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const SQLITE_VEC_VERSION = '0.1.6';
+// Map platform to archive name and extracted file
+const PLATFORM_MAP = {
+    'darwin-arm64': {
+        archive: 'sqlite-vec-0.1.6-loadable-macos-aarch64.tar.gz',
+        file: 'vec0.dylib',
+    },
+    'darwin-x64': {
+        archive: 'sqlite-vec-0.1.6-loadable-macos-x86_64.tar.gz',
+        file: 'vec0.dylib',
+    },
+    'linux-x64': {
+        archive: 'sqlite-vec-0.1.6-loadable-linux-x86_64.tar.gz',
+        file: 'vec0.so',
+    },
+    'win32-x64': {
+        archive: 'sqlite-vec-0.1.6-loadable-windows-x86_64.tar.gz',
+        file: 'vec0.dll',
+    },
+};
+function getPlatformKey() {
+    const platform = process.platform;
+    const arch = process.arch;
+    return `${platform}-${arch}`;
+}
+function downloadAndExtract(url, dest) {
+    return new Promise((resolve, reject) => {
+        get(url, (response) => {
+            // Handle redirects
+            if (response.statusCode === 302 || response.statusCode === 301) {
+                const redirectUrl = response.headers.location;
+                if (!redirectUrl) {
+                    reject(new Error('Redirect without location header'));
+                    return;
+                }
+                // Recursively handle redirect
+                downloadAndExtract(redirectUrl, dest).then(resolve).catch(reject);
+                return;
+            }
+            if (response.statusCode !== 200) {
+                reject(new Error(`Failed to download: HTTP ${response.statusCode}`));
+                return;
+            }
+            // Create gunzip stream
+            const gunzip = createGunzip();
+            // Create tar extract stream
+            const extractor = extract({
+                cwd: dest,
+                strip: 0, // Don't strip directories
+            });
+            // Pipe the response through gunzip and tar extract
+            response
+                .pipe(gunzip)
+                .pipe(extractor)
+                .on('finish', () => resolve())
+                .on('error', (err) => reject(err));
+        }).on('error', (err) => {
+            reject(err);
+        });
+    });
+}
+async function main() {
+    try {
+        const platformKey = getPlatformKey();
+        const platformInfo = PLATFORM_MAP[platformKey];
+        if (!platformInfo) {
+            throw new Error(`Unsupported platform: ${platformKey}. ` +
+                `Supported platforms: ${Object.keys(PLATFORM_MAP).join(', ')}`);
+        }
+        const { archive, file } = platformInfo;
+        const url = `https://github.com/asg017/sqlite-vec/releases/download/v${SQLITE_VEC_VERSION}/${archive}`;
+        const nativeDir = join(__dirname, '..', 'native');
+        console.log(`Downloading sqlite-vec for ${platformKey}...`);
+        console.log(`URL: ${url}`);
+        // Ensure native directory exists
+        await mkdir(nativeDir, { recursive: true });
+        // Download and extract
+        await downloadAndExtract(url, nativeDir);
+        // Verify the file exists
+        const extractedFile = join(nativeDir, file);
+        console.log(`✓ sqlite-vec extracted to ${extractedFile}`);
+        // Make executable on Unix-like systems
+        if (process.platform !== 'win32') {
+            await chmod(extractedFile, 0o755);
+        }
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(`✗ Failed to download sqlite-vec: ${error.message}`);
+            // Don't fail installation, just warn
+            console.warn('⚠ sqlite-vec extension not installed. You may need to manually download it.');
+            console.warn(`  Visit: https://github.com/asg017/sqlite-vec/releases/tag/v${SQLITE_VEC_VERSION}`);
+        }
+        else {
+            console.error('✗ Unknown error during postinstall');
+        }
+        // Exit with 0 to not break npm install
+        process.exit(0);
+    }
+}
+main();
+//# sourceMappingURL=postinstall.js.map

package/dist/scripts/postinstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.js","sourceRoot":"","sources":["../../scripts/postinstall.ts"],"names":[],"mappings":"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"}

package/dist/src/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/src/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":""}

package/dist/src/cli.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import { defineCommand, runMain } from 'citty';
+import { exitWithError } from './utils/errors.js';
+const main = defineCommand({
+    meta: {
+        name: 'kb-mcp',
+        version: '0.1.0',
+        description: 'MCP server for searching Zendesk knowledge bases',
+    },
+    subCommands: {
+        serve: () => import('./commands/serve.js').then(m => m.default),
+        init: () => import('./commands/init.js').then(m => m.default),
+        sync: () => import('./commands/sync.js').then(m => m.default),
+        sources: () => import('./commands/sources.js').then(m => m.default),
+        setup: () => import('./commands/setup.js').then(m => m.default),
+        doctor: () => import('./commands/doctor.js').then(m => m.default),
+        stats: () => import('./commands/stats.js').then(m => m.default),
+    },
+});
+// Run CLI
+runMain(main).catch(exitWithError);
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,IAAI,GAAG,aAAa,CAAC;IACzB,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,kDAAkD;KAChE;IACD,WAAW,EAAE;QACX,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC/D,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC7D,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC7D,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QACnE,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC/D,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QACjE,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;KAChE;CACF,CAAC,CAAC;AAEH,UAAU;AACV,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC"}

package/dist/src/commands/doctor.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("citty").CommandDef<import("citty").ArgsDef>;
+export default _default;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/src/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor.ts"],"names":[],"mappings":";AAMA,wBA2FG"}

package/dist/src/commands/doctor.js

@@ -0,0 +1,93 @@
+import { defineCommand } from 'citty';
+import { getDatabase } from '../db/index.js';
+import { checkOllamaConnection, checkModelAvailable } from '../search/embeddings.js';
+import { configExists, loadConfig } from '../config/index.js';
+import { exitWithError } from '../utils/errors.js';
+export default defineCommand({
+    meta: {
+        name: 'doctor',
+        description: 'Check system requirements and configuration',
+    },
+    async run() {
+        try {
+            console.log('\n🏥 Running diagnostics...\n');
+            let allGood = true;
+            // Check Node.js version
+            const nodeVersion = process.version;
+            const majorVersion = parseInt(nodeVersion.slice(1).split('.')[0]);
+            if (majorVersion >= 20) {
+                console.log(`✓ Node.js ${nodeVersion} (>= 20.0.0)`);
+            }
+            else {
+                console.log(`✗ Node.js ${nodeVersion} (requires >= 20.0.0)`);
+                allGood = false;
+            }
+            // Check config exists
+            if (configExists()) {
+                console.log('✓ Configuration file exists');
+                try {
+                    const config = await loadConfig();
+                    console.log('✓ Configuration is valid');
+                    // Check Ollama connection
+                    const ollamaConnected = await checkOllamaConnection(config.ollama);
+                    if (ollamaConnected) {
+                        console.log(`✓ Ollama running at ${config.ollama.baseUrl}`);
+                        // Check model available
+                        const modelAvailable = await checkModelAvailable(config.ollama);
+                        if (modelAvailable) {
+                            console.log(`✓ Model '${config.ollama.model}' available`);
+                        }
+                        else {
+                            console.log(`✗ Model '${config.ollama.model}' not found`);
+                            console.log(`\n  Pull it with:`);
+                            console.log(`    ollama pull ${config.ollama.model}\n`);
+                            allGood = false;
+                        }
+                    }
+                    else {
+                        console.log(`✗ Cannot connect to Ollama at ${config.ollama.baseUrl}`);
+                        console.log(`\n  Make sure Ollama is running:`);
+                        console.log(`    ollama serve\n`);
+                        allGood = false;
+                    }
+                }
+                catch (error) {
+                    console.log(`✗ Configuration error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                    allGood = false;
+                }
+            }
+            else {
+                console.log('✗ Configuration file not found');
+                console.log(`\n  Run 'kb-mcp init' to create configuration\n`);
+                allGood = false;
+            }
+            // Check database
+            try {
+                const db = await getDatabase();
+                console.log('✓ Database accessible');
+                // Check sqlite-vec extension
+                const versionQuery = db.prepare('SELECT vec_version() as version');
+                const result = versionQuery.get();
+                console.log(`✓ sqlite-vec extension loaded (v${result.version})`);
+            }
+            catch (error) {
+                console.log('✗ Database error');
+                console.log(`\n  ${error instanceof Error ? error.message : 'Unknown error'}\n`);
+                allGood = false;
+            }
+            console.log();
+            if (allGood) {
+                console.log('✅ All checks passed!\n');
+                process.exit(0);
+            }
+            else {
+                console.log('⚠️  Some checks failed. Please fix the issues above.\n');
+                process.exit(1);
+            }
+        }
+        catch (error) {
+            exitWithError(error);
+        }
+    },
+});
+//# sourceMappingURL=doctor.js.map

package/dist/src/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/commands/doctor.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/init.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("citty").CommandDef<import("citty").ArgsDef>;
+export default _default;
+//# sourceMappingURL=init.d.ts.map