Azure Cosmos DB MCP 服务器

<div align="center"> <img src="./src/img/logo.png" alt="Azure Cosmos DB MCP server logo" width="400"/> </div>

这是什么？🤔

这是一个让你的 LLM（例如 Claude）直接与你的 Azure Cosmos DB 数据对话的服务器！ 可以把它想象成一个友好的翻译器，位于你的 AI 助手和数据库之间，确保它们可以安全有效地聊天。

快速示例

你：“上个月我们排名前 10 的客户是谁？”
Claude：*查询你的 Azure Cosmos DB 数据库，并用简单的英语给你答案*

它如何工作？ 🛠️

该服务器利用模型上下文协议 (MCP)，这是一个通用的框架，充当 AI 模型和数据库之间的通用翻译器。 虽然 MCP 旨在支持任何 AI 模型，但目前可以在 Claude Desktop 中作为开发者预览版使用。

以下是您需要做的：

1. 设置项目（见下文）
2. 将您的项目详细信息添加到 Claude Desktop 的配置文件
3. 开始自然地与您的 Azure Cosmos DB 数据聊天！

它能做什么？ 📊

• 只需用简单的英语提问即可运行 Azure Cosmos DB 查询

快速开始 🚀

前提条件

• Node.js 14 或更高版本
• Azure Cosmos DB NOSQL 帐户或 Azure Cosmos DB 模拟器
• Claude Desktop

设置项目

• 从密钥部分获取 Azure Cosmos DB NOSQL 帐户 URI 和密钥，并创建一个包含以下密钥的“.env”文件，并替换这些值

COSMOSDB_URI=
COSMOSDB_KEY= 

开始使用

1. 安装依赖项 在根文件夹中运行以下命令以安装所有必要的依赖项：

   npm install
   

2. 构建项目 通过运行以下命令编译项目：

   npm run build
   

3. 启动服务器 导航到 dist 文件夹并启动服务器：

   npm start
   

4. 确认消息 您应该看到以下消息：

   Azure Cosmos DB Server running on stdio
   

将您的项目详细信息添加到 Claude Destkop 的配置文件

打开 Claude Desktop 并导航到 File -> Settings -> Developer -> Edit Config 并打开 claude_desktop_config 文件，并替换为以下值，

{
  "mcpServers": {
    "cosmosdb": {
      "command": "node",
      "args": [ "C:/Cosmos/azure-cosmos-mcp/dist/index.js" ], // Azure Cosmos DB MCP 服务器文件的路径
      "env": {
        "COSMOSDB_URI": "您的 Cosmos DB 帐户 URI",
        "COSMOSDB_KEY": "您的 Cosmos DB 密钥"
      }
    }
  }
}

您现在应该已成功配置了用于 Azure Cosmos DB 的 MCP 服务器与 Claude Desktop。 此设置允许您通过 MCP 服务器无缝地与 Azure Cosmos DB 交互，如下所示。

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

贡献

欢迎提出贡献和建议。 大多数贡献要求您同意贡献者许可协议 (CLA)，声明您有权授予我们使用您的贡献的权利，并且实际上确实授予了我们这些权利。 有关详细信息，请访问 https://cla.opensource.microsoft.com。

当您提交拉取请求时，CLA 机器人将自动确定您是否需要提供 CLA，并适当地修饰 PR（例如，状态检查、注释）。 只需按照机器人提供的说明进行操作即可。 您只需在使用我们的 CLA 的所有存储库中执行此操作一次。

本项目已采用 Microsoft Open Source Code of Conduct。 有关更多信息，请参见 Code of Conduct FAQ 或通过 opencode@microsoft.com 联系我们，提出任何其他问题或意见。

商标

本项目可能包含项目、产品或服务的商标或徽标。 授权使用 Microsoft 商标或徽标必须遵守 Microsoft 的商标和品牌指南。 在本项目的修改版本中使用 Microsoft 商标或徽标不得引起混淆或暗示 Microsoft 的赞助。 任何使用第三方商标或徽标均受这些第三方的政策约束。