MCP Shrimp Task Manager

🇺🇸 英語 | 🇩🇪 ドイツ語 | 🇪🇸 スペイン語 | 🇫🇷 フランス語 | 🇮🇹 イタリア語 | 🇮🇳 ヒンディー語 | 🇰🇷 韓国語 | 🇧🇷 ポルトガル語 | 🇷🇺 ロシア語 | 🇨🇳 中国語

MCP Shrimp Task Manager

🦐 AI を活用した開発のためのインテリジェントなタスク管理 - 複雑なプロジェクトを管理しやすいタスクに分割し、セッションをまたいでコンテキストを維持して、開発ワークフローを加速します。

🚀 クイックスタート

前提条件

• Node.js 18+
• npm または yarn
• MCP 対応 AI クライアント（Claude Code など）

インストール

Claude Code のインストール

Windows 11（WSL2 使用）：

# First, ensure WSL2 is installed (in PowerShell as Administrator)
wsl --install

# Enter Ubuntu/WSL environment
wsl -d Ubuntu

# Install Claude Code globally
npm install -g @anthropic-ai/claude-code

# Start Claude Code
claude

macOS/Linux：

# Install Claude Code globally
npm install -g @anthropic-ai/claude-code

# Start Claude Code
claude

Shrimp Task Manager のインストール

# Clone the repository
git clone https://github.com/cjo4m06/mcp-shrimp-task-manager.git
cd mcp-shrimp-task-manager

# Install dependencies
npm install

# Build the project
npm run build

Claude Code の設定

プロジェクトディレクトリに .mcp.json ファイルを作成します。

{
  "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"
      }
    }
  }
}

設定例：

{
  "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"
      }
    }
  }
}

次に、カスタム MCP 設定を使って Claude Code を起動します。

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

使い始める

1. プロジェクトを初期化する："init project rules"
2. タスクを計画する："plan task: implement user authentication"
3. タスクを実行する："execute task" または "continuous mode"

💡 Shrimp とは？

Shrimp Task Manager は、AI エージェントによるソフトウェア開発の進め方を変える MCP（Model Context Protocol）サーバーです。コンテキストを失ったり作業を繰り返したりする代わりに、Shrimp は次の機能を提供します。

• 🧠 永続メモリ：タスクと進捗はセッションをまたいで保持されます
• 📋 構造化されたワークフロー：計画、実行、検証のためのガイド付きプロセス
• 🔄 スマートな分解：複雑なタスクを管理しやすいサブタスクに自動的に分割します
• 🎯 コンテキストの保持：トークン制限があっても、作業中の位置を見失いません

✨ 主な機能

タスク管理

• インテリジェントな計画：実装前に要件を詳細に分析します
• タスクの分解：大規模なプロジェクトを、独立してテストできる単位に分割します
• 依存関係の追跡：タスク間の関係を自動的に管理します
• 進捗のモニタリング：ステータスをリアルタイムで追跡し、更新します

高度な機能

• 🔬 リサーチモード：テクノロジーやソリューションを体系的に調査します
• 🤖 エージェントシステム：特定のタスクに専門の AI エージェントを割り当てます（詳細はこちら）
• 📏 プロジェクトルール：プロジェクト全体でコーディング規約を定義し、維持します
• 💾 タスクメモリ：タスク履歴を自動的にバックアップし、復元します

Web インターフェース

🖥️ タスクビューアー

ドラッグ＆ドロップ、リアルタイム検索、複数プロフィールのサポートを備えた、視覚的なタスク管理のためのモダンな React インターフェースです。

クイックセットアップ：

cd tools/task-viewer
npm install
npm run start:all
# Access at http://localhost:5173

📖 タスクビューアーの全ドキュメント

🌐 Web GUI

タスクの概要をすばやく確認できる、オプションの軽量 Web インターフェースです。

.env で有効にします：ENABLE_GUI=true

📚 ドキュメント

• 📖 ドキュメント全文
• 🛠️ 利用可能なツール
• 🤖 エージェント管理
• 🎨 プロンプトのカスタマイズ
• 🔧 API リファレンス

🎯 よくあるユースケース

Agent: "plan task: add user authentication with JWT"
# Agent analyzes codebase, creates subtasks

Agent: "execute task"
# Implements authentication step by step

Agent: "plan task: fix memory leak in data processing"
# Agent researches issue, creates fix plan

Agent: "continuous mode"
# Executes all fix tasks automatically

Agent: "research: compare React vs Vue for this project"
# Systematic analysis with pros/cons

Agent: "plan task: migrate component to chosen framework"
# Creates migration plan based on research

🛠️ 設定

環境変数

.env ファイルを作成します。

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

# Optional
ENABLE_GUI=true          # Enable web GUI
WEB_PORT=3000           # Custom web port
PROMPT_LANGUAGE=en      # Prompt language (en, zh, etc.)

利用可能なコマンド

🤝 貢献

皆さまからの貢献を歓迎します。詳細は貢献ガイドをご覧ください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細はLICENSEファイルをご覧ください。

🌟 クレジット

cjo4m06が作成し、コミュニティがメンテナンスしています。

GitHub • 課題 • ディスカッション