{"_id":"@ignitionai/azure-ai-search-mcp","_rev":"2-e7e45d3292a03f561332e4ce58c06541","name":"@ignitionai/azure-ai-search-mcp","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.1":{"name":"@ignitionai/azure-ai-search-mcp","version":"1.0.1","keywords":["azure","azure-ai-search","search","vector-search","semantic-search","hybrid-search","rag","mcp","model-context-protocol","claude","ai","embedding","document-management","typescript"],"author":{"name":"Salim Laimeche","email":"salim@ignitionai.dev"},"license":"MIT","_id":"@ignitionai/azure-ai-search-mcp@1.0.1","maintainers":[{"name":"salim4n","email":"laimeche160@gmail.com"}],"homepage":"https://github.com/IgnitionAI/azure-ai-search-mcp#readme","bugs":{"url":"https://github.com/IgnitionAI/azure-ai-search-mcp/issues"},"bin":{"azure-ai-search-mcp":"dist/server.js"},"dist":{"shasum":"7ded567cde95416ad63c921e0b189e147aec861d","tarball":"https://registry.npmjs.org/@ignitionai/azure-ai-search-mcp/-/azure-ai-search-mcp-1.0.1.tgz","fileCount":13,"integrity":"sha512-Mvwc6jzZO6YJ+0PxqHWXc261BlqDYGmh6diam5QpdKCltHb0st5VTVsw16OnRsYLFIhh5LA34KdGjUeahQMUTw==","signatures":[{"sig":"MEYCIQDbC03GpYmpgeNF2/VNaoo/OoUKogmTw9jrJqlrmSH6SQIhAL80LBTcUFYcpOTet49FJDxiwEYj1nHsTxhOk/TN+dU6","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":525683},"main":"dist/server.js","type":"module","_from":"file:ignitionai-azure-ai-search-mcp-1.0.1.tgz","types":"./dist/server.d.ts","engines":{"node":">=18.0.0"},"scripts":{"test":"echo \"No tests yet\" && exit 0","build":"rollup -c","start":"node --loader ts-node/esm server.ts","inspect":"npx @modelcontextprotocol/inspector node dist/server.js","start:prod":"node dist/server.js"},"_npmUser":{"name":"salim4n","email":"laimeche160@gmail.com"},"_resolved":"/private/var/folders/ms/l8tr27yx5gnczd_3gsqrrd500000gn/T/4a7befa73554e52e889ab57262e075bc/ignitionai-azure-ai-search-mcp-1.0.1.tgz","_integrity":"sha512-Mvwc6jzZO6YJ+0PxqHWXc261BlqDYGmh6diam5QpdKCltHb0st5VTVsw16OnRsYLFIhh5LA34KdGjUeahQMUTw==","repository":{"url":"git+https://github.com/IgnitionAI/azure-ai-search-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"Complete Azure AI Search MCP server with vector search, semantic search, and document management","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.25.42","dotenv":"^16.5.0","@azure/identity":"^4.10.2","@azure/search-documents":"^12.1.0","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"tslib":"^2.8.1","rollup":"^4.42.0","ts-node":"^10.9.1","typescript":"^5.0.0","@rollup/plugin-json":"^6.1.0","@rollup/plugin-commonjs":"^28.0.3","@rollup/plugin-typescript":"^12.1.2","@rollup/plugin-node-resolve":"^16.0.1","rollup-plugin-preserve-shebang":"^1.0.1"},"_npmOperationalInternal":{"tmp":"tmp/azure-ai-search-mcp_1.0.1_1753465738810_0.5047074024526013","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@ignitionai/azure-ai-search-mcp","version":"1.0.2","description":"Complete Azure AI Search MCP server with vector search, semantic search, and document management","type":"module","bin":{"azure-ai-search-mcp":"dist/server.js"},"main":"dist/server.js","scripts":{"build":"rollup -c","start":"node --loader ts-node/esm server.ts","start:prod":"node dist/server.js","inspect":"npx @modelcontextprotocol/inspector node dist/server.js","prepublishOnly":"pnpm build","test":"echo \"No tests yet\" && exit 0"},"keywords":["azure","azure-ai-search","search","vector-search","semantic-search","hybrid-search","rag","mcp","model-context-protocol","claude","ai","embedding","document-management","typescript"],"author":{"name":"Salim Laimeche","email":"salim@ignitionai.dev"},"license":"MIT","homepage":"https://github.com/IgnitionAI/azure-ai-search-mcp#readme","repository":{"type":"git","url":"git+https://github.com/IgnitionAI/azure-ai-search-mcp.git"},"bugs":{"url":"https://github.com/IgnitionAI/azure-ai-search-mcp/issues"},"engines":{"node":">=18.0.0"},"dependencies":{"@azure/identity":"^4.10.2","@azure/search-documents":"^12.1.0","@modelcontextprotocol/sdk":"^1.12.1","dotenv":"^16.5.0","zod":"^3.25.42"},"devDependencies":{"@rollup/plugin-commonjs":"^28.0.3","@rollup/plugin-json":"^6.1.0","@rollup/plugin-node-resolve":"^16.0.1","@rollup/plugin-typescript":"^12.1.2","rollup":"^4.42.0","rollup-plugin-preserve-shebang":"^1.0.1","ts-node":"^10.9.1","tslib":"^2.8.1","typescript":"^5.0.0"},"packageManager":"pnpm@10.11.1+sha512.e519b9f7639869dc8d5c3c5dfef73b3f091094b0a006d7317353c72b124e80e1afd429732e28705ad6bfa1ee879c1fce46c128ccebd3192101f43dd67c667912","_id":"@ignitionai/azure-ai-search-mcp@1.0.2","gitHead":"8f38aa969bf85d50abb8bc40e582c189a51759b3","types":"./dist/server.d.ts","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-niD+l/LAzsDodgPyE+dM0vSqkPy5q7BArw624+NMHYUZQvQDE5yVH6R3MATQGGyxaVVFSXTikhxS9EYdbomFYA==","shasum":"938c6e4e5b1c04755dc4be45f95a97bf9bbb8046","tarball":"https://registry.npmjs.org/@ignitionai/azure-ai-search-mcp/-/azure-ai-search-mcp-1.0.2.tgz","fileCount":13,"unpackedSize":529647,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIB0DmG6WtrO9i1dZ4aFy6KOgiTS4HrRW2QJ2/yGAUajjAiEA4f0k8dMYyCNxvRrr0SP8xKrjvnxy69StW3qG7GOIkDo="}]},"_npmUser":{"name":"salim4n","email":"laimeche160@gmail.com"},"directories":{},"maintainers":[{"name":"salim4n","email":"laimeche160@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/azure-ai-search-mcp_1.0.2_1753534082481_0.844622498038603"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-25T17:48:58.735Z","modified":"2025-07-26T12:48:02.903Z","1.0.1":"2025-07-25T17:48:59.111Z","1.0.2":"2025-07-26T12:48:02.682Z"},"bugs":{"url":"https://github.com/IgnitionAI/azure-ai-search-mcp/issues"},"author":{"name":"Salim Laimeche","email":"salim@ignitionai.dev"},"license":"MIT","homepage":"https://github.com/IgnitionAI/azure-ai-search-mcp#readme","keywords":["azure","azure-ai-search","search","vector-search","semantic-search","hybrid-search","rag","mcp","model-context-protocol","claude","ai","embedding","document-management","typescript"],"repository":{"type":"git","url":"git+https://github.com/IgnitionAI/azure-ai-search-mcp.git"},"description":"Complete Azure AI Search MCP server with vector search, semantic search, and document management","maintainers":[{"name":"salim4n","email":"laimeche160@gmail.com"}],"readme":"# Azure AI Search MCP Server\n\n[![npm version](https://badge.fury.io/js/%40ignitionai%2Fazure-ai-search-mcp.svg)](https://badge.fury.io/js/%40ignitionai%2Fazure-ai-search-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA comprehensive Model Context Protocol (MCP) server for Azure AI Search with advanced capabilities including vector search, semantic search, and document management.\n\n## 🚀 Features\n\n### Core Search Capabilities\n- **Full-text search** with highlighting, filtering, and faceting\n- **Vector search** using k-nearest neighbors for similarity matching\n- **Hybrid search** combining text and vector search for optimal relevance\n- **Semantic search** with Azure AI's natural language understanding\n- **Auto-completion** and **search suggestions**\n\n### Document Management\n- **Batch document operations** (upload, merge, delete) up to 1000 documents\n- **Schema validation** with comprehensive error handling\n- **Index discovery** and dynamic resource registration\n\n### Advanced Features\n- **Semantic answers** extraction from search results\n- **Semantic captions** with highlighting\n- **Dynamic index discovery** and resource registration\n- **Dual authentication** (API key + Managed Identity)\n- **Comprehensive error handling** and logging\n\n## 📦 Installation\n\n```bash\nnpm install @ignitionai/azure-ai-search-mcp\n```\n\n## 🔧 Configuration\n\n### Environment Variables\n\n```bash\n# Required\nAZURE_SEARCH_ENDPOINT=https://your-service.search.windows.net\n\n# Authentication (choose one)\nAZURE_SEARCH_API_KEY=your-api-key\n# OR use Managed Identity (no API key needed)\n```\n\n### Claude Desktop Configuration\n\nAdd to your Claude Desktop config:\n\n```json\n{\n  \"mcpServers\": {\n    \"azure-ai-search\": {\n      \"command\": \"npx\",\n      \"args\": [\"@ignitionai/azure-ai-search-mcp\"],\n      \"env\": {\n        \"AZURE_SEARCH_ENDPOINT\": \"https://your-service.search.windows.net\",\n        \"AZURE_SEARCH_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n## 🛠️ Available Tools\n\n### Search Tools\n- **`search-documents`** - Full-text search with comprehensive filtering options\n- **`get-document`** - Retrieve specific documents by key\n- **`suggest`** - Get search suggestions using configured suggesters\n- **`autocomplete`** - Auto-complete partial search terms\n\n### Vector & Semantic Search\n- **`vector-search`** - Pure vector similarity search using k-nearest neighbors\n- **`hybrid-search`** - Combined text and vector search for enhanced relevance  \n- **`semantic-search`** - Azure AI semantic search with natural language understanding\n\n### Index Management\n- **`list-indexes`** - List all available search indexes\n- **`get-index-schema`** - Get complete index schema and field definitions\n- **`get-index-statistics`** - Get index usage statistics and document counts\n\n### Document Management\n- **`upload-documents`** - Upload/create documents (batch operations up to 1000)\n- **`merge-documents`** - Partial update of existing documents\n- **`delete-documents`** - Delete documents by key values (batch operations)\n\n## 📝 Usage Examples\n\n### Basic Search\n```json\n{\n  \"tool\": \"search-documents\",\n  \"arguments\": {\n    \"indexName\": \"my-index\",\n    \"searchText\": \"machine learning\",\n    \"top\": 10,\n    \"highlightFields\": [\"content\", \"title\"]\n  }\n}\n```\n\n### Vector Search\n```json\n{\n  \"tool\": \"vector-search\", \n  \"arguments\": {\n    \"indexName\": \"my-index\",\n    \"vectorQueries\": [{\n      \"vector\": [0.1, 0.2, 0.3, ...],\n      \"fields\": \"content_vector\",\n      \"k\": 5\n    }]\n  }\n}\n```\n\n### Semantic Search with Answers\n```json\n{\n  \"tool\": \"semantic-search\",\n  \"arguments\": {\n    \"indexName\": \"my-index\", \n    \"searchText\": \"How does machine learning work?\",\n    \"semanticConfiguration\": \"my-semantic-config\",\n    \"answers\": {\n      \"count\": 3,\n      \"threshold\": 0.7\n    }\n  }\n}\n```\n\n### Document Upload\n```json\n{\n  \"tool\": \"upload-documents\",\n  \"arguments\": {\n    \"indexName\": \"my-index\",\n    \"documents\": [\n      {\n        \"id\": \"1\",\n        \"title\": \"Document Title\",\n        \"content\": \"Document content...\"\n      }\n    ]\n  }\n}\n```\n\n## 🏗️ Architecture\n\n### Core Components\n- **server.ts** - Main MCP server with tool registration\n- **lib/azure-search-client.ts** - Azure Search client wrapper\n- **tools/** - Individual tool implementations\n- **resources/** - Dynamic resource registration\n- **types.ts** - Zod schemas for validation\n\n### Key Patterns\n- **Lazy Loading** - Azure Search clients instantiated on demand\n- **Client Caching** - Search clients cached per index\n- **Type Safety** - All parameters validated with Zod schemas\n- **Error Handling** - Consistent success/error response format\n\n## 🎯 Use Cases\n\n### RAG Applications\n- **Knowledge retrieval** with semantic understanding\n- **Hybrid search** for optimal relevance scoring\n- **Document management** for knowledge base updates\n\n### Content Discovery\n- **Vector similarity** for related content recommendations\n- **Semantic answers** for Q&A applications\n- **Auto-completion** for search interfaces\n\n### Enterprise Search\n- **Multi-modal search** across text and vector content\n- **Advanced filtering** and faceted navigation\n- **Batch operations** for data management\n\n## 🔍 Requirements\n\n- **Node.js** >= 18.0.0\n- **Azure AI Search** service\n- **Azure credentials** (API key or Managed Identity)\n\n## 📚 Documentation\n\n- [Full Documentation](https://github.com/IgnitionAI/azure-ai-search-mcp)\n- [Azure AI Search Documentation](https://docs.microsoft.com/en-us/azure/search/)\n- [Model Context Protocol](https://modelcontextprotocol.io/)\n\n## 🤝 Contributing\n\nContributions are welcome! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## 🏢 About IgnitionAI\n\nThis MCP server is developed and maintained by [IgnitionAI](https://ignitionai.dev), focusing on AI-powered search and knowledge management solutions.\n\n---\n\n**Made with ❤️ for the Claude MCP ecosystem**","readmeFilename":"README.md"}