documentdb

v0.1.0

Official Codex plugin for Azure DocumentDB (MongoDB-compatible). MCP server + skills.

CodexClaude Code1 MCP serverstdio

by AzureMIT5updated 1 week ago

Source

$ git clone https://github.com/Azure/documentdb-agent-kit

Clone the source, then follow the repository's marketplace instructions for your runtime. The repository root is the plugin root.

Layout

documentdb/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
└── .mcp.json

MCP servers1

documentdbstdio

command: npx
args: -y documentdb-mcp-server
env.TRANSPORT: stdio
env.AUTH_REQUIRED: false
env.TRUST_LOCAL_STDIO: true
env.CONNECTION_PROFILES: ${DOCUMENTDB_CONNECTION_PROFILES}
env.ENABLE_READ_TOOLS: true
env.ENABLE_WRITE_TOOLS: false
env.ENABLE_MANAGEMENT_TOOLS: false

Manifests2

.codex-plugin/plugin.json

{
  "name": "documentdb",
  "version": "0.1.0",
  "description": "Official Codex plugin for Azure DocumentDB (MongoDB-compatible). MCP server + skills.",
  "author": {
    "name": "Azure",
    "email": "mongodb-feedback@microsoft.com",
    "url": "https://azure.microsoft.com"
  },
  "homepage": "https://github.com/Azure/documentdb-agent-kit",
  "repository": "https://github.com/Azure/documentdb-agent-kit",
  "license": "MIT",
  "keywords": [
    "azure",
    "documentdb",
    "cosmosdb",
    "mongodb",
    "mcp",
    "vector-search",
    "database"
  ],
  "skills": "./skills/",
  "mcpServers": "./mcp.json",
  "interface": {
    "displayName": "Azure DocumentDB",
    "shortDescription": "Official Azure DocumentDB plugin: MCP server, skills, and best practices for MongoDB-compatible workflows on Azure.",
    "longDescription": "The official Azure DocumentDB plugin bundles the documentdb-mcp-server and a curated set of agent skills covering data modeling, indexing (ESR / multikey / wildcard / hashed / 2dsphere / TTL), query optimization with explain plans, vector search via cosmosSearch (DiskANN / HNSW / IVF, PQ, fp16), full-text search with $search, cluster sizing and shard-key design, high availability and cross-region replicas, security (TLS, Private Endpoint, Entra RBAC, CMK), monitoring, local Docker/Compose deployment, and Azure deployment via Bicep / CLI / Terraform. It gives your agent the tools and knowledge to provision a cluster, connect to any DocumentDB deployment, explore data, generate reliable code, and apply Azure DocumentDB best practices end to end.",
    "developerName": "Azure",
    "category": "Databases",
    "capabilities": [
      "Read",
      "Write"
    ],
    "websiteURL": "https://learn.microsoft.com/azure/cosmos-db/mongodb/vcore/",
    "privacyPolicyURL": "https://privacy.microsoft.com/privacystatement",
    "defaultPrompt": [
      "Set up my Azure DocumentDB connection using the mcp-setup skill.",
      "Connect to my Azure DocumentDB cluster and explore its collections.",
      "Write a MongoDB aggregation pipeline to analyze my data.",
      "Why is this query slow? Use explain() to recommend an index.",
      "Provision an Azure DocumentDB (MongoDB vCore) cluster with Bicep."
    ],
    "logo": "./assets/logo.jpg",
    "brandColor": "#0078D4"
  }
}

.claude-plugin/plugin.json

{
  "name": "documentdb",
  "version": "0.1.0",
  "description": "Official Claude plugin for Azure DocumentDB (MongoDB-compatible). Bundles the DocumentDB MCP server with skills for data modeling, indexing, query optimization, vector search, full-text search, deployment, security, and more.",
  "author": {
    "name": "Azure",
    "email": "mongodb-feedback@microsoft.com",
    "url": "https://azure.microsoft.com"
  },
  "homepage": "https://github.com/Azure/documentdb-agent-kit",
  "repository": "https://github.com/Azure/documentdb-agent-kit",
  "license": "MIT",
  "keywords": [
    "azure",
    "documentdb",
    "cosmosdb",
    "mongodb",
    "mcp",
    "vector-search",
    "database"
  ],
  "skills": "./skills/",
  "mcpServers": "./mcp.json"
}