Azure Cosmos MCP Server

🚀 Azure Cosmos DB MCP サーバー

このサーバーは、大規模言語モデル（ClaudeやVSCODEなど）をAzure Cosmos DBのデータと直接やり取りさせることができます！これを、AIアシスタントとデータベースの間に位置する友好的な翻訳機と考えることができ、両者が安全かつ効率的に通信できるようにします。

🚀 クイックスタート

前提条件

• Node.js 14 以上
• Azure Cosmos DB NoSQL アカウントまたはエミュレーター
• 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 を監視しています。
   

✨ 主な機能

概要

これは、大規模言語モデル（ClaudeやVSCODEなど）をAzure Cosmos DBのデータと直接やり取りさせることができるサーバーです。AIアシスタントとデータベースの間に位置する友好的な翻訳機として機能し、両者が安全かつ効率的に通信できるようにします。

快速示例

あなた：「先月の上位10の顧客は誰ですか？」
Claude：*あなたのAzure Cosmos DBデータベースをクエリし、plain Englishで結果を返します*

🔧 技術詳細

動作原理

このサーバーは、Model Context Protocol（MCP）を使用しています。MCPは、AIモデルとデータベースの間の橋渡しとして機能する汎用フレームワークです。MCPは任意のAIモデルをサポートしますが、現時点ではClaude Desktopは開発者プレビュー段階です。

💻 使用例

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を接続する橋渡しとして機能し、開発者がデータベースクエリを自動化するのに適しています。現在はプレビュー版ですが、機能が充実しており、試してみる価値があります！