Azure Cosmos DB MCP Toolkit

A Model Context Protocol (MCP) server that enables AI agents to interact with Azure Cosmos DB through natural language queries. Features enterprise-grade security with Azure Entra ID authentication, document operations, vector search, hybrid search, and schema discovery.

🎯 Why Use This Toolkit?

The Problem:
Building AI agents that can securely access enterprise data in Cosmos DB requires deep expertise in MCP protocol, authentication, embedding services, and cloud security. It’s complex, time-consuming, and error-prone.

The Solution:
This toolkit provides a production-ready, fully automated MCP server that handles everything:

• ✅ MCP Protocol — No protocol knowledge needed; we handle all MCP compliance
• ✅ Enterprise Security — Azure Entra ID + Managed Identity + RBAC built-in
• ✅ Vector & Hybrid Search — Automatic embeddings with Azure OpenAI/Foundry
• ✅ One-Click Deployment — Deploy to Azure in minutes with a single button click
• ✅ Schema Discovery — AI agents automatically understand your data
• ✅ Production-Ready — Auto-scaling, monitoring, and enterprise-grade hosting

Get started in 5 minutes: ⚡ Quick Start Guide

See it in action: 📚 Real-world use cases • 🗺️ Roadmap • 🤝 Contributing

Prerequisites

• Azure subscription (Free account)
• Azure Cosmos DB account (Create account)
• Embedding Service (one of the following for vector search and hybrid search):
  • Azure AI Services (Cognitive Services) with embedding model (Create)
  • Azure AI Foundry with embedding model (Create)
  • OpenAI API with API key (Get API key)
• Azure CLI (Install) installed and authenticated
• PowerShell 7+ (Install) (for deployment scripts)
• Docker Desktop (Install) installed and running
• .NET 9.0 SDK (Install) (for local development)
• Git (Install)