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

MCP Shrimp Task Manager

🦐 Yapay zeka destekli geliştirme için akıllı görev yönetimi - Karmaşık projeleri yönetilebilir görevlere ayırın, oturumlar arasında bağlamı koruyun ve geliştirme iş akışınızı hızlandırın.

🚀 Hızlı Başlangıç

Ön Koşullar

• Node.js 18+
• npm veya yarn
• MCP uyumlu AI istemci (Claude Code, vb.)

Kurulum

Claude Code Kurulumu

Windows 11 (WSL2 ile):

# İlk olarak, WSL2'nin kurulu olduğundan emin olun (PowerShell'de Yönetici olarak)
wsl --install

# Ubuntu/WSL ortamına girin
wsl -d Ubuntu

# Claude Code'u global olarak yükleyin
npm install -g @anthropic-ai/claude-code

# Claude Code'u başlatın
claude

macOS/Linux:

# Claude Code'u global olarak yükleyin
npm install -g @anthropic-ai/claude-code

# Claude Code'u başlatın
claude

Shrimp Task Manager Kurulumu

# Repository'yi klonlayın
git clone https://github.com/cjo4m06/mcp-shrimp-task-manager.git
cd mcp-shrimp-task-manager

# Bağımlılıkları yükleyin
npm install

# Projeyi derleyin
npm run build

Claude Code'u Yapılandırma

Proje dizininizde bir .mcp.json dosyası oluşturun:

{
  "mcpServers": {
    "shrimp-task-manager": {
      "command": "node",
      "args": ["/path/to/mcp-shrimp-task-manager/dist/index.js"],
      "env": {
        "DATA_DIR": "/path/to/your/shrimp_data",
        "TEMPLATES_USE": "en",
        "ENABLE_GUI": "false"
      }
    }
  }
}

Örnek yapılandırma:

{
  "mcpServers": {
    "shrimp-task-manager": {
      "command": "node",
      "args": ["/home/fire/claude/mcp-shrimp-task-manager/dist/index.js"],
      "env": {
        "DATA_DIR": "/home/fire/claude/project/shrimp_data",
        "TEMPLATES_USE": "en",
        "ENABLE_GUI": "false"
      }
    }
  }
}

Ardından, özel MCP yapılandırmanızla Claude Code'u başlatın:

claude --dangerously-skip-permissions --mcp-config .mcp.json

Kullanmaya Başlayın

1. Projenizi başlatın: "init project rules"
2. Bir görev planlayın: "plan task: implement user authentication"
3. Görevleri çalıştırın: "execute task" veya "continuous mode"

💡 Shrimp Nedir?

Shrimp Task Manager, AI ajanlarının yazılım geliştirme yaklaşımını dönüştüren bir MCP (Model Context Protocol) sunucusudur. Bağlamı kaybetmek veya işi tekrarlamak yerine, Shrimp sağlar:

• 🧠 Kalıcı Bellek: Görevler ve ilerleme oturumlar arasında devam eder
• 📋 Yapılandırılmış İş Akışları: Planlama, yürütme ve doğrulama için rehberli süreçler
• 🔄 Akıllı Ayrıştırma: Karmaşık görevleri otomatik olarak yönetilebilir alt görevlere ayırır
• 🎯 Bağlam Koruması: Token sınırlarında bile asla yerinizi kaybetmeyin

✨ Temel Özellikler

Görev Yönetimi

• Akıllı Planlama: Uygulamadan önce gereksinimlerin derin analizi
• Görev Ayrıştırması: Büyük projeleri atomik, test edilebilir birimler halinde ayırın
• Bağımlılık İzlemesi: Görev ilişkilerinin otomatik yönetimi
• İlerleme İzleme: Gerçek zamanlı durum izlemesi ve güncellemeleri

İleri Yetenekler

• 🔬 Araştırma Modu: Teknolojilerin ve çözümlerin sistematik keşfi
• 🤖 Agent Sistemi: Özel AI ajanlarını belirli görevlere atayın (Daha fazla bilgi)
• 📏 Proje Kuralları: Proje genelinde kodlama standartlarını tanımlayın ve koruyun
• 💾 Görev Belleği: Görev geçmişinin otomatik yedeklemesi ve geri yüklenmesi

Web Arayüzleri

🖥️ Task Viewer

Sürükle-bırak, gerçek zamanlı arama ve multi-profil desteğine sahip görsel görev yönetimi için modern React arayüzü.

Hızlı Kurulum:

cd tools/task-viewer
npm install
npm run start:all
# http://localhost:5173 adresinden erişin

📖 Tam Task Viewer Belgeleri

🌐 Web GUI

Hızlı görev genel bakışı için isteğe bağlı hafif web arayüzü.

.env dosyasında etkinleştirin: ENABLE_GUI=true

📚 Belgeler

• 📖 Tam Belgeler
• 🛠️ Kullanılabilir Araçlar
• 🤖 Agent Yönetimi
• 🎨 Prompt Özelleştirmesi
• 🔧 API Başvurusu

🎯 Yaygın Kullanım Durumları

Agent: "plan task: add user authentication with JWT"
# Agent kod tabanını analiz eder, alt görevler oluşturur

Agent: "execute task"
# Kimlik doğrulamayı adım adım uygular

Agent: "plan task: fix memory leak in data processing"
# Agent sorunu araştırır, düzeltme planı oluşturur

Agent: "continuous mode"
# Tüm düzeltme görevlerini otomatik olarak çalıştırır

Agent: "research: compare React vs Vue for this project"
# Artı/eksiyle sistematik analiz

Agent: "plan task: migrate component to chosen framework"
# Araştırmaya dayalı göç planı oluşturur

🛠️ Yapılandırma

Ortam Değişkenleri

Bir .env dosyası oluşturun:

# Zorunlu
DATA_DIR=/path/to/data/storage

# İsteğe bağlı
ENABLE_GUI=true          # Web GUI'yi etkinleştir
WEB_PORT=3000           # Özel web portu
PROMPT_LANGUAGE=en      # Prompt dili (en, zh, vb.)

Kullanılabilir Komutlar

🤝 Katkıda Bulunma

Katkılarınızı bekliyoruz! Ayrıntılar için lütfen Katkı Rehberimiz bölümüne bakın.

📄 Lisans

Bu proje MIT Lisansı altında lisanslanmıştır - ayrıntılar için LICENSE dosyasına bakın.

🌟 Teşekkürler

cjo4m06 tarafından oluşturulmuş ve topluluk tarafından yönetilmektedir.

GitHub • Sorunlar • Tartışmalar