Azure Cosmos DB MCP服务器
这是什么？ 🤔
这是一个让你的LLM（如Claude）直接与你的Azure Cosmos DB数据通信的服务器！把它想象成一个友好的翻译器，坐在你的人工智能助手和数据库之间，确保他们可以安全有效地聊天。
快速示例
You: "What were our top 10 customers last month?"
Claude: *queries your Azure Cosmos DB database and gives you the answer in plain English*它是如何工作的？ 🛠️
该服务器利用了模型上下文协议（MCP），这是一个通用的框架，可以作为人工智能模型和数据库之间的通用翻译器。尽管MCP是为支持任何AI模型而构建的，但它目前可以在Claude Desktop中作为开发人员预览版访问。
以下是您需要做的一切：
- 设置项目（见下文）
- 将您的项目详细信息添加到Claude Desktop的配置文件中
- 开始自然地与您的Azure Cosmos DB数据聊天！
它能做什么？ 📊
- 只需用简单的英语提问即可运行Azure Cosmos DB查询
快速开始🚀
先决条件
- Node.js 14或更高版本
- Azure Cosmos DB NOSQL帐户或Azure Cosmos DB模拟器
- 克劳德桌面
建立项目
- 从keys部分获取Azure Cosmos DB NOSQL帐户URI和KEY，并使用以下键创建一个'.env'文件并替换值
COSMOSDB_URI=
COSMOSDB_KEY= 入门指南
- 再进行\
在根文件夹中运行以下命令以安装所有必要的依赖项：
npm install- 构建项目\
通过运行以下命令编译项目：
npm run build- 启动服务器\
导航到 dist 文件夹并启动服务器：
npm start- 确认消息\
您应该看到以下消息：
Azure Cosmos DB Server running on stdio将您的项目详细信息添加到Claude Destkop的配置文件中
打开克劳德桌面，导航到文件->设置->开发人员->编辑配置，然后打开 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"
}
}
}
}
现在，您应该已经使用Claude Desktop成功配置了Azure Cosmos DB的MCP服务器。此设置允许您通过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在所有存储库中执行一次此操作。
该项目采用了 微软开源行为准则. 有关更多信息，请参阅 行为准则常见问题 或 联系 opencode@microsoft.com 如有任何其他问题或意见。
商标
此项目可能包含项目、产品或服务的商标或徽标。授权使用Microsoft 商标或徽标必须遵守 微软商标和品牌指南. 在本项目的修改版本中使用Microsoft商标或徽标不得造成混淆或暗示Microsoft赞助。 任何使用第三方商标或徽标的行为均受这些第三方政策的约束。