Servidor MCP de Azure Cosmos DB

¿Qué es esto? 🤔

Este es un servidor que permite que tus LLM (como Claude) se comuniquen directamente con tus datos de Azure Cosmos DB. Piensa en él como un traductor amigable que se encuentra entre tu asistente de IA y tu base de datos, asegurándose de que puedan comunicarse de forma segura y eficiente.

Ejemplo rápido

You: "What were our top 10 customers last month?"
Claude: *queries your Azure Cosmos DB database and gives you the answer in plain English*

Related MCP server: Couchbase MCP Server

¿Cómo funciona? 🛠️

Este servidor utiliza el Protocolo de Contexto de Modelo (MCP), un marco versátil que actúa como traductor universal entre modelos de IA y bases de datos. Si bien MCP está diseñado para ser compatible con cualquier modelo de IA, actualmente está disponible como versión preliminar para desarrolladores en Claude Desktop.

Esto es todo lo que necesitas hacer:

1. Configurar el proyecto (ver más abajo)

2. Agregue los detalles de su proyecto al archivo de configuración de Claude Desktop

3. ¡Comienza a chatear con tus datos de Azure Cosmos DB de forma natural!

¿Qué puede hacer? 📊

• Ejecute consultas de Azure Cosmos DB simplemente haciendo preguntas en un lenguaje sencillo

Inicio rápido 🚀

Prerrequisitos

• Node.js 14 o superior

• Cuenta NOSQL de Azure Cosmos DB o emulador de Azure Cosmos DB

• Escritorio de Claude

Configurar proyecto

• Obtenga el URI de la cuenta NOSQL de Azure Cosmos DB y la CLAVE de la sección de claves y cree un archivo '.env' con la siguiente clave y reemplace los valores

COSMOSDB_URI=
COSMOSDB_KEY= 

Empezando

1. Instalar dependencias
   Ejecute el siguiente comando en la carpeta raíz para instalar todas las dependencias necesarias:

   npm install

2. Construir el proyecto
   Compila el proyecto ejecutando:

   npm run build

3. Iniciar el servidor
   Navegue a la carpeta dist e inicie el servidor:

   npm start

4. Mensaje de confirmación
   Debería ver el siguiente mensaje:

   Azure Cosmos DB Server running on stdio

Añade los detalles de tu proyecto al archivo de configuración de Claude Destkop

Abra Claude Desktop y vaya a Archivo -> Configuración -> Desarrollador -> Editar configuración y abra el archivo claude_desktop_config y reemplácelo con los valores a continuación.

{
  "mcpServers": {
    "cosmosdb": {
      "command": "node",
      "args": [ "C:/Cosmos/azure-cosmos-mcp/dist/index.js" ] // Your Path for the Azure Cosmos DB MCP server file,
      "env": {
        "COSMOSDB_URI": "Your Cosmos DB Account URI",
        "COSMOSDB_KEY": "Your Cosmos DB KEY"
      }
    }
  }
}

Ya debería haber configurado correctamente el servidor MCP para Azure Cosmos DB con Claude Desktop. Esta configuración le permite interactuar sin problemas con Azure Cosmos DB a través del servidor MCP, como se muestra a continuación.

https://github.com/user-attachments/assets/ae3a14f3-9ca1-415d-8645-1c8367fd6943

Contribuyendo

Este proyecto agradece contribuciones y sugerencias. La mayoría de las contribuciones requieren la aceptación de un Acuerdo de Licencia de Colaborador (CLA), que declara que tiene derecho a otorgarnos, y efectivamente nos otorga, los derechos para usar su contribución. Para más información, visite https://cla.opensource.microsoft.com .

Al enviar una solicitud de extracción, un bot de CLA determinará automáticamente si es necesario proporcionar una CLA y la decorará adecuadamente (por ejemplo, comprobación de estado o comentario). Simplemente siga las instrucciones del bot. Solo tendrá que hacerlo una vez en todos los repositorios que utilicen nuestra CLA.

Este proyecto ha adoptado el Código de Conducta de Código Abierto de Microsoft . Para más información, consulte las preguntas frecuentes sobre el Código de Conducta o escriba a opencode@microsoft.com si tiene alguna pregunta o comentario.

Marcas comerciales

Este proyecto puede contener marcas comerciales o logotipos de proyectos, productos o servicios. El uso autorizado de las marcas comerciales o logotipos de Microsoft está sujeto a las Directrices de Marcas Registradas y de Marca de Microsoft y debe cumplirlas. El uso de marcas comerciales o logotipos de Microsoft en versiones modificadas de este proyecto no debe causar confusión ni implicar patrocinio por parte de Microsoft. El uso de marcas comerciales o logotipos de terceros está sujeto a las políticas de dichos terceros.