{"_id":"@vbss-ai/mcp-mongodb-readonly","_rev":"2-a268c823d3373f42304c64d0f6838c6f","name":"@vbss-ai/mcp-mongodb-readonly","dist-tags":{"latest":"1.0.0"},"versions":{"0.0.0-stage":{"name":"@vbss-ai/mcp-mongodb-readonly","version":"0.0.0-stage","_id":"@vbss-ai/mcp-mongodb-readonly@0.0.0-stage","stub":true,"maintainers":[{"name":"vbss","email":"vbss-dev@outlook.com"}],"dist":{"shasum":"c0632a610f95ca4ead0d17e804bc5ccf0bac6445","tarball":"https://registry.npmjs.org/@vbss-ai/mcp-mongodb-readonly/-/mcp-mongodb-readonly-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-ts2iv+bKbwRZ+R0IhT3/RvNatzTbdaoQkY0nhtwBUp0t7ShGqxvScipRZ5DlZ2E3xPTOtnX5tI5FZCxOdIHqAQ==","signatures":[{"sig":"MEUCIQCDmW+Y0L4EpX+QfVSSyd8AuRh+MfvsuV5356yBql+jHAIgAl326lq9tFSariTtqaS8eJd5eFERUGMFxara4usGtT4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":351},"_npmUser":{"name":"vbss","email":"vbss-dev@outlook.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"1.0.0":{"_id":"@vbss-ai/mcp-mongodb-readonly@1.0.0","bin":{"vbss-mcp-mongodb-readonly":"src/index.js"},"mcp":{"label":"MongoDB Read-Only","toolPattern":"mcp__mongodb-readonly__*"},"bugs":{"url":"https://github.com/vbss-io/vbss-mcps/issues"},"dist":{"shasum":"32eb9898979c0dbf1fad0748d24a132cbbf4998c","tarball":"https://registry.npmjs.org/@vbss-ai/mcp-mongodb-readonly/-/mcp-mongodb-readonly-1.0.0.tgz","fileCount":8,"integrity":"sha512-1s5/+JDcrkP5WzYmG7JHuJ1DTxJVW26Lau5Az3DtNy57kFJPnE0Ryko9oCyTW/odUi8b7OlJByyeyCiLzCXnmw==","signatures":[{"sig":"MEUCIFNN6+FJsaUPQQcGV0dZZMw5PoWPAJYpang2lmgAmyfjAiEA58tpyDXSRbCsKrRatw0E6JWwmg02CKrNMGxZvIAptGc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBKcI6BinYzebz4OC4/zpcMhZ3ekGwjw4vYr/q7h97I2AiEA9j/lPwo3Af3Vl9yJPyiDJh+V9xiuPH+81TLp6npCVv4="}],"unpackedSize":25823},"main":"src/index.js","name":"@vbss-ai/mcp-mongodb-readonly","type":"module","author":{"url":"https://vbss.io/","name":"Vitor Bastos","email":"vitor@vbss.io"},"engines":{"node":">=20"},"gitHead":"6aba63f482ebb7365208c1ad2075c1de495d6ca8","license":"MIT","scripts":{"start":"node src/index.js"},"version":"1.0.0","_npmUser":{"name":"vbss","email":"vbss-dev@outlook.com"},"homepage":"https://github.com/vbss-io/vbss-mcps/tree/main/packages/mongodb-readonly#readme","keywords":["mcp","mcp-server","model-context-protocol","mongodb","cosmos-db","database","readonly"],"repository":{"url":"git+https://github.com/vbss-io/vbss-mcps.git","type":"git","directory":"packages/mongodb-readonly"},"_npmVersion":"10.9.4","description":"Read-only multi-org MongoDB MCP server compatible with MongoDB and Cosmos DB (MongoDB API)","directories":{},"maintainers":[{"name":"vbss","email":"vbss-dev@outlook.com"}],"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.25.0","dotenv":"^16.6.1","mongodb":"^6.21.0","@modelcontextprotocol/sdk":"^1.31.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-mongodb-readonly_1.0.0_1791765033189_0.8798830608450008"}}},"time":{"created":"2026-10-12T00:29:58.170Z","modified":"2026-10-12T00:30:33.459Z","0.0.0-stage":"2026-10-12T00:29:58.170Z","1.0.0":"2026-10-12T00:30:33.311Z"},"description":"Read-only multi-org MongoDB MCP server compatible with MongoDB and Cosmos DB (MongoDB API)","maintainers":[{"name":"vbss","email":"vbss-dev@outlook.com"}],"readme":"# MongoDB Readonly MCP\n\nMCP server read-only multi-org para MongoDB (e Cosmos DB MongoDB API). Permite explorar databases, collections e executar queries `find`/`aggregate` em diferentes organizações.\n\n## Uso via npx\n\nNão precisa clonar nem instalar: o cliente MCP baixa e roda o pacote com `npx`. Requer Node.js 20 ou superior.\n\nAdicione no `.mcp.json` do projeto (ou no `~/.claude.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"mongodb-readonly\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@vbss-ai/mcp-mongodb-readonly\"\n      ],\n      \"env\": {\n        \"MONGO_ORGS\": \"acme\",\n        \"MONGO_ACME_URL\": \"mongodb://readonly:senha@db.acme.com:27017/mydb?authSource=admin\",\n        \"MONGO_ACME_LABEL\": \"Acme Corp\"\n      }\n    }\n  }\n}\n```\n\nNo Windows, use `\"command\": \"cmd\"` e `\"args\": [\"/c\", \"npx\", \"-y\", \"@vbss-ai/mcp-mongodb-readonly\"]`.\n\nVerifique a conexão:\n\n```bash\nclaude mcp list\n```\n\n## Configuração\n\nAs variáveis vão no `env` do cliente MCP:\n\n```env\nMONGO_ORGS=acme,globex\n\n# Via URL\nMONGO_ACME_URL=mongodb://user:pass@db.acme.com:27017/mydb?authSource=admin\nMONGO_ACME_LABEL=Acme Corp\n\n# Via params individuais\nMONGO_GLOBEX_HOST=db.globex.com\nMONGO_GLOBEX_PORT=27017\nMONGO_GLOBEX_USER=readonly\nMONGO_GLOBEX_PASSWORD=secret\nMONGO_GLOBEX_DATABASE=production\nMONGO_GLOBEX_AUTH_SOURCE=admin\nMONGO_GLOBEX_TLS=true\nMONGO_GLOBEX_LABEL=Globex Industries\n\n# Opcional: limite de documentos por query (default: 1000)\nMONGO_MAX_DOCS=500\n```\n\n> `DATABASE` é opcional (default: `test`). Use a tool `list_databases` para descobrir bancos disponíveis e passe o parâmetro `database` em qualquer tool.\n\nUse um usuário de banco só leitura. A validação de queries do servidor é uma segunda camada, não substitui a permissão no banco.\n\nO certificado TLS é verificado por padrão. Se o servidor usa uma CA própria, aponte o certificado dela com `NODE_EXTRA_CA_CERTS` no `env`. Só em último caso desligue a verificação com `MONGO_<ORG>_TLS_VERIFY=false`.\n\n## Alternativa: usar a partir do clone\n\nPara rodar sem o npm, por exemplo para testar uma mudança no código, clone o repositório e instale as dependências:\n\n```bash\ngit clone https://github.com/vbss-io/vbss-mcps.git\ncd vbss-mcps\nnpm install\n```\n\nDepois aponte o cliente MCP para o arquivo do servidor, usando o caminho absoluto do clone:\n\n```json\n{\n  \"mcpServers\": {\n    \"mongodb-readonly\": {\n      \"type\": \"stdio\",\n      \"command\": \"node\",\n      \"args\": [\n        \"/caminho/para/vbss-mcps/packages/mongodb-readonly/src/index.js\"\n      ],\n      \"env\": {\n        \"MONGO_ORGS\": \"acme\",\n        \"MONGO_ACME_URL\": \"mongodb://readonly:senha@db.acme.com:27017/mydb?authSource=admin\",\n        \"MONGO_ACME_LABEL\": \"Acme Corp\"\n      }\n    }\n  }\n}\n```\n\nNo Windows, use barras normais no caminho (`C:/Users/voce/vbss-mcps/...`). Se o caminho tiver espaços, edite o JSON direto em vez de usar `claude mcp add`.\n\nAs variáveis podem ficar no `env` acima ou num arquivo `.env` em `packages/mongodb-readonly`, que o servidor lê ao iniciar.\n\nPara conferir que a configuração carrega sem erro, rode direto no terminal. O servidor fica em silêncio esperando o cliente; `Ctrl+C` encerra.\n\n```bash\nnode packages/mongodb-readonly/src/index.js\n```\n\n## Tools disponíveis\n\n| Tool | Descrição |\n| ---- | ----------- |\n| `list_organizations` | Lista orgs configuradas com status de conexão |\n| `list_databases` | Lista databases do cluster/servidor |\n| `list_collections` | Lista collections de um database |\n| `describe_collection` | Schema inferido de uma sample da collection |\n| `get_indexes` | Índices de uma collection |\n| `get_collection_stats` | Contagem de documentos e tamanho aproximado |\n| `get_sample_data` | Preview de documentos (max 100) |\n| `find_documents` | Query `find` read-only com filter, projection, sort, limit |\n| `aggregate` | Pipeline de aggregation read-only (sem `$out`/`$merge`) |\n| `count_documents` | Contagem por filter |\n| `distinct_values` | Valores distintos de um campo |\n\nTodas as tools (exceto `list_organizations`) aceitam o parâmetro opcional `database` para consultar qualquer banco da org dinamicamente.\n","readmeFilename":"README.md","homepage":"https://github.com/vbss-io/vbss-mcps/tree/main/packages/mongodb-readonly#readme","keywords":["mcp","mcp-server","model-context-protocol","mongodb","cosmos-db","database","readonly"],"repository":{"url":"git+https://github.com/vbss-io/vbss-mcps.git","type":"git","directory":"packages/mongodb-readonly"},"author":{"url":"https://vbss.io/","name":"Vitor Bastos","email":"vitor@vbss.io"},"bugs":{"url":"https://github.com/vbss-io/vbss-mcps/issues"},"license":"MIT"}