Azure Cosmos DB MCP Server

by robinong79

Integrations

  • Used for configuration of Azure Cosmos DB credentials through environment variables in a .env file.

  • Required runtime environment for the MCP server, with version 14 or higher needed to run the Azure Cosmos DB integration.

Azure Cosmos DB MCP サーバー

これは何ですか?🤔

これは、Claude のような LLM が 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*

どのように機能するのですか?🛠️

このサーバーは、AIモデルとデータベース間の汎用的な翻訳機能を持つ汎用フレームワークであるModel Context Protocol(MCP)を活用しています。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 エミュレーター
  • クロードデスクトップ

プロジェクトの設定

  • 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を開き、「ファイル」->「設定」->「開発者」->「設定の編集」に移動し、 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)への同意が必要です。CLAは、貢献者がその貢献を利用する権利を有し、実際にその権利をMicrosoftに付与することを宣言するものです。詳細については、 https://cla.opensource.microsoft.comをご覧ください。

プルリクエストを送信すると、CLAボットがCLAが必要かどうかを自動的に判断し、適切な装飾(ステータス確認、コメントなど)をPRに施します。ボットの指示に従うだけで、CLAを使用しているすべてのリポジトリでこの操作を一度だけ実行すれば完了です。

このプロジェクトは、Microsoft オープンソース行動規範を採用しています。詳細については、行動規範に関する FAQ をご覧ください。ご質問やご意見がございましたら、 opencode@microsoft.comまでお問い合わせください。

商標

このプロジェクトには、プロジェクト、製品、またはサービスの商標またはロゴが含まれている場合があります。Microsoftの商標またはロゴの使用は、 Microsoftの商標およびブランドガイドラインの対象となり、これに従う必要があります。このプロジェクトの改変版におけるMicrosoftの商標またはロゴの使用は、混乱を招いたり、Microsoftのスポンサーシップを暗示したりしてはなりません。第三者の商標またはロゴの使用は、当該第三者のポリシーに従うものとします。

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Claude のような LLM が自然言語クエリを通じて Azure Cosmos DB データベースと対話できるようにし、AI アシスタントとデータベース システム間の翻訳者として機能できるようにするサーバー。

  1. これは何ですか?🤔
    1. 簡単な例
  2. どのように機能するのですか?🛠️
    1. 何ができるの?📊
  3. クイックスタート 🚀
    1. 前提条件
    2. プロジェクトの設定
    3. はじめる
    4. Claude Destkop の設定ファイルにプロジェクトの詳細を追加します
  4. 貢献
    1. 商標

      Related MCP Servers

      • -
        security
        A
        license
        -
        quality
        This is a server that lets your LLMs (like Claude) talk directly to your BigQuery data! Think of it as a friendly translator that sits between your AI assistant and your database, making sure they can chat securely and efficiently.
        Last updated -
        1
        215
        37
        JavaScript
        MIT License
      • A
        security
        A
        license
        A
        quality
        Enables natural language interaction with Azure services through Claude Desktop, supporting resource management, subscription handling, and tenant selection with secure authentication.
        Last updated -
        3
        4
        13
        TypeScript
        MIT License
      • A
        security
        A
        license
        A
        quality
        A server that enables LLMs like Claude to query AWS DynamoDB databases through natural language requests, supporting table management, data querying, and schema analysis.
        Last updated -
        7
        4
        JavaScript
        MIT License
        • Apple
      • A
        security
        A
        license
        A
        quality
        This server enables natural language interaction between a user and their Kuzu databases using clients like Claude Desktop or Cursor, allowing LLMs to retrieve the database schema, execute Cypher queries, create nodes, and establish relationships in the graph database.
        Last updated -
        2
        11
        JavaScript
        MIT License
        • Apple

      View all related MCP servers

      ID: 37x5gtn5v8