Advertise
MCP.so
Sign In

Azure Cosmos DB MCP CLient & Server

@patrice-truong

Repository

Basic information

Category

Databases

License

MIT

Transports

stdio

Author

patrice-truong

About Azure Cosmos DB MCP CLient & Server

Azure Cosmos DB MCP Client and Server

#cosmosdb#azure#mcp#client-server

Azure Cosmos DB MCP CLient & Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "cosmosdb-mcp": {
      "command": "npx",
      "args": [
        "ts-node",
        "src/server.ts"
      ]
    }
  }
}

Azure Cosmos DB MCP CLient & Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Azure Cosmos DB MCP Client & Server?

This project demonstrates how to build an MCP Server and client connected to Azure Cosmos DB for NoSQL. It includes a NextJS 15 frontend that displays a product catalog and provides an AI Assistant for searching products and retrieving past orders, alongside a Node.js MCP Server that reads products and orders from the database.

How to use Azure Cosmos DB MCP Client & Server?

Clone the repository, configure environment variables (Azure Cosmos DB endpoint, database, containers, Azure Storage, Azure OpenAI credentials), then start the MCP server with npx ts-node src/server.ts from the mcp-server folder. Run the frontend with npm start from the nextjs folder. Optionally, populate the product catalog using the provided .NET tool in the populate folder.

Key features of Azure Cosmos DB MCP Client & Server

  • MCP Server connected to Azure Cosmos DB NoSQL
  • NextJS 15 frontend with product catalog display
  • AI Assistant for product search and order lookup
  • Vector search enabled on Cosmos DB for semantic queries
  • Integration with Azure Blob Storage for product images
  • Uses Azure OpenAI for embedding generation

Use cases of Azure Cosmos DB MCP Client & Server

  • Build an AI-powered e-commerce store with natural language product search
  • Enable customers to retrieve their order history through a chat interface
  • Demonstrate MCP integration with Azure Cosmos DB for real-time data access

Frequently asked questions

1

What Azure services are required?

Azure Cosmos DB for NoSQL (with vector search enabled), Azure Blob Storage for images, and Azure OpenAI for embeddings.

2

How do I populate the product catalog?

Run the .NET console application in the `populate` folder after configuring `appsettings.json` with your Cosmos DB account details and after authenticating with Azure (az login).

3

Where does data live?

Product, cart, and order data is stored in Azure Cosmos DB containers. Product images are hosted in Azure Blob Storage.

4

What authentication is used?

The project uses Azure RBAC (role-based access control) with an app registration and client secret. It also requires a storage account role assignment (Storage Blob Data Contributor). No built-in user authentication is implemented; the user email is hardcoded in `nextjs/models/constants.ts`.

5

How do I run the MCP Inspector?

Optionally start the MCP inspector with `npx -y @modelcontextprotocol/inspector` after the MCP server is running.

Comments

More Databases MCP servers

golfdata.online - Verified Golf Clubs

golfdata.online

Verified golf club data for AI agents: holes, par, address, phone, booking links, facilities, visitor rules and green fees for golf clubs in Spain (Canary Islands and mainland), expanding across Europe. Every fact comes

Neon MCP Server

neondatabase

MCP server for interacting with Neon Management API and databases

617

nuzur

nuzur is a model-first database platform for MySQL and PostgreSQL. The MCP server lets any AI assistant or agent (Claude, Cursor, Gemini, or anything else that speaks MCP) design your schema, query your data, generate mi

Multi Database MCP Server

FreePeak

A powerful multi-database server implementing the Model Context Protocol (MCP) to provide AI assistants with structured access to databases.

397

Postgres Mcp

crystaldba

Postgres MCP Pro provides configurable read/write access and performance analysis for you and your AI agents.

3.0K
Advertise