@zebrains/node-knowledge-mcp

MCP-сервер с markdown-базой знаний ZeBrains (Node, Keystone, Nuxt, Vue, аналитика, архитектура). Знания поставляются внутри пакета; ассистент в IDE подключается через Model Context Protocol и вызывает tools (onboarding, list_topics, get_topic, resolve_context, search_knowledge, run_analysis_pipeline).

• npm: @zebrains/node-knowledge-mcp
• Требования: Node.js 18+, доступ в интернет для npx (при первом запуске).

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

Ниже — минимальные фрагменты конфигурации. Имя сервера (zb-knowledge, zebrainsKnowledge и т.д.) можно заменить на своё; важны command, args и пакет.

Cursor

1. Откройте настройки MCP: Settings → MCP (или Cursor Settings → Features → MCP).
2. Отредактируйте JSON-конфигурацию и добавьте сервер в объект mcpServers (если ключа нет — создайте).

{
  "mcpServers": {
    "zb-knowledge": {
      "command": "npx",
      "args": ["-y", "@zebrains/node-knowledge-mcp"]
    }
  }
}

3. Сохраните файл и перезапустите MCP / Cursor при необходимости.

Актуальный путь к файлу конфигурации зависит от версии Cursor (пользовательский или проектный профиль) — при сомнении используйте пункт меню Open MCP config в UI.

Windsurf

1. MCP: откройте конфигурацию Cascade (например Windsurf Settings → Cascade / MCP или mcp_config.json в профиле Codeium — часто ~/.codeium/windsurf/mcp_config.json на macOS/Linux, на Windows — аналог в домашнем каталоге пользователя).
2. Добавьте сервер в mcpServers:

{
  "mcpServers": {
    "zb-knowledge": {
      "command": "npx",
      "args": ["-y", "@zebrains/node-knowledge-mcp"]
    }
  }
}

3. Правила для Cascade: см. раздел Правила для ИИ в репозитории — файл .windsurfrules в корне проекта.

Visual Studio Code (GitHub Copilot + MCP)

1. MCP: в корне проекта создайте файл .vscode/mcp.json (или откройте его командой MCP: Open Workspace Folder MCP Configuration).
2. Добавьте сервер в объект servers (формат документации VS Code):

{
  "servers": {
    "zebrainsKnowledge": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@zebrains/node-knowledge-mcp"]
    }
  }
}

3. Убедитесь, что для чата / агента включено использование MCP (настройки Copilot, режим Agent — по документации вашей версии VS Code).

4. Текстовые инструкции Copilot: см. раздел ниже — файл .github/copilot-instructions.md.

Правила для ИИ в репозитории

В пакете лежат шаблоны, которые нужно скопировать в свой проект (в Git их коммитят вместе с кодом). Тогда ассистент в IDE получает явное указание опираться на MCP ZeBrains.

Источник файлов после npm install:

node_modules/@zebrains/node-knowledge-mcp/rules/

Или из репозитория пакета — папка rules/.

| IDE | Шаблон (в rules/) | Куда скопировать в вашем проекте | Имя файла на месте | | --- | --- | --- | --- | | Cursor | cursor.mdc | .cursor/rules/ | Любое, с расширением .mdc, например zebrains-node-knowledge.mdc | | Windsurf | windsurf-rules.md | Корень репозитория | Переименовать в .windsurfrules (один файл, с ведущей точкой) | | VS Code (Copilot) | github-copilot-instructions.md | .github/ | Ровно copilot-instructions.md |

Краткая памятка по путям:

• Cursor: .cursor/rules/<имя>.mdc
• Windsurf: ./.windsurfrules
• VS Code: ./.github/copilot-instructions.md

Пример копирования (из установленного пакета)

Из корня вашего проекта (после npm install @zebrains/node-knowledge-mcp или установки как devDependency):

mkdir -p .cursor/rules .github
cp node_modules/@zebrains/node-knowledge-mcp/rules/cursor.mdc .cursor/rules/zebrains-node-knowledge.mdc
cp node_modules/@zebrains/node-knowledge-mcp/rules/windsurf-rules.md .windsurfrules
cp node_modules/@zebrains/node-knowledge-mcp/rules/github-copilot-instructions.md .github/copilot-instructions.md

На Windows в PowerShell используйте New-Item / Copy-Item по тем же путям.

Подробнее о назначении шаблонов — в rules/README.md внутри пакета.

Локальный запуск и проверка базы

npx @zebrains/node-knowledge-mcp

Обычно сервер ждёт stdio (запуск из IDE). Для проверки целостности графа тем в исходниках пакета:

npm run validate-knowledge

Обновление знаний

Стандарты в knowledge/ внутри пакета обновляются вместе с версией npm-пакета. Зафиксируйте версию в зависимостях или периодически обновляйте пакет, чтобы команда получала актуальные темы.

Первый шаг для ассистента

После подключения MCP попросите модель вызвать tool onboarding — он выдаёт актуальную вводную по инструментам и пайплайнам для текущей версии пакета.