Skip to content

README.md

Latest commit

 

History

History
261 lines (189 loc) · 11.2 KB

README.md

File metadata and controls

261 lines (189 loc) · 11.2 KB

🇺🇸 English | 🇩🇪 Deutsch | 🇪🇸 Español | 🇫🇷 Français | 🇮🇹 Italiano | 🇮🇳 हिन्दी | 🇰🇷 한국어 | 🇧🇷 Português | 🇷🇺 Русский | 🇨🇳 中文

MCP Shrimp Task Manager

🦐 Интеллектуальное управление задачами для разработки с ИИ - Разделяйте сложные проекты на управляемые задачи, сохраняйте контекст между сессиями и ускоряйте свой рабочий процесс разработки.

🚀 Быстрый старт

Предварительные требования

  • Node.js 18+
  • npm или yarn
  • MCP-совместимый ИИ клиент (Claude Code и др.)

Установка

Установка Claude Code

Windows 11 (с WSL2):

# Сначала убедитесь, что WSL2 установлен (в PowerShell от имени администратора)
wsl --install

# Войдите в среду Ubuntu/WSL
wsl -d Ubuntu

# Установите Claude Code глобально
npm install -g @anthropic-ai/claude-code

# Запустите Claude Code
claude

macOS/Linux:

# Установите Claude Code глобально
npm install -g @anthropic-ai/claude-code

# Запустите Claude Code
claude

Установка Shrimp Task Manager

# Клонируйте репозиторий
git clone https://github.com/cjo4m06/mcp-shrimp-task-manager.git
cd mcp-shrimp-task-manager

# Установите зависимости
npm install

# Соберите проект
npm run build

Настройка Claude Code

Создайте файл .mcp.json в директории вашего проекта:

{
  "mcpServers": {
    "shrimp-task-manager": {
      "command": "node",
      "args": ["/путь/к/mcp-shrimp-task-manager/dist/index.js"],
      "env": {
        "DATA_DIR": "/путь/к/вашим/данным_shrimp",
        "TEMPLATES_USE": "ru",
        "ENABLE_GUI": "false"
      }
    }
  }
}

Пример конфигурации:

{
  "mcpServers": {
    "shrimp-task-manager": {
      "command": "node",
      "args": ["/home/fire/claude/mcp-shrimp-task-manager/dist/index.js"],
      "env": {
        "DATA_DIR": "/home/fire/claude/проект/данные_shrimp",
        "TEMPLATES_USE": "ru",
        "ENABLE_GUI": "false"
      }
    }
  }
}

Затем запустите Claude Code с вашей пользовательской MCP конфигурацией:

claude --dangerously-skip-permissions --mcp-config .mcp.json
Другие ИИ клиенты

Cline (Расширение VS Code): Расширение VS Code для программирования с помощью ИИ. Добавьте в VS Code settings.json под cline.mcpServers

Claude Desktop: Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows)

Начало использования

  1. Инициализируйте ваш проект: "init project rules"
  2. Спланируйте задачу: "plan task: реализовать аутентификацию пользователя"
  3. Выполните задачи: "execute task" или "continuous mode"

💡 Что такое Shrimp?

Shrimp Task Manager - это MCP (Model Context Protocol) сервер, который преобразует подход ИИ агентов к разработке программного обеспечения. Вместо потери контекста или повторения работы, Shrimp предоставляет:

  • 🧠 Постоянная память: Задачи и прогресс сохраняются между сессиями
  • 📋 Структурированные рабочие процессы: Управляемые процессы для планирования, выполнения и проверки
  • 🔄 Интеллектуальная декомпозиция: Автоматически разбивает сложные задачи на управляемые подзадачи
  • 🎯 Сохранение контекста: Никогда не теряйте свое место, даже при ограничениях токенов

✨ Основные функции

Управление задачами

  • Интеллектуальное планирование: Глубокий анализ требований перед реализацией
  • Декомпозиция задач: Разделение больших проектов на атомарные, тестируемые единицы
  • Отслеживание зависимостей: Автоматическое управление отношениями между задачами
  • Мониторинг прогресса: Отслеживание статуса и обновления в реальном времени

Расширенные возможности

  • 🔬 Режим исследования: Систематическое изучение технологий и решений
  • 🤖 Система агентов: Назначайте специализированных ИИ агентов конкретным задачам (Узнать больше)
  • 📏 Правила проекта: Определяйте и поддерживайте стандарты кодирования в вашем проекте
  • 💾 Память задач: Автоматическое резервное копирование и восстановление истории задач

Веб-интерфейсы

🖥️ Просмотрщик задач

Современный React интерфейс для визуального управления задачами с перетаскиванием, поиском в реальном времени и поддержкой нескольких профилей.

Быстрая настройка:

cd tools/task-viewer
npm install
npm run start:all
# Доступ по http://localhost:5173

📖 Полная документация просмотрщика задач

Интерфейс просмотрщика задач

🌐 Веб GUI

Дополнительный легкий веб-интерфейс для быстрого обзора задач.

Включить в .env: ENABLE_GUI=true

📚 Документация

🎯 Распространенные случаи использования

Разработка функций 
Агент: "plan task: добавить аутентификацию пользователя с JWT"
# Агент анализирует кодовую базу, создает подзадачи

Агент: "execute task"
# Реализует аутентификацию пошагово
Исправление ошибок 
Агент: "plan task: исправить утечку памяти в обработке данных"
# Агент исследует проблему, создает план исправления

Агент: "continuous mode"
# Выполняет все задачи исправления автоматически
Исследование и обучение 
Агент: "research: сравнить React vs Vue для этого проекта"
# Систематический анализ с плюсами/минусами

Агент: "plan task: мигрировать компонент на выбранный фреймворк"
# Создает план миграции на основе исследования

🛠️ Конфигурация

Переменные окружения

Создайте файл .env:

# Обязательно
DATA_DIR=/путь/к/хранению/данных

# Опционально
ENABLE_GUI=true          # Включить веб GUI
WEB_PORT=3000           # Пользовательский веб-порт
PROMPT_LANGUAGE=ru      # Язык промптов (ru, en, zh и др.)

Доступные команды

Команда Описание
init project rules Инициализировать стандарты проекта
plan task [описание] Создать план задачи
execute task [id] Выполнить конкретную задачу
continuous mode Выполнить все задачи последовательно
list tasks Показать все задачи
research [тема] Войти в режим исследования
reflect task [id] Проанализировать и улучшить задачу

🤝 Вклад в проект

Мы приветствуем вклад! Пожалуйста, ознакомьтесь с нашим Руководством по вкладу для получения подробностей.

📄 Лицензия

Этот проект лицензирован под MIT License - см. файл LICENSE для подробностей.

🌟 Авторы

Создан cjo4m06 и поддерживается сообществом.

GitHub • Issues • Обсуждения