@smwb/sendbox-mcp

MCP-сервер для разработки в sandbox-окружении. Предоставляет инструменты для работы с файлами, поиска по коду, выполнения команд и git-операций.

Установка

npm install @smwb/sendbox-mcp

Запуск

После установки сервер доступен через bin-команду:

npx smwb-sendbox-mcp

Или через имя пакета:

npx @smwb/sendbox-mcp

Или в конфигурации MCP-клиента (Cursor, Claude Desktop и т.д.):

{
  "mcpServers": {
    "sendbox": {
      "command": "npx",
      "args": ["smwb-sendbox-mcp"],
      "env": {
        "SENDBOX_MCP_ROOT": "/path/to/project"
      }
    }
  }
}

Переменная SENDBOX_MCP_ROOT задаёт корень рабочей директории. Если не указана — используется текущая директория процесса.

Инструменты

Базовые операции (P0)

| Инструмент | Описание | |---|---| | read_file | Чтение содержимого файла | | write_file | Полная перезапись файла | | apply_patch | Применение unified diff | | list_dir | Структура директории | | search_files | Поиск по содержимому (ripgrep или native fallback) |

Поиск и анализ (P1)

| Инструмент | Описание | |---|---| | semantic_search | Поиск по смыслу через keyword/symbol ranking | | get_symbols | Извлечение функций, классов, методов из файла | | find_usages | Поиск всех использований символа |

Управление окружением (P1)

| Инструмент | Описание | |---|---| | exec_command | Выполнение shell-команд | | get_dev_server_status | Проверка статуса dev-сервера (Next.js и др.) |

Git-интеграция (P2)

| Инструмент | Описание | |---|---| | git_diff | Текущие изменения в репозитории | | git_status | Статус рабочей директории |

Требования

• Node.js >= 20
• Git в PATH (для git-инструментов)
• Ripgrep (rg) опционален — при отсутствии используется встроенный поиск

Разработка

npm install
npm run dev
npm run build
npm start
npm run lint
npm run typecheck
npm test
npm run test:cov

CI/CD

Конфигурация: .sourcecraft/ci.yaml.

Pull request → main

• npm run lint
• npm run typecheck
• npm test

Git-тег → публикация в npm

Workflow npm-publish запускается при push тега формата v* (например v0.1.0).

Перед релизом:

1. Обнови version в package.json (должна совпадать с тегом без префикса v).
2. Закоммить изменения в main.
3. Создай и запушь тег:

git tag v0.1.0
git push origin v0.1.0

CI проверит lint/typecheck/tests, соберёт пакет и выполнит npm publish.

Секреты репозитория SourceCraft

Добавь в Settings → Secrets репозитория:

| Секрет | Обязательный | Описание | |---|---|---| | NPM_TOKEN | да | Automation token npm с правом Publish для пакета @smwb/sendbox-mcp |

Токен создаётся на npmjs.com → Access Tokens → Generate New Token → Granular Access Token (или Classic Automation).

CI публикует в https://registry.npmjs.org.

Лицензия

MIT