azure-cosmos-mcp-server

🚀 Azure Cosmos DB MCP 服务端

Azure Cosmos DB MCP 服务端是一个强大的服务器，可让大语言模型（如 Claude、VSCODE）直接与 Azure Cosmos DB 数据进行交互。它就像一个友好的翻译器，架起了 AI 助手和数据库之间的沟通桥梁，保障二者安全高效地通信。

🚀 快速开始

前提条件

• Node.js 14 或更高版本
• Azure Cosmos DB NoSQL 账户或 emulator
• 安装了 Claude Desktop

操作步骤

1. 创建 .env 文件并填写以下内容：

   AZURE_COSMOSDB_URI=你的数据库 URI
   AZURE_COSMOSDB_KEY=你的数据库密钥
   AZURE_COSMOSDB_DATABASE_ID=你的数据库 ID
   AZURE_COSMOSDB_CONTAINER_ID=你的容器 ID
   

2. 安装依赖：

   npm install
   

3. 编译项目：

   npm run build
   

4. 启动服务器：

   npm start
   

   成功后，控制台将显示：

   Azure Cosmos DB 服务端已启动，监听于 stdio
   

✨ 主要特性

• 作为 AI 模型与 Azure Cosmos DB 之间的桥梁，实现二者直接交互。
• 使用 Model Context Protocol（MCP）通用框架，保障通信安全高效。

💻 使用示例

基础用法

以下是一个简单的交互示例，展示了如何通过该服务端与 Azure Cosmos DB 进行交互：

您：「上个月我们的前10大客户是谁？」
Claude：*查询您的 Azure Cosmos DB 数据库，并以 plain English 的形式给出结果*

在 VS Code Insiders 中使用

1. 配置 mcp.json 文件。
2. 启用 GitHub Copilot Agent 模式。

将项目信息添加到 Claude Desktop 配置文件

编辑 claude_desktop_config 文件，指定 MCP 服务器的位置和环境变量。

🔧 技术细节

它使用了 Model Context Protocol（MCP），这是一个通用框架，作为 AI 模型和数据库之间的桥梁。虽然 MCP 支持任何 AI 模型，但目前 Claude Desktop 还处于开发者预览阶段。

🤝 贡献指南

项目欢迎贡献，并要求签署 Contributor License Agreement（CLA）。了解更多信息，请访问 CLA 页面。遵循开源代码规范，遵守 Microsoft 的商标政策。

这个项目是一个连接 AI 模型与 Azure Cosmos DB 的桥梁，适合开发者自动化处理数据库查询。尽管目前是预览版，但功能齐全，值得一试！