SkillFoxx
Telegram

MongoDB Agent Skills

Официальные скиллы MongoDB: запросы на естественном языке, схемы, индексы, Atlas Search и подключение драйверов

  • 198 ★ репозитория
  • Последний коммит
  • Apache-2.0
Скилл

Расширенный доступ

Почему такой уровень

  • Плагин подключает MCP-сервер, который читает данные кластера, а при учетных данных Atlas API управляет потоковой обработкой.
Все причины и проверки

mongodb/agent-skillsАвтор:MongoDB

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/mongodb-agent-skills

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Плагин подключает MCP-сервер, который читает данные кластера, а при учетных данных Atlas API управляет потоковой обработкой.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

MongoDB Agent Skills — набор из восьми скиллов, которые выпускает сама MongoDB для Claude Code, Cursor, Codex, GitHub Copilot и других агентов. Скиллы подсказывают агенту приемы, принятые у разработчиков базы, и работают вместе с MongoDB MCP-сервером. `mongodb-natural-language-querying` превращает просьбу на обычном языке в запрос `find` или конвейер агрегации, предварительно изучив схему коллекции и примеры документов. `mongodb-schema-design` разбирает приемы и ошибки моделирования: встраивание или ссылки, неограниченные массивы, миграцию с SQL. `mongodb-query-optimizer` ищет причины медленных запросов и советует индексы. `mongodb-search-and-ai` объясняет полнотекстовый, векторный и гибридный поиск в Atlas. Еще три скилла: `mongodb-connection` настраивает пулы и таймауты клиента для разных драйверов, `mongodb-atlas-stream-processing` управляет потоковой обработкой Atlas, а `mongodb-qe-size-estimation` оценивает, сколько места и памяти займет Queryable Encryption. `mongodb-mcp-setup` ведет по настройке самого MCP-сервера. Установка идет двумя путями. Плагин `mongodb-atlas` ставится из маркетплейсов агентов и сразу подключает размещенный MCP-сервер Atlas по OAuth. Для своего кластера есть плагин `mongodb`, который запускает MCP-сервер локально.

Для кого. Разработчикам приложений на MongoDB, которые пишут запросы, проектируют схемы и разбирают медленные операции вместе с агентом.

Подходит, если

  • Надо выбрать документы по условиям из описания на русском, а синтаксис агрегации вспоминать лень.
  • Приложение переезжает с SQL, и нужно решить, что встраивать в документ, а что вынести по ссылке.
  • Запрос к коллекции выполняется секундами, и агенту предстоит найти индекс, который это исправит.
  • В serverless-функции заканчиваются соединения с базой, и пул драйвера надо настроить правильно.
  • К существующим данным добавляют семантический поиск и выбирают между Atlas Search, векторным и гибридным.

Не подходит, если

  • База не MongoDB: скиллы привязаны к его запросам, индексам и сервисам Atlas.
  • Агент должен менять данные: скилл генерации запросов создает только запросы на чтение.
  • Оптимизация нужна без запроса на производительность: скилл индексов срабатывает только на просьбы про скорость и индексы.
  • Доступа к Atlas API нет: скилл потоковой обработки требует MCP-сервер с учетными данными Atlas API.

Пример запроса к агенту

В коллекции orders найди заказы за последнюю неделю с суммой больше 5000 и сгруппируй их по городам, начни с просмотра схемы.

Ограничения

Скиллы лучше всего работают вместе с MongoDB MCP-сервером. Без него оптимизатор советует индексы только по форме запроса, а скиллу потоковой обработки нужны учетные данные Atlas API. Плагин `mongodb-atlas` входит в Atlas по OAuth в браузере. Для Community и Enterprise Advanced используется плагин `mongodb`, который запускает сервер локально, а его настройки описаны в `README.community.md`. Отдельная установка скиллов MCP-сервер не подключает: его добавляют командой `npx "mongodb-mcp-server@latest" setup`. Часть скиллов, например про шифрование полей, рассчитана на узкие сценарии.

Как отключить. Отключите или удалите плагин `mongodb-atlas` через меню плагинов агента. Скиллы, поставленные через `npx skills add`, удалите из каталога скиллов агента. OAuth-доступ к Atlas отзовите в настройках аккаунта MongoDB.

Частые вопросы

Как поставить MongoDB Agent Skills в Claude Code?

Выполните `/plugin install mongodb-atlas`, пройдите подсказки и запустите `/reload-plugins`. Без плагинов подойдет `npx skills add mongodb/agent-skills`.

Чем отличаются плагины mongodb-atlas и mongodb?

`mongodb-atlas` подключает размещенный MCP-сервер Atlas через OAuth. `mongodb` запускает MCP-сервер локально для Community и Enterprise Advanced и работает с вашим собственным развертыванием.

Подключается ли MCP-сервер при установке скиллов напрямую?

Нет. Установка через `npx skills add` или копирование папки `skills/` дает только скиллы. Сервер добавляет команда `npx "mongodb-mcp-server@latest" setup`.

Для каких агентов есть плагин?

Для Claude, Cursor, Codex, GitHub Copilot (CLI и VS Code) и Grok. Cursor ставит его командой `/add-plugin mongodb-atlas`, Copilot CLI — командой `copilot plugin install mongodb-atlas`.

Умеет ли скилл запросов менять данные?

Нет. `mongodb-natural-language-querying` создает запросы `find` и конвейеры агрегации только для чтения. Поиск Atlas Search этот скилл не обрабатывает.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы
Официальный

Официальные 15 скиллов Redis учат агента структурам данных, поиску, кластерам и памяти агента, плюс MCP-сервер документации.

ПлагинМинимальный доступ175

PlanetScale Database Skills

planetscale-database-skills

Официальный

Скиллы для агентов, работающих с базами данных: по подкаталогу на каждую технологию. Автор — PlanetScale, для Cursor есть отдельный плагин

СкиллМинимальный доступ739
Официальный

Официальный плагин Firebase: 14 скиллов по Firestore, Auth, Hosting, Crashlytics, Remote Config и правилам безопасности

ПлагинШирокий доступ510

Скилл Payload

Payload agent skill

Официальный скилл Payload CMS, который приходит вместе с пакетом: коллекции, поля, хуки, доступы, запросы и адаптеры баз данных

СкиллМинимальный доступ45,8 тыс.
Официальный

Официальный набор Tencent CloudBase для кодинг-агентов: плагин ставит стек, скиллы задают правила, MCP работает с бэкендом

ПлагинШирокий доступ1,2 тыс.

32 скилла Tencent CloudBase: серверные функции, авторизация, ИИ-модели, хранилище и развертывание бэкенда на облаке.

СкиллРасширенный доступ81

Коротко о README

README посвящен плагину `mongodb-atlas` и разведен на установку для шести агентов, вход через OAuth и установку одних скиллов без плагина. Для самостоятельного развертывания README отсылает к `README.community.md`.

Бейдж для README

Исходный SKILL.md

---
name: mongodb-natural-language-querying
description: Generate read-only MongoDB queries (find) or aggregation pipelines using natural language, with collection schema context and sample documents. Use this skill whenever the user asks to write, create, or generate MongoDB queries, wants to filter/query/aggregate data in MongoDB, asks "how do I query...", needs help with query syntax, or discusses finding/filtering/grouping MongoDB documents. Also use for translating SQL-like requests to MongoDB syntax. Does NOT handle Atlas Search ($search operator), vector/semantic search ($vectorSearch operator), fuzzy matching, autocomplete indexes, or relevance scoring - use search-and-ai for those. Does NOT analyze or optimize existing queries - use mongodb-query-optimizer for that. Does NOT handle aggregation pipelines that involve write operations. Requires MongoDB MCP server.
license: Apache-2.0
metadata:
  version: "1.0.0"
allowed-tools: mcp__mongodb__*
---

# MongoDB Natural Language Querying

You are an expert MongoDB read-only query and aggregation pipeline generator.

## Query Generation Process

### 1. Gather Context Using MCP Tools

**Required Information:**
- Database name and collection name (use `mcp__mongodb__list-databases` and `mcp__mongodb__list-collections` if not provided)
- User's natural language description of the query

**Fetch in this order:**

1. **Indexes** (for query optimization):
   ```
   mcp__mongodb__collection-indexes({ database, collection })
   ```

2. **Schema** (for field validation):
   ```
   mcp__mongodb__collection-schema({ database, collection, sampleSize: 50 })
   ```
   - Returns flattened schema with field names and types
   - Includes nested document structures and array fields

3. **Sample documents** (for understanding data patterns):
   ```
   mcp__mongodb__find({ database, collection, limit: 4 })
   ```
   - Shows actual data values and formats

Сообщить о проблеме