Azure Cosmos MCP Server

🚀 Azure Cosmos DB MCP 服務端

這是一個服務器，可讓大語言模型（如 Claude、VSCODE）直接與 Azure Cosmos DB 數據交互。它就像一個友好的翻譯器，架設在 AI 助手和數據庫之間，保障二者能安全高效地通信。

🚀 快速開始

快速示例

您：「上個月我們的前10大客戶是誰？」
Claude：*查詢您的 Azure Cosmos DB 數據庫，並以 plain English 的形式給出結果*

✨ 主要特性

它運用了 Model Context Protocol（MCP）這一通用框架，作為 AI 模型和數據庫之間的橋樑。雖然 MCP 支持任何 AI 模型，但目前 Claude Desktop 還處於開發者預覽階段。

📦 安裝指南

前提條件

• 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
   

💻 使用示例

基礎用法

在 VS Code Insiders 中使用

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

將項目信息添加到 Claude Desktop 配置文件

編輯 claude_desktop_config 文件，指定 MCP 服務器的位置和環境變量。

📚 詳細文檔

項目歡迎貢獻，並要求籤署 Contributor License Agreement（CLA）。瞭解更多信息，請訪問 CLA 頁面。遵循開源代碼規範，遵守 Microsoft 的商標政策。

這個項目是一個連接 AI 模型與 Azure Cosmos DB 的橋樑，適合開發者自動化處理數據庫查詢。儘管目前是預覽版，但功能齊全，值得一試！