Azure Cosmos DB

Provides an MCP server that enables natural-language queries against Azure Cosmos DB data through Claude Desktop.

javascript

3

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

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.

How to use

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.

How to install

Prerequisites include Node.js version 14 or higher, an Azure Cosmos DB NOSQL account (or the Cosmos DB Emulator), and Claude Desktop.

Additional configuration

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"
      }
    }
  }
}

Security and best practices

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.

Confirmation

When the server starts correctly, you should see a message indicating the MCP server is running in stdio mode.

Available tools

cosmos_query

Executes Cosmos DB queries from natural-language prompts by translating questions into Cosmos DB SQL and returning results.