MCP Cosmosdb Go

🚀 Go SDKを使用したAzure Cosmos DBのMCPサーバー

このプロジェクトは、Go SDK を用いて構築されたAzure Cosmos DBのMCPサーバーのサンプル実装です。mcp-go プロジェクトは、MCPのGo実装として使用されています。

このMCPサーバーは、Azure Cosmos DBとのやり取りに以下のツールを提供します：

• データベースの一覧表示：特定のCosmos DBアカウント内のすべてのデータベースを取得します。
• コンテナの一覧表示：特定のデータベース内のすべてのコンテナを取得します。
• コンテナメタデータの読み取り：特定のコンテナのメタデータまたは構成情報を取得します。
• コンテナの作成：指定されたデータベース内に、定義されたパーティションキーを持つ新しいコンテナを作成します。
• コンテナへの項目の追加：指定されたデータベース内のコンテナに新しい項目を追加します。
• メッセージの読み取り：IDとパーティションキーを使用して、コンテナから特定の項目を読み取ります。
• クエリの実行：Cosmos DBコンテナ上でSQLクエリを実行し、必要に応じてパーティションキー範囲を指定できます。

以下は、VS Code Insiders in Agent mode を使用したデモビデオです（2倍速での視聴をおすすめします 😄）：

🚀 クイックスタート

📦 インストール

git clone https://github.com/abhirockzz/mcp_cosmosdb_go
cd mcp_cosmosdb_go

go build -o mcp_azure_cosmosdb main.go

MCPサーバーの設定

mkdir -p .vscode

# mcp.jsonの内容を定義
MCP_JSON_CONTENT=$(cat <<EOF
{
  "servers": {
    "CosmosDB Golang MCP": {
      "type": "stdio",
      "command": "$(pwd)/mcp_azure_cosmosdb"
    }
  }
}
EOF
)

# 内容をmcp.jsonに書き込む
echo "$MCP_JSON_CONTENT" > .vscode/mcp.json

🔐 Azure Cosmos DBのRBAC権限と認証

• 使用するユーザー主体は、データベース、コンテナ、および項目のCRUD操作を実行するための権限（制御平面 および データ平面）を持っている必要があります。
• 認証方法：
  • ローカル資格情報：Azure CLI（az login）を使用してローカルでログインするだけで、MCPサーバーは自動的に DefaultAzureCredential を使用します。
  • または、MCPサーバーの構成で COSMOSDB_ACCOUNT_KEY 環境変数を設定することもできます：

  {
    "servers": {
      "CosmosDB Golang MCP": {
        "type": "stdio",
        "command": "/Users/demo/mcp_azure_cosmosdb",
        "env": {
          "COSMOSDB_ACCOUNT_KEY": "入力キー"
        }
      }
    }
  }
  

これで準備完了です！VS Code Insiderのエージェントモードを起動して、使用を開始しましょう。

🔧 ローカル開発とテスト

このセクションでは、ローカル環境での開発とテストについて説明します。（原文で具体的な内容がないため、ここでの説明は省略されています。）