home / mcp / azure cosmos db mcp server
Provides an MCP server that enables natural-language queries against Azure Cosmos DB data through Claude Desktop.
Configuration
View docs{
"mcpServers": {
"robinong79-mcp-cosmos": {
"command": "node",
"args": [
"C:/Cosmos/azure-cosmos-mcp/dist/index.js"
],
"env": {
"COSMOSDB_KEY": "Your Cosmos DB KEY",
"COSMOSDB_URI": "Your Cosmos DB Account URI"
}
}
}
}You can run an MCP server that lets Claude Desktop talk to Azure Cosmos DB using natural language. This server acts as a translator between your AI prompts and Cosmos DB data, enabling secure, straightforward querying and data retrieval without writing raw queries.
Your MCP client (Claude Desktop) connects to the Azure Cosmos DB MCP Server to ask questions in plain language. When you say things like “show me our top 10 customers last month,” the server translates your request into Cosmos DB queries, runs them, and returns results in a readable format.
Prerequisites include Node.js version 14 or higher, an Azure Cosmos DB NOSQL account (or the Cosmos DB Emulator), and Claude Desktop.
The server runs as a local process that Claude Desktop can invoke. Use the following setup to configure Claude Desktop to start the MCP server locally and pass your Cosmos DB credentials.
{
"mcpServers": {
"cosmosdb": {
"command": "node",
"args": [ "C:/Cosmos/azure-cosmos-mcp/dist/index.js" ],
"env": {
"COSMOSDB_URI": "Your Cosmos DB Account URI",
"COSMOSDB_KEY": "Your Cosmos DB KEY"
}
}
}
}Keep your Cosmos DB credentials secure. Do not expose keys in logs or shared configurations. Use environment variables to inject sensitive data at runtime and restrict network access to trusted clients.
When the server starts correctly, you should see a message indicating the MCP server is running in stdio mode.
Executes Cosmos DB queries from natural-language prompts by translating questions into Cosmos DB SQL and returning results.