@contiva/sapbtp-docs-mcp 1.0.1

package/README.md

@@ -0,0 +1,386 @@
+# SAP Business Technology Platform Documentation MCP Server
+
+> **Bring the entire SAP Business Technology Platform documentation directly into Claude Desktop** - search, explore, and get instant answers without leaving your AI assistant.
+
+[![npm version](https://img.shields.io/npm/v/@contiva/sapbtp-docs-mcp)](https://www.npmjs.com/package/@contiva/sapbtp-docs-mcp)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
+
+## What is this?
+
+This MCP (Model Context Protocol) server gives Claude Desktop instant access to **3,500+ SAP Business Technology Platform documentation pages**, including:
+
+- 📘 **SAP Business Technology Platform** - Complete platform documentation
+- 🔌 **Cloud Integration** - Integration flows, adapters, security
+- 🚀 **API Management** - API proxies, policies, analytics
+
+**No more switching between browser tabs.** Ask Claude about SAP Business Technology Platform directly in your conversation.
+
+---
+
+## Quick Start (2 minutes)
+
+### Step 1: Install via Claude Desktop Config
+
+Add this to your Claude Desktop configuration:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "sapis-docs": {
+      "command": "npx",
+      "args": ["@contiva/sapbtp-docs-mcp"]
+    }
+  }
+}
+```
+
+### Step 2: Restart Claude Desktop
+
+That's it! On first launch, the documentation (~50MB) downloads automatically in 1-2 minutes.
+
+### Step 3: Start asking questions
+
+Try these in Claude:
+
+> "Search for OAuth 2.0 authentication in API Management"
+
+> "Show me how to configure CSRF protection in Cloud Integration"
+
+> "What are the best practices for error handling in integration flows?"
+
+---
+
+## Why Use This?
+
+### ✅ **Instant, Context-Aware Answers**
+Instead of searching through help.sap.com manually, Claude can:
+- Search across all documentation instantly
+- Understand your question contextually
+- Combine information from multiple articles
+- Give you step-by-step guidance based on official docs
+
+### ✅ **Three Powerful Search Methods**
+- **Full-text search** - Find anything in 3,500+ pages
+- **Title-based search** - Fast fuzzy matching for quick lookups
+- **Semantic search** - AI understands what you mean, not just keywords
+
+### ✅ **Works Offline**
+All documentation and AI embeddings run locally. No API keys needed, no data leaves your machine.
+
+---
+
+## Real-World Examples
+
+### Example 1: Learning a New Feature
+
+**You:**
+> "I need to set up OAuth 2.0 authentication for my API proxy. Show me the steps."
+
+**Claude (with MCP):**
+> I'll search the API Management documentation for OAuth 2.0 setup...
+>
+> Based on the official documentation, here are the steps to configure OAuth 2.0:
+>
+> 1. Create an OAuth 2.0 Provider in API Management
+> 2. Configure the Token Endpoint...
+> [Complete step-by-step guide with exact configuration]
+
+---
+
+### Example 2: Troubleshooting
+
+**You:**
+> "My integration flow is failing with a CSRF token error. How do I fix this?"
+
+**Claude (with MCP):**
+> Let me search for CSRF protection documentation in Cloud Integration...
+>
+> The error occurs because Cloud Integration requires CSRF tokens for state-changing operations. Here's how to configure it:
+>
+> [Specific troubleshooting steps from the docs]
+
+---
+
+### Example 3: Architecture Decisions
+
+**You:**
+> "What's the difference between Basic Authentication and OAuth in SAP Cloud Integration?"
+
+**Claude (with MCP):**
+> I'll compare both authentication methods from the documentation...
+>
+> **Basic Authentication:**
+> - Use case: [from docs]
+> - Security considerations: [from docs]
+>
+> **OAuth 2.0:**
+> - Use case: [from docs]
+> - Security considerations: [from docs]
+>
+> **Recommendation:** [Based on official SAP guidance]
+
+---
+
+## Features in Detail
+
+### 🔍 Smart Search Capabilities
+
+```
+Claude can now:
+├─ Search by keywords (full-text)
+├─ Search by topic titles (fuzzy matching)
+├─ Search by meaning (semantic AI search)
+└─ Combine all three for best results
+```
+
+### 📚 Complete Documentation Coverage
+
+- **1,980 files** - Integration Suite main docs
+- **1,175 files** - Cloud Integration specifics
+- **312 files** - API Management guides
+- Automatically updated from [SAP's official repository](https://github.com/SAP-docs/btp-cloud-platform)
+
+### ⚡ Performance
+
+- **Startup**: < 1 second
+- **Search**: 100-200ms for full-text, 500ms for semantic
+- **Memory**: ~50-65MB total
+- **First-time setup**: 1-2 minutes (one-time documentation download)
+
+### 🔒 Privacy-First
+
+- **100% local** - All AI embeddings run on your machine
+- **No API keys** - No external services required
+- **No data sharing** - Your queries stay private
+
+---
+
+## Available Commands
+
+Once installed, Claude can use these tools automatically:
+
+### 🔍 search_documentation
+Search across all documentation with combined search methods.
+
+**Example questions:**
+- "Search for SAML authentication"
+- "Find documentation about message mapping"
+- "Show me API proxy configuration examples"
+
+---
+
+### 📖 read_article
+Read complete documentation articles.
+
+**Example questions:**
+- "Read the full article about OAuth configuration"
+- "Show me the complete guide for CSRF protection"
+
+---
+
+### 📑 list_topics
+Browse documentation structure hierarchically.
+
+**Example questions:**
+- "List all Cloud Integration topics"
+- "Show me the table of contents for API Management"
+
+---
+
+### 🔗 get_related_articles
+Find related documentation automatically.
+
+**Example questions:**
+- "What else should I read about authentication?"
+- "Find related articles to this integration flow guide"
+
+---
+
+## Advanced Configuration
+
+### Custom Documentation Path
+
+If you cloned the SAP docs repository locally:
+
+```json
+{
+  "mcpServers": {
+    "sapis-docs": {
+      "command": "npx",
+      "args": ["@contiva/sapbtp-docs-mcp"],
+      "env": {
+        "MCP_DOCS_PATH": "/path/to/btp-integration-suite/docs"
+      }
+    }
+  }
+}
+```
+
+### Cloud Embeddings (Optional)
+
+For faster initial indexing, use cloud-based embeddings:
+
+```json
+{
+  "mcpServers": {
+    "sapis-docs": {
+      "command": "npx",
+      "args": ["@contiva/sapbtp-docs-mcp"],
+      "env": {
+        "EMBEDDING_PROVIDER": "voyage",
+        "VOYAGE_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+**Note:** Local embeddings (default) are free and work offline. Cloud embeddings reduce first-time indexing from 10-15 minutes to 2-3 minutes but require an API key.
+
+---
+
+## Troubleshooting
+
+### "Documentation not found" error
+
+The first run downloads docs automatically. If it fails:
+
+```bash
+# Manual installation
+git clone https://github.com/SAP-docs/btp-cloud-platform.git
+export MCP_DOCS_PATH=/path/to/btp-integration-suite/docs
+```
+
+Then restart Claude Desktop.
+
+### MCP server not showing up
+
+1. Check your config file path is correct
+2. Ensure JSON syntax is valid (use a JSON validator)
+3. Restart Claude Desktop completely
+4. Check Claude Desktop logs for errors
+
+### Slow semantic search
+
+First-time semantic search builds an AI index (10-15 minutes with local embeddings). This is one-time only - subsequent searches are instant.
+
+---
+
+## Development
+
+### Local Development Setup
+
+```bash
+# Clone the MCP server
+git clone https://github.com/robertfels/sapbtp-docs-mcp.git
+cd sapbtp-docs-mcp
+
+# Clone SAP docs (or it downloads automatically)
+git clone https://github.com/SAP-docs/btp-cloud-platform.git
+
+# Install and build
+npm install
+npm run build
+
+# Test locally
+npm start
+```
+
+### Publishing Updates
+
+```bash
+npm version patch
+npm publish --otp=<your-2fa-code>
+```
+
+---
+
+## How It Works
+
+```
+┌─────────────────┐
+│  Claude Desktop │
+│                 │
+│  "Search for    │
+│   OAuth in      │
+│   API Mgmt"     │
+└────────┬────────┘
+         │
+         │ MCP Protocol
+         ▼
+┌─────────────────────────────────┐
+│  @contiva/sapbtp-docs-mcp        │
+│                                 │
+│  ┌───────────┐  ┌────────────┐ │
+│  │ Full-text │  │   Title    │ │
+│  │  Search   │  │   Search   │ │
+│  └───────────┘  └────────────┘ │
+│                                 │
+│  ┌───────────────────────────┐ │
+│  │   Semantic AI Search      │ │
+│  │   (Local Embeddings)      │ │
+│  └───────────────────────────┘ │
+│                                 │
+│  ┌───────────────────────────┐ │
+│  │  3,500+ Markdown Files    │ │
+│  │  (Downloaded from SAP)    │ │
+│  └───────────────────────────┘ │
+└─────────────────────────────────┘
+```
+
+---
+
+## Related Projects
+
+- [Model Context Protocol](https://modelcontextprotocol.io/) - Open protocol for AI-tool integration
+- [SAP Business Technology Platform Docs](https://github.com/SAP-docs/btp-cloud-platform) - Official SAP documentation repository
+- [Claude Desktop](https://claude.ai/download) - AI assistant with MCP support
+
+---
+
+## Contributing to SAP Documentation
+
+Found an error in the SAP documentation? You can contribute!
+
+This MCP server uses the official [SAP Business Technology Platform documentation repository](https://github.com/SAP-docs/btp-cloud-platform). All contributions to the documentation should be made there.
+
+### How to Contribute
+
+1. Open the relevant guide on [SAP Help Portal](https://help.sap.com/docs/SAP_INTEGRATION_SUITE)
+2. Choose **Feedback** > **Edit page** to suggest changes
+3. Or choose **Feedback** > **Create issue** to report problems
+
+See [SAP's Contribution Guidelines](https://help.sap.com/products/open-documentation-initiative/contribution-guidelines/readme.html) for more details.
+
+### Covered Documentation Areas
+
+| Guide | Description |
+|:---|:---|
+| [SAP Business Technology Platform](https://help.sap.com/docs/SAP_INTEGRATION_SUITE/51ab953548be4459bfe8539ecaeee98d/5cc6987511104c418b7cb4c25f3d9cb0.html?version=CLOUD) | Platform overview and general capabilities |
+| [SAP API Management](https://help.sap.com/docs/sap-api-management/sap-api-management/sap-api-management-in-cloud-foundry-environment?version=Cloud) | API proxies, policies, and analytics |
+| [SAP Cloud Integration](https://help.sap.com/docs/cloud-integration/sap-cloud-integration/sap-cloud-integration) | Integration flows, adapters, and security |
+
+---
+
+## License
+
+This MCP server is licensed under [Apache-2.0](LICENSE).
+
+The SAP documentation content is subject to SAP's licensing terms. See the [SAP documentation repository](https://github.com/SAP-docs/btp-cloud-platform) for details.
+
+---
+
+## Support
+
+- **Issues**: [GitHub Issues](https://github.com/robertfels/sapbtp-docs-mcp/issues)
+- **NPM Package**: [@contiva/sapbtp-docs-mcp](https://www.npmjs.com/package/@contiva/sapbtp-docs-mcp)
+- **SAP Documentation**: [help.sap.com](https://help.sap.com/docs/SAP_INTEGRATION_SUITE)
+
+---
+
+**Made with ❤️ for the SAP Business Technology Platform community**
+
+[![REUSE status](https://api.reuse.software/badge/github.com/SAP-docs/btp-cloud-platform)](https://api.reuse.software/info/github.com/SAP-docs/btp-cloud-platform)

package/build/cache/embedding-cache.d.ts

@@ -0,0 +1,39 @@
+import type { EmbeddingCacheData, EmbeddingProvider } from '../types/index.js';
+/**
+ * Persistent cache for document embeddings
+ */
+export declare class EmbeddingCache {
+    private cachePath;
+    private cacheDir;
+    private version;
+    constructor();
+    /**
+     * Loads embeddings from cache file
+     */
+    load(): Promise<EmbeddingCacheData | null>;
+    /**
+     * Saves embeddings to cache file
+     */
+    save(data: EmbeddingCacheData): Promise<void>;
+    /**
+     * Checks if the cache is valid for a given provider
+     */
+    isValid(provider: EmbeddingProvider, model: string): Promise<boolean>;
+    /**
+     * Gets the cache file size in MB
+     */
+    getSize(): Promise<number>;
+    /**
+     * Deletes the cache file
+     */
+    clear(): Promise<void>;
+    /**
+     * Checks if cache exists
+     */
+    exists(): boolean;
+    /**
+     * Gets cache file path
+     */
+    getPath(): string;
+}
+//# sourceMappingURL=embedding-cache.d.ts.map

package/build/cache/embedding-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-cache.d.ts","sourceRoot":"","sources":["../../src/cache/embedding-cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG/E;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAmB;;IAOlC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAsBhD;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBnD;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAY3E;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAahC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,OAAO,IAAI,MAAM;CAGlB"}

package/build/cache/embedding-cache.js

@@ -0,0 +1,105 @@
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { resolveCacheDir } from '../utils/paths.js';
+/**
+ * Persistent cache for document embeddings
+ */
+export class EmbeddingCache {
+    cachePath;
+    cacheDir;
+    version = '1.0.0';
+    constructor() {
+        this.cacheDir = resolveCacheDir();
+        this.cachePath = join(this.cacheDir, 'embeddings.json');
+    }
+    /**
+     * Loads embeddings from cache file
+     */
+    async load() {
+        if (!existsSync(this.cachePath)) {
+            return null;
+        }
+        try {
+            const content = await readFile(this.cachePath, 'utf-8');
+            const data = JSON.parse(content);
+            // Validate cache version
+            if (data.version !== this.version) {
+                console.error(`Embedding cache version mismatch. Expected ${this.version}, got ${data.version}. Rebuilding...`);
+                return null;
+            }
+            return data;
+        }
+        catch (error) {
+            console.error('Error loading embedding cache:', error);
+            return null;
+        }
+    }
+    /**
+     * Saves embeddings to cache file
+     */
+    async save(data) {
+        try {
+            // Ensure cache directory exists
+            await mkdir(this.cacheDir, { recursive: true });
+            // Write to file
+            const content = JSON.stringify(data, null, 2);
+            await writeFile(this.cachePath, content, 'utf-8');
+            console.error(`Embedding cache saved: ${data.embeddings.length} embeddings`);
+        }
+        catch (error) {
+            console.error('Error saving embedding cache:', error);
+            throw error;
+        }
+    }
+    /**
+     * Checks if the cache is valid for a given provider
+     */
+    async isValid(provider, model) {
+        const data = await this.load();
+        if (!data) {
+            return false;
+        }
+        return data.version === this.version &&
+            data.provider === provider &&
+            data.model === model;
+    }
+    /**
+     * Gets the cache file size in MB
+     */
+    async getSize() {
+        if (!existsSync(this.cachePath)) {
+            return 0;
+        }
+        try {
+            const stats = await import('fs/promises').then(fs => fs.stat(this.cachePath));
+            return stats.size / (1024 * 1024); // Convert to MB
+        }
+        catch (error) {
+            return 0;
+        }
+    }
+    /**
+     * Deletes the cache file
+     */
+    async clear() {
+        if (existsSync(this.cachePath)) {
+            const { unlink } = await import('fs/promises');
+            await unlink(this.cachePath);
+            console.error('Embedding cache cleared');
+        }
+    }
+    /**
+     * Checks if cache exists
+     */
+    exists() {
+        return existsSync(this.cachePath);
+    }
+    /**
+     * Gets cache file path
+     */
+    getPath() {
+        return this.cachePath;
+    }
+}
+//# sourceMappingURL=embedding-cache.js.map

package/build/cache/embedding-cache.js.map

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

package/build/cache/file-cache.d.ts

@@ -0,0 +1,40 @@
+import type { ParsedDocument, CacheStats } from '../types/index.js';
+/**
+ * LRU Cache for parsed documents
+ */
+export declare class FileCache {
+    private cache;
+    private maxSize;
+    private hits;
+    private misses;
+    constructor(maxSize?: number);
+    /**
+     * Gets a parsed document from cache or parses it
+     */
+    get(filePath: string): Promise<ParsedDocument>;
+    /**
+     * Sets a parsed document in the cache
+     */
+    set(filePath: string, document: ParsedDocument): Promise<void>;
+    /**
+     * Checks if a file is in the cache and up-to-date
+     */
+    has(filePath: string): Promise<boolean>;
+    /**
+     * Clears the entire cache
+     */
+    clear(): void;
+    /**
+     * Removes a specific file from cache
+     */
+    invalidate(filePath: string): void;
+    /**
+     * Gets cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Gets cache hit rate as a percentage
+     */
+    getHitRate(): number;
+}
+//# sourceMappingURL=file-cache.d.ts.map

package/build/cache/file-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cache.d.ts","sourceRoot":"","sources":["../../src/cache/file-cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAc,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGhF;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAsD;IACnE,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAa;gBAEf,OAAO,GAAE,MAAY;IAIjC;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA+BpD;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BpE;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB7C;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACH,QAAQ,IAAI,UAAU;IAStB;;OAEG;IACH,UAAU,IAAI,MAAM;CASrB"}