Azure Cosmos DB MCP 服务器

这是什么？🤔

这是一个服务器，可以让您的大语言模型（如 Claude）直接与您的 Azure Cosmos DB 数据进行对话！您可以将其视为一个友好的翻译器，位于您的 AI 助手和数据库之间，确保它们能够安全高效地交流。

快速示例

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

它是如何工作的？🛠️

这个服务器利用了 Model Context Protocol (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 和 KEY，并创建一个 .env 文件，包含以下键并替换值

COSMOSDB_URI=
COSMOSDB_KEY= 

开始使用

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

   npm install
   

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

   npm run build
   

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

   npm start
   

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

   Azure Cosmos DB 服务器正在 stdio 上运行
   

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

打开 Claude Desktop 并导航到 文件 -> 设置 -> 开发者 -> 编辑配置，打开 claude_desktop_config 文件并将以下值替换进去，

{
  "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"
      }
    }
  }
}

现在，您应该已经成功地为 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 开源行为准则。有关更多信息，请参阅 行为准则常见问题解答，或通过 opencode@microsoft.com 联系我们，提出任何其他问题或意见。

商标

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