{"_id":"@contiva/sapbtp-docs-mcp","_rev":"9-6d854a4b19aca3d99935f7e87fa28a58","name":"@contiva/sapbtp-docs-mcp","dist-tags":{"latest":"1.0.6"},"versions":{"1.0.1":{"name":"@contiva/sapbtp-docs-mcp","version":"1.0.1","keywords":["mcp","sap","business-technology-platform","documentation","search","ai","claude"],"author":{"name":"Robert Fels"},"license":"Apache-2.0","_id":"@contiva/sapbtp-docs-mcp@1.0.1","maintainers":[{"name":"robertfels","email":"robert.fels@contiva.com"}],"homepage":"https://github.com/robertfels/sapbtp-docs-mcp#readme","bugs":{"url":"https://github.com/robertfels/sapbtp-docs-mcp/issues"},"bin":{"sapbtp-docs-mcp":"build/index.js"},"dist":{"shasum":"826dc01fd0a1a4247e866e89091bd1c3f7ea22d2","tarball":"https://registry.npmjs.org/@contiva/sapbtp-docs-mcp/-/sapbtp-docs-mcp-1.0.1.tgz","fileCount":91,"integrity":"sha512-zfxbFhYBkkq+IWy6WL4Bwd8PTCdaJvxy7etrlbN92DiQaIDiVDtzYIzJhQWiqXUUzH/geyE3+qw8Y5sXX93WuQ==","signatures":[{"sig":"MEQCIHH7nSB20riA/ZHUqzgNfsRJZkHPOkBor61p+rUpKq3nAiBpgQPKr+yPQFZkfknxF0TEJDhUI6jQhoXAPKtx0osIUw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":237262},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18.0.0"},"scripts":{"dev":"tsc --watch","build":"tsc","start":"node ./build/index.js","prepare":"npm run build","prepublishOnly":"npm run build"},"_npmUser":{"name":"robertfels","email":"robert.fels@contiva.com"},"repository":{"url":"git+https://github.com/robertfels/sapbtp-docs-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for SAP Business Technology Platform documentation - enables AI assistants to search and navigate SAP Business Technology Platform docs","directories":{},"_nodeVersion":"24.4.1","dependencies":{"remark":"^15.0.1","remark-gfm":"^4.0.0","gray-matter":"^4.0.3","strip-markdown":"^6.0.0","@xenova/transformers":"^2.17.2","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"optionalDependencies":{"openai":"^4.77.0","voyageai":"^0.0.6"},"_npmOperationalInternal":{"tmp":"tmp/sapbtp-docs-mcp_1.0.1_1766392495847_0.943925921102911","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@contiva/sapbtp-docs-mcp","version":"1.0.2","keywords":["mcp","sap","business-technology-platform","documentation","search","ai","claude"],"author":{"name":"Robert Fels"},"license":"Apache-2.0","_id":"@contiva/sapbtp-docs-mcp@1.0.2","maintainers":[{"name":"robertfels","email":"robert.fels@contiva.com"}],"homepage":"https://github.com/robertfels/sapbtp-docs-mcp#readme","bugs":{"url":"https://github.com/robertfels/sapbtp-docs-mcp/issues"},"bin":{"sapbtp-docs-mcp":"build/index.js"},"dist":{"shasum":"53ca60ee6d765a6daa310fec80c4686a1038fa90","tarball":"https://registry.npmjs.org/@contiva/sapbtp-docs-mcp/-/sapbtp-docs-mcp-1.0.2.tgz","fileCount":91,"integrity":"sha512-/tp9qDB4eWRMtbX71Ie4Hqg08eCQeg83lUykYURLuEuMnOaXnsejjZxRky6mFOks3pBKcLC0WiS7T06ZLPo6IA==","signatures":[{"sig":"MEUCIQD5+nrTecRQFmEzF6cGI27HNyWoBnMFs6IN030v04j3/gIgEz2sIXBmY3q0iFT6TFKQFjfZRgQ54gGtMJ8TKO0/yXs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":235504},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18.0.0"},"scripts":{"dev":"tsc --watch","build":"tsc","start":"node ./build/index.js","prepare":"npm run build","prepublishOnly":"npm run build"},"_npmUser":{"name":"robertfels","email":"robert.fels@contiva.com"},"repository":{"url":"git+https://github.com/robertfels/sapbtp-docs-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for SAP Business Technology Platform documentation - enables AI assistants to search and navigate SAP Business Technology Platform docs","directories":{},"_nodeVersion":"24.4.1","dependencies":{"remark":"^15.0.1","remark-gfm":"^4.0.0","gray-matter":"^4.0.3","strip-markdown":"^6.0.0","@xenova/transformers":"^2.17.2","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"optionalDependencies":{"openai":"^4.77.0","voyageai":"^0.0.6"},"_npmOperationalInternal":{"tmp":"tmp/sapbtp-docs-mcp_1.0.2_1766393203500_0.590401875663991","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@contiva/sapbtp-docs-mcp","version":"1.0.3","keywords":["mcp","sap","business-technology-platform","documentation","search","ai","claude"],"author":{"name":"Robert Fels"},"license":"Apache-2.0","_id":"@contiva/sapbtp-docs-mcp@1.0.3","maintainers":[{"name":"robertfels","email":"robert.fels@contiva.com"}],"homepage":"https://github.com/robertfels/sapbtp-docs-mcp#readme","bugs":{"url":"https://github.com/robertfels/sapbtp-docs-mcp/issues"},"bin":{"sapbtp-docs-mcp":"build/index.js"},"dist":{"shasum":"7970dcc966627ee69cbd8a072648583d0cf27d6e","tarball":"https://registry.npmjs.org/@contiva/sapbtp-docs-mcp/-/sapbtp-docs-mcp-1.0.3.tgz","fileCount":91,"integrity":"sha512-8qleu058MUGRfuKXOQ4RXWufdQ7dMHwtHBsAcsMvTR9n/ZMJO4y3jlrtNO0fiA9pcTB0HtEx713ZYApejICLMw==","signatures":[{"sig":"MEYCIQDYCecokX0HhNYnhrNtyIkPdAJXO3PP0OSJswJooeh5JQIhAJKWCgDFFEcxcXVadKnJswbZydMJUxAz4bYMz04WXdK3","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":242955},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18.0.0"},"scripts":{"dev":"tsc --watch","build":"tsc","start":"node ./build/index.js","prepare":"npm run build","prepublishOnly":"npm run build"},"_npmUser":{"name":"robertfels","email":"robert.fels@contiva.com"},"repository":{"url":"git+https://github.com/robertfels/sapbtp-docs-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for SAP Business Technology Platform documentation - enables AI assistants to search and navigate SAP Business Technology Platform docs","directories":{},"_nodeVersion":"24.4.1","dependencies":{"remark":"^15.0.1","remark-gfm":"^4.0.0","gray-matter":"^4.0.3","strip-markdown":"^6.0.0","@xenova/transformers":"^2.17.2","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"optionalDependencies":{"openai":"^4.77.0","voyageai":"^0.0.6"},"_npmOperationalInternal":{"tmp":"tmp/sapbtp-docs-mcp_1.0.3_1766393531169_0.12853590321531505","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@contiva/sapbtp-docs-mcp","version":"1.0.4","keywords":["mcp","sap","business-technology-platform","documentation","search","ai","claude"],"author":{"name":"Robert Fels"},"license":"Apache-2.0","_id":"@contiva/sapbtp-docs-mcp@1.0.4","maintainers":[{"name":"robertfels","email":"robert.fels@contiva.com"}],"homepage":"https://github.com/robertfels/sapbtp-docs-mcp#readme","bugs":{"url":"https://github.com/robertfels/sapbtp-docs-mcp/issues"},"bin":{"sapbtp-docs-mcp":"build/index.js"},"dist":{"shasum":"d4ebee311c756e47b261a27f677e0c43e7b218f4","tarball":"https://registry.npmjs.org/@contiva/sapbtp-docs-mcp/-/sapbtp-docs-mcp-1.0.4.tgz","fileCount":91,"integrity":"sha512-aFqavRjarMGNvKcdnBdFWGhqJZi/nEqI0ku8OvYBWm2hUASrgUGIv553dwV3yrnID7XpbcHdoQ7hJlHswcDpdA==","signatures":[{"sig":"MEUCIHdLyAtwd1qCRuQdefch28YrlprbaGibtCMat12tUCjqAiEAv3hREFqSKgqshYAesaxdRbO9HtqUSx9lyStrKDdKFWU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":253232},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18.0.0"},"scripts":{"dev":"tsc --watch","build":"tsc","start":"node ./build/index.js","prepare":"npm run build","prepublishOnly":"npm run build"},"_npmUser":{"name":"robertfels","email":"robert.fels@contiva.com"},"repository":{"url":"git+https://github.com/robertfels/sapbtp-docs-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for SAP Business Technology Platform documentation - enables AI assistants to search and navigate SAP Business Technology Platform docs","directories":{},"_nodeVersion":"24.4.1","dependencies":{"remark":"^15.0.1","remark-gfm":"^4.0.0","gray-matter":"^4.0.3","strip-markdown":"^6.0.0","@xenova/transformers":"^2.17.2","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"optionalDependencies":{"openai":"^4.77.0","voyageai":"^0.0.6"},"_npmOperationalInternal":{"tmp":"tmp/sapbtp-docs-mcp_1.0.4_1766398870901_0.4564266542636837","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@contiva/sapbtp-docs-mcp","version":"1.0.5","keywords":["mcp","sap","business-technology-platform","documentation","search","ai","claude"],"author":{"name":"Robert Fels"},"license":"Apache-2.0","_id":"@contiva/sapbtp-docs-mcp@1.0.5","maintainers":[{"name":"robertfels","email":"robert.fels@contiva.com"}],"homepage":"https://github.com/robertfels/sapbtp-docs-mcp#readme","bugs":{"url":"https://github.com/robertfels/sapbtp-docs-mcp/issues"},"bin":{"sapbtp-docs-mcp":"build/index.js"},"dist":{"shasum":"c728b052faf4cde067f3b05d7fd41531f20946be","tarball":"https://registry.npmjs.org/@contiva/sapbtp-docs-mcp/-/sapbtp-docs-mcp-1.0.5.tgz","fileCount":91,"integrity":"sha512-CUTs/C++9U67lvW2GOwCSHjWk+h1Yj9XDWiSMfgFQuMIdHAsVMcyLExsNc7B4V2aThLBHHahr1DeeDgN3Fjczg==","signatures":[{"sig":"MEUCIQDKh5919U9LCtY+hvDfdsw5+4XoDvSoWPG/X71W7eh8wQIgeQtCt7J9KYr4bZMClkKi1TDoYGgFQMPo0wJWlYFA1yk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":254327},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18.0.0"},"scripts":{"dev":"tsc --watch","build":"tsc","start":"node ./build/index.js","prepare":"npm run build","prepublishOnly":"npm run build"},"_npmUser":{"name":"robertfels","email":"robert.fels@contiva.com"},"repository":{"url":"git+https://github.com/robertfels/sapbtp-docs-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for SAP Business Technology Platform documentation - enables AI assistants to search and navigate SAP Business Technology Platform docs","directories":{},"_nodeVersion":"24.4.1","dependencies":{"remark":"^15.0.1","remark-gfm":"^4.0.0","gray-matter":"^4.0.3","strip-markdown":"^6.0.0","@xenova/transformers":"^2.17.2","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"optionalDependencies":{"openai":"^4.77.0","voyageai":"^0.0.6"},"_npmOperationalInternal":{"tmp":"tmp/sapbtp-docs-mcp_1.0.5_1766402828743_0.029336904504543293","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"@contiva/sapbtp-docs-mcp","version":"1.0.6","keywords":["mcp","sap","business-technology-platform","documentation","search","ai","claude"],"author":{"name":"Robert Fels"},"license":"Apache-2.0","_id":"@contiva/sapbtp-docs-mcp@1.0.6","maintainers":[{"name":"robertfels","email":"robert.fels@contiva.com"}],"homepage":"https://github.com/robertfels/sapbtp-docs-mcp#readme","bugs":{"url":"https://github.com/robertfels/sapbtp-docs-mcp/issues"},"bin":{"sapbtp-docs-mcp":"build/index.js"},"dist":{"shasum":"c74eb3c91de2023f112494643463dc5c41561ba1","tarball":"https://registry.npmjs.org/@contiva/sapbtp-docs-mcp/-/sapbtp-docs-mcp-1.0.6.tgz","fileCount":91,"integrity":"sha512-mWmBz61tkt5X0LOhMqvkk2D0WbnsqfyeRcY14/eoT47XqalAj2EPPoXlOA5OMJfD6PKgyZEx+7UFtZ4y25CZtw==","signatures":[{"sig":"MEQCIA7kZtkE4wlKx5TwcpDpFTFktuhZMC24r22WKiWbVPh0AiBiSH1ucLXsCyu9OTh0Bxu+5DDYN3LgXu4Of9dm4rW6Ng==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":254135},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18.0.0"},"scripts":{"dev":"tsc --watch","build":"tsc","start":"node ./build/index.js","prepare":"npm run build","prepublishOnly":"npm run build"},"_npmUser":{"name":"robertfels","email":"robert.fels@contiva.com"},"repository":{"url":"git+https://github.com/robertfels/sapbtp-docs-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for SAP Business Technology Platform documentation - enables AI assistants to search and navigate SAP Business Technology Platform docs","directories":{},"_nodeVersion":"24.4.1","dependencies":{"remark":"^15.0.1","remark-gfm":"^4.0.0","gray-matter":"^4.0.3","strip-markdown":"^6.0.0","@xenova/transformers":"^2.17.2","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"optionalDependencies":{"openai":"^4.77.0","voyageai":"^0.0.6"},"_npmOperationalInternal":{"tmp":"tmp/sapbtp-docs-mcp_1.0.6_1766406976751_0.18865919115319296","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-12-22T08:34:55.739Z","modified":"2026-02-11T15:39:09.460Z","1.0.1":"2025-12-22T08:34:56.012Z","1.0.2":"2025-12-22T08:46:43.637Z","1.0.3":"2025-12-22T08:52:11.329Z","1.0.4":"2025-12-22T10:21:11.074Z","1.0.5":"2025-12-22T11:27:08.897Z","1.0.6":"2025-12-22T12:36:16.902Z"},"bugs":{"url":"https://github.com/robertfels/sapbtp-docs-mcp/issues"},"author":{"name":"Robert Fels"},"license":"Apache-2.0","homepage":"https://github.com/robertfels/sapbtp-docs-mcp#readme","keywords":["mcp","sap","business-technology-platform","documentation","search","ai","claude"],"repository":{"url":"git+https://github.com/robertfels/sapbtp-docs-mcp.git","type":"git"},"description":"MCP server for SAP Business Technology Platform documentation - enables AI assistants to search and navigate SAP Business Technology Platform docs","maintainers":[{"email":"amir.abassi@contiva.com","name":"amirnpmjs"},{"email":"benedikt.koch@contiva.com","name":"bkcon"},{"email":"robert.fels@contiva.com","name":"robertfels"}],"readme":"# SAP Business Technology Platform Documentation MCP Server\n\n> **Bring the entire SAP Business Technology Platform documentation directly into Claude Desktop** - search, explore, and get instant answers without leaving your AI assistant.\n\n[![npm version](https://img.shields.io/npm/v/@contiva/sapbtp-docs-mcp)](https://www.npmjs.com/package/@contiva/sapbtp-docs-mcp)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n\n## What is this?\n\nThis MCP (Model Context Protocol) server gives Claude Desktop instant access to the **complete SAP Business Technology Platform documentation**, including:\n\n- 📘 **SAP BTP Core** - Platform fundamentals, accounts, security\n- 🔌 **Services & Solutions** - All SAP BTP services and capabilities\n- 🚀 **Development & Operations** - Best practices, guides, and tutorials\n\n**No more switching between browser tabs.** Ask Claude about SAP BTP directly in your conversation.\n\n---\n\n## Quick Start (2 minutes)\n\n### Step 1: Install via Claude Desktop Config\n\nAdd this to your Claude Desktop configuration:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"sapbtp-docs\": {\n      \"command\": \"npx\",\n      \"args\": [\"@contiva/sapbtp-docs-mcp\"]\n    }\n  }\n}\n```\n\n### Step 2: Restart Claude Desktop\n\nThat's it! On first launch, the documentation downloads automatically in 1-2 minutes.\n\n### Step 3: Start asking questions\n\nTry these in Claude:\n\n> \"Search for OAuth 2.0 authentication in SAP BTP\"\n\n> \"Show me how to configure subaccounts and entitlements\"\n\n> \"What are the best practices for SAP BTP security?\"\n\n---\n\n## Why Use This?\n\n### ✅ **Instant, Context-Aware Answers**\nInstead of searching through help.sap.com manually, Claude can:\n- Search across all documentation instantly\n- Understand your question contextually\n- Combine information from multiple articles\n- Give you step-by-step guidance based on official docs\n\n### ✅ **Three Powerful Search Methods**\n- **Full-text search** - Find anything across all documentation\n- **Title-based search** - Fast fuzzy matching for quick lookups\n- **Semantic search** - AI understands what you mean, not just keywords\n\n### ✅ **Works Offline**\nAll documentation and AI embeddings run locally. No API keys needed, no data leaves your machine.\n\n---\n\n## Real-World Examples\n\n### Example 1: Learning a New Feature\n\n**You:**\n> \"I need to set up a Cloud Foundry environment in SAP BTP. Show me the steps.\"\n\n**Claude (with MCP):**\n> I'll search the SAP BTP documentation for Cloud Foundry setup...\n>\n> Based on the official documentation, here are the steps to set up Cloud Foundry:\n>\n> 1. Create a subaccount in your global account\n> 2. Enable the Cloud Foundry environment...\n> [Complete step-by-step guide with exact configuration]\n\n---\n\n### Example 2: Troubleshooting\n\n**You:**\n> \"How do I manage entitlements and quotas in my SAP BTP account?\"\n\n**Claude (with MCP):**\n> Let me search for entitlement management in the SAP BTP documentation...\n>\n> Entitlements define the services and resources available in your subaccounts. Here's how to manage them:\n>\n> [Specific steps and best practices from the docs]\n\n---\n\n### Example 3: Architecture Decisions\n\n**You:**\n> \"What's the difference between Cloud Foundry and Kyma runtime in SAP BTP?\"\n\n**Claude (with MCP):**\n> I'll compare both runtime environments from the documentation...\n>\n> **Cloud Foundry:**\n> - Use case: [from docs]\n> - Key features: [from docs]\n>\n> **Kyma:**\n> - Use case: [from docs]\n> - Key features: [from docs]\n>\n> **Recommendation:** [Based on official SAP guidance]\n\n---\n\n## Features in Detail\n\n### 🔍 Smart Search Capabilities\n\n```\nClaude can now:\n├─ Search by keywords (full-text)\n├─ Search by topic titles (fuzzy matching)\n├─ Search by meaning (semantic AI search)\n└─ Combine all three for best results\n```\n\n### 📚 Complete Documentation Coverage\n\n- Complete SAP BTP platform documentation\n- All services, capabilities, and features\n- Development guides, operations, and security best practices\n- Automatically updated from [SAP's official repository](https://github.com/SAP-docs/btp-cloud-platform)\n\n### ⚡ Performance\n\n- **Startup**: < 1 second\n- **Search**: 100-200ms for full-text, 500ms for semantic\n- **Memory**: Efficient resource usage\n- **First-time setup**: 1-2 minutes (one-time documentation download)\n\n### 🔒 Privacy-First\n\n- **100% local** - All AI embeddings run on your machine\n- **No API keys** - No external services required\n- **No data sharing** - Your queries stay private\n\n---\n\n## Available Commands\n\nOnce installed, Claude can use these tools automatically:\n\n### 🔍 search_documentation\nSearch across all documentation with combined search methods.\n\n**Example questions:**\n- \"Search for SAML authentication in SAP BTP\"\n- \"Find documentation about account management\"\n- \"Show me service configuration examples\"\n\n---\n\n### 📖 read_article\nRead complete documentation articles.\n\n**Example questions:**\n- \"Read the full article about SAP BTP security\"\n- \"Show me the complete guide for account setup\"\n\n---\n\n### 📑 list_topics\nBrowse documentation structure hierarchically.\n\n**Example questions:**\n- \"List all SAP BTP core platform topics\"\n- \"Show me the table of contents for services and solutions\"\n\n---\n\n### 🔗 get_related_articles\nFind related documentation automatically.\n\n**Example questions:**\n- \"What else should I read about SAP BTP security?\"\n- \"Find related articles to this account management guide\"\n\n---\n\n## Advanced Configuration\n\n### Custom Documentation Path\n\nIf you cloned the SAP docs repository locally:\n\n```json\n{\n  \"mcpServers\": {\n    \"sapbtp-docs\": {\n      \"command\": \"npx\",\n      \"args\": [\"@contiva/sapbtp-docs-mcp\"],\n      \"env\": {\n        \"MCP_DOCS_PATH\": \"/path/to/btp-cloud-platform/docs\"\n      }\n    }\n  }\n}\n```\n\n### Cloud Embeddings (Optional)\n\nFor faster initial indexing, use cloud-based embeddings:\n\n```json\n{\n  \"mcpServers\": {\n    \"sapbtp-docs\": {\n      \"command\": \"npx\",\n      \"args\": [\"@contiva/sapbtp-docs-mcp\"],\n      \"env\": {\n        \"EMBEDDING_PROVIDER\": \"voyage\",\n        \"VOYAGE_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n**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.\n\n---\n\n## Troubleshooting\n\n### \"Documentation not found\" error\n\nThe first run downloads docs automatically. If it fails:\n\n```bash\n# Manual installation\ngit clone https://github.com/SAP-docs/btp-cloud-platform.git\nexport MCP_DOCS_PATH=/path/to/btp-cloud-platform/docs\n```\n\nThen restart Claude Desktop.\n\n### MCP server not showing up\n\n1. Check your config file path is correct\n2. Ensure JSON syntax is valid (use a JSON validator)\n3. Restart Claude Desktop completely\n4. Check Claude Desktop logs for errors\n\n### Slow semantic search\n\nFirst-time semantic search builds an AI index (10-15 minutes with local embeddings). This is one-time only - subsequent searches are instant.\n\n---\n\n## Development\n\n### Local Development Setup\n\n```bash\n# Clone the MCP server\ngit clone https://github.com/robertfels/sapbtp-docs-mcp.git\ncd sapbtp-docs-mcp\n\n# Clone SAP docs (or it downloads automatically)\ngit clone https://github.com/SAP-docs/btp-cloud-platform.git\n\n# Install and build\nnpm install\nnpm run build\n\n# Test locally\nnpm start\n```\n\n### Publishing Updates\n\n```bash\nnpm version patch\nnpm publish --otp=<your-2fa-code>\n```\n\n---\n\n## How It Works\n\n```\n┌─────────────────┐\n│  Claude Desktop │\n│                 │\n│  \"Search for    │\n│   Cloud Foundry │\n│   setup\"        │\n└────────┬────────┘\n         │\n         │ MCP Protocol\n         ▼\n┌─────────────────────────────────┐\n│  @contiva/sapbtp-docs-mcp        │\n│                                 │\n│  ┌───────────┐  ┌────────────┐ │\n│  │ Full-text │  │   Title    │ │\n│  │  Search   │  │   Search   │ │\n│  └───────────┘  └────────────┘ │\n│                                 │\n│  ┌───────────────────────────┐ │\n│  │   Semantic AI Search      │ │\n│  │   (Local Embeddings)      │ │\n│  └───────────────────────────┘ │\n│                                 │\n│  ┌───────────────────────────┐ │\n│  │  SAP BTP Documentation    │ │\n│  │  (Downloaded from SAP)    │ │\n│  └───────────────────────────┘ │\n└─────────────────────────────────┘\n```\n\n---\n\n## Related Projects\n\n- [Model Context Protocol](https://modelcontextprotocol.io/) - Open protocol for AI-tool integration\n- [SAP Business Technology Platform Docs](https://github.com/SAP-docs/btp-cloud-platform) - Official SAP documentation repository\n- [Claude Desktop](https://claude.ai/download) - AI assistant with MCP support\n\n---\n\n## Contributing to SAP Documentation\n\nFound an error in the SAP documentation? You can contribute!\n\nThis 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.\n\n### How to Contribute\n\n1. Open the relevant guide on [SAP Help Portal](https://help.sap.com/docs/btp)\n2. Choose **Feedback** > **Edit page** to suggest changes\n3. Or choose **Feedback** > **Create issue** to report problems\n\nSee [SAP's Contribution Guidelines](https://help.sap.com/products/open-documentation-initiative/contribution-guidelines/readme.html) for more details.\n\n### Covered Documentation Areas\n\nThis MCP server provides access to the complete SAP Business Technology Platform documentation, covering all platform services, features, and capabilities as published in the [official SAP BTP documentation repository](https://github.com/SAP-docs/btp-cloud-platform).\n\n---\n\n## License\n\nThis MCP server is licensed under [Apache-2.0](LICENSE).\n\nThe 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.\n\n---\n\n## Support\n\n- **Issues**: [GitHub Issues](https://github.com/robertfels/sapbtp-docs-mcp/issues)\n- **NPM Package**: [@contiva/sapbtp-docs-mcp](https://www.npmjs.com/package/@contiva/sapbtp-docs-mcp)\n- **SAP Documentation**: [help.sap.com/btp](https://help.sap.com/docs/btp)\n\n---\n\n**Made with ❤️ for the SAP Business Technology Platform community**\n\n[![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)\n","readmeFilename":"README.md"}