Shrimp Task Manager

Integrations

  • Supports configuration through environment variables, allowing customization of prompts and system behavior without modifying code.

  • Leverages Node.js as the runtime environment for the task management system, enabling efficient execution of the MCP server and its task management capabilities.

  • Uses TypeScript to provide a type-safe development environment for the task management system, enhancing code reliability and maintainability.

英語|中国語

目錄

MCP シュリンプ タスクマネージャー

🚀 モデルコンテキストプロトコル (MCP) に基づくインテリジェントなタスク管理システム。AI エージェントに効率的なプログラミング ワークフロー フレームワークを提供します。

Shrimp Task Manager は、体系的なプログラミング、タスク メモリ管理メカニズムの強化、冗長で反復的なコーディング作業の効率的な回避のために、構造化されたワークフローを通じてエージェントをガイドします。

✨ 特徴

  • タスク計画と分析:複雑なタスク要件の深い理解と分析
  • インテリジェントなタスク分解: 大きなタスクを管理しやすい小さなタスクに自動的に分割します
  • 依存関係管理: タスク間の依存関係を正確に処理し、正しい実行順序を確保します。
  • 実行ステータスの追跡: タスク実行の進行状況とステータスをリアルタイムで監視
  • タスク完了の検証: タスクの結果が期待される要件を満たしていることを確認する
  • タスクの複雑さの評価: タスクの複雑さを自動的に評価し、最適な処理の提案を提供します
  • タスク概要の自動更新: タスク完了時に概要を自動的に生成し、メモリパフォーマンスを最適化します。
  • タスクメモリ機能: タスク履歴を自動的にバックアップし、長期記憶と参照機能を提供します。
  • 思考連鎖プロセス:複雑な問題を体系的に分析するための段階的な推論
  • プロジェクトルールの初期化: 大規模プロジェクト間で一貫性を維持するためのプロジェクト標準とルールを定義します。

🧭 使用ガイド

Shrimp Task Manager は、ガイド付きワークフローと体系的なタスク管理を通じて、AI 支援プログラミングへの構造化されたアプローチを提供します。

エビとは何ですか?

Shrimpは、AIエージェントがプロジェクトをより深く理解し、プロジェクトで作業できるようにするためのプロンプトテンプレートです。一連のプロンプトを使用することで、エージェントがプロジェクト固有のニーズや慣例に厳密に適合するようにします。

初回セットアップ

新しいプロジェクトで作業する際は、エージェントに「init project rules(プロジェクトルールを初期化)」と指示するだけです。これにより、エージェントはプロジェクトの特定の要件と構造に合わせて一連のルールを生成します。

タスク計画プロセス

機能を開発または更新するには、「plan task [説明]」コマンドを使用してください。システムは事前に確立されたルールを参照し、プロジェクトを理解しようと試み、関連するコードセクションを検索し、プロジェクトの現在の状態に基づいて包括的な計画を提案します。

フィードバックメカニズム

計画プロセス中、Shrimpはエージェントを複数の思考ステップに導きます。このプロセスを確認し、間違った方向に進んでいると感じた場合はフィードバックを提供できます。途中で中断して自分の見解を伝えるだけで、エージェントはあなたのフィードバックを取り入れ、計画プロセスを続行します。

タスク実行

計画に満足したら、「タスク実行 [タスク名またはID]」を使用して実行します。タスク名またはIDを指定しない場合は、システムが自動的に最も優先度の高いタスクを特定して実行します。

連続モード

各タスクを手動で介入せずにすべてのタスクを順番に実行したい場合は、「連続モード」を使用してタスク キュー全体を自動的に処理します。

トークン制限に関する注意事項

LLMトークンの制限により、長時間の会話中にコンテキストが失われる場合があります。その場合は、新しいチャットセッションを開き、エージェントに実行を続行するよう指示してください。システムは中断したところから再開するため、タスクの詳細やコンテキストを再度伝える必要はありません。

プロンプト言語とカスタマイズ

TEMPLATES_USE環境変数を設定することで、システムプロンプトの言語を切り替えることができます。デフォルトではen (英語) とzh (中国語繁体字) がサポートされています。さらに、既存のテンプレートディレクトリ (例: src/prompts/templates_en ) をDATA_DIRで指定した場所にコピーし、変更を加えた上で、 TEMPLATES_USEにカスタムテンプレートディレクトリ名を指定することもできます。これにより、プロンプトをより詳細にカスタマイズできます。詳細な手順については、こちらをご覧ください。

🧠 タスクメモリ機能

Shrimp Task Manager には長期記憶機能があり、タスク実行履歴を自動的に保存し、新しいタスクを計画するときに参照エクスペリエンスを提供します。

主な特徴

  • システムはタスクをメモリディレクトリに自動的にバックアップします
  • バックアップファイルは、tasks_backup_YYYY-MM-DDThh-mm-ss.json の形式で時系列順に命名されます。
  • タスク計画エージェントはメモリ機能の使用方法に関するガイダンスを自動的に受信します

利点とメリット

  • 重複作業を避ける: 過去のタスクを参照すれば、同様の問題を一から解決する必要はありません。
  • 成功体験から学ぶ:実証済みの効果的なソリューションを活用し、開発効率を向上
  • 学習と改善:過去の間違いや非効率的な解決策を特定し、ワークフローを継続的に最適化します
  • 知識の蓄積: システムの使用が増えるにつれて、継続的に拡大する知識ベースを形成します。

タスクメモリ機能を効果的に使用することで、システムは継続的に経験を蓄積し、知能レベルと作業効率を継続的に向上させることができます。

🤔 思考連鎖プロセス

Thought Chain 機能は、構造化された思考を通じて問題解決を強化します。

  • 体系的推論:複雑な問題を論理的なステップに分解する
  • 仮定テスト:解決策のアプローチを検証するために仮定を検証する
  • 批判的分析:厳格な基準で解決策の選択肢を評価する
  • 意思決定の改善:慎重な思考を通じてより信頼性の高い結論に到達する

有効にすると (デフォルト設定)、システムはprocess_thoughtツールを使用してエージェントを段階的に推論し、実装前に徹底的な問題分析を確実に実行します。

📋 プロジェクトルールの初期化

プロジェクト ルール機能は、コードベース全体の一貫性を維持するのに役立ちます。

  • 開発の標準化:一貫したコーディングパターンとプラクティスを確立する
  • 新規開発者のオンボード: プロジェクトへの貢献に関する明確なガイドラインを提供する
  • 品質の維持: すべてのコードが確立されたプロジェクト標準を満たしていることを確認する

⚠️ 推奨事項:プロジェクトの規模が拡大したり、大幅な変更があったりする場合は、プロジェクトルールを初期化してください。これにより、複雑さが増しても一貫性と品質を維持できます。

次の場合に、 init_project_rulesツールを使用してプロジェクト標準を設定または更新します。

  • 新たな大規模プロジェクトの開始
  • 新しいチームメンバーのオンボーディング
  • 主要なアーキテクチャ変更の実装
  • 新たな開発規約の採用

使用例

シンプルな自然言語コマンドを使用して、この機能に簡単にアクセスできます。

  • 初期設定の場合: エージェントに「init rules」または「init project rules」と伝えるだけです
  • 更新の場合: プロジェクトが進化したら、エージェントに「ルールを更新」または「プロジェクトルールを更新」と伝えます。

このツールは、コードベースが拡張されたり、大幅な構造変更が行われたりする場合、特に価値があり、プロジェクトのライフサイクル全体を通じて一貫した開発プラクティスを維持するのに役立ちます。

📚 ドキュメントリソース

🔧 インストールと使用方法

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Shrimp Task Manager を自動的にインストールするには:

npx -y @smithery/cli install @cjo4m06/mcp-shrimp-task-manager --client claude

手動インストール

# Install dependencies npm install # Build and start service npm run build

🔌 MCP 互換クライアントでの使用

Shrimp タスク マネージャーは、Cursor IDE などのモデル コンテキスト プロトコルをサポートする任意のクライアントで使用できます。

カーソルIDEでの設定

Shrimp タスク マネージャーには、グローバル構成とプロジェクト固有の構成という 2 つの構成方法があります。

グローバル構成
  1. Cursor IDE のグローバル設定ファイルを開きます (通常は~/.cursor/mcp.jsonにあります)
  2. mcpServersセクションに次の構成を追加します。
{ "mcpServers": { "shrimp-task-manager": { "command": "node", "args": ["/mcp-shrimp-task-manager/dist/index.js"], "env": { "DATA_DIR": "/path/to/project/data" // 必須使用絕對路徑 } } } } or { "mcpServers": { "shrimp-task-manager": { "command": "npx", "args": ["-y", "mcp-shrimp-task-manager"], "env": { "DATA_DIR": "/mcp-shrimp-task-manager/data" } } } }

⚠️ /mcp-shrimp-task-manager実際のパスに置き換えてください。

プロジェクト固有の構成

各プロジェクトに専用の構成を設定して、異なるプロジェクトに独立したデータ ディレクトリを使用することもできます。

  1. プロジェクトルートに.cursorディレクトリを作成する
  2. このディレクトリに次の内容のmcp.jsonファイルを作成します。
{ "mcpServers": { "shrimp-task-manager": { "command": "node", "args": ["/path/to/mcp-shrimp-task-manager/dist/index.js"], "env": { "DATA_DIR": "/path/to/project/data" // Must use absolute path } } } } or { "mcpServers": { "shrimp-task-manager": { "command": "npx", "args": ["-y", "mcp-shrimp-task-manager"], "env": { "DATA_DIR": "/path/to/project/data" // 必須使用絕對路徑 } } } }

⚠️ 重要な設定上の注意事項

DATA_DIRパラメータは、Shrimp Task Managerがタスクデータ、会話ログ、その他の情報を保存するディレクトリです。このパラメータを正しく設定することは、システムの正常な動作に不可欠です。このパラメータは絶対パスで指定する必要があります。相対パスを使用すると、システムがデータディレクトリを誤って検出し、データの損失や機能障害が発生する可能性があります。

警告: 相対パスを使用すると、次の問題が発生する可能性があります。

  • データファイルが見つからないため、システムの初期化に失敗しました
  • タスクのステータスが失われたり、正しく保存できなかったりする
  • 異なる環境間でのアプリケーションの動作が一貫していない
  • システムがクラッシュしたり起動に失敗したり

🔧 環境変数の設定

Shrimpタスクマネージャーは環境変数を介してプロンプトの動作をカスタマイズできるため、コードを変更することなくAIアシスタントの応答を微調整できます。これらの変数は、設定ファイルまたは.envファイルで設定できます。

{ "mcpServers": { "shrimp-task-manager": { "command": "node", "args": ["/path/to/mcp-shrimp-task-manager/dist/index.js"], "env": { "DATA_DIR": "/path/to/project/data", "MCP_PROMPT_PLAN_TASK": "Custom planning guidance...", "MCP_PROMPT_EXECUTE_TASK_APPEND": "Additional execution instructions...", "ENABLE_THOUGHT_CHAIN": "true", "TEMPLATES_USE": "en" } } } }

カスタマイズ方法は 2 つあります。

  • オーバーライドモードMCP_PROMPT_[FUNCTION_NAME] ):デフォルトのプロンプトを完全に置き換えます
  • 追加モードMCP_PROMPT_[FUNCTION_NAME]_APPEND ):既存のプロンプトにコンテンツを追加する

さらに、他のシステム構成変数もあります。

  • DATA_DIR : タスクデータが保存されるディレクトリを指定します
  • ENABLE_THOUGHT_CHAIN : タスク計画ワークフローにおける思考モデルを制御します。true trueデフォルト)に設定すると、システムはユーザーにprocess_thoughtツールを用いた段階的な推論を促します。false false設定すると、システムは詳細な思考プロセスを省略し、 analyze_taskを用いて直接分析結果を送信します。
  • TEMPLATES_USE : プロンプトに使用するテンプレートセットを指定します。デフォルトはenです。現在利用可能なオプションはenzhです。カスタムテンプレートを使用するには、 src/prompts/templates_enディレクトリをDATA_DIRで指定された場所にコピーし、コピーしたディレクトリの名前を変更し(例: my_templates )、 TEMPLATES_USEを新しいディレクトリ名(例: my_templates )に設定します。

サポートされているパラメータや例など、プロンプトのカスタマイズの詳細な手順については、 『プロンプト カスタマイズ ガイド』を参照してください。

💡 システムプロンプトガイダンス

カーソルIDE設定

カーソル設定 => 機能 => カスタム モードを有効にして、次の 2 つのモードを構成できます。

タスクプランナーモード
You are a professional task planning expert. You must interact with users, analyze their needs, and collect project-related information. Finally, you must use "plan_task" to create tasks. When the task is created, you must summarize it and inform the user to use the "TaskExecutor" mode to execute the task. You must focus on task planning. Do not use "execute_task" to execute tasks. Serious warning: you are a task planning expert, you cannot modify the program code directly, you can only plan tasks, and you cannot modify the program code directly, you can only plan tasks.
タスクエグゼキューターモード
You are a professional task execution expert. When a user specifies a task to execute, use "execute_task" to execute the task. If no task is specified, use "list_tasks" to find unexecuted tasks and execute them. When the execution is completed, a summary must be given to inform the user of the conclusion. You can only perform one task at a time, and when a task is completed, you are prohibited from performing the next task unless the user explicitly tells you to. If the user requests "continuous mode", all tasks will be executed in sequence.

💡 ニーズに応じて適切なモードを選択してください。

  • タスクを計画するときにTaskPlannerモードを使用する
  • タスクを実行するときはTaskExecutorモードを使用する

他のツールと併用する

ツールがカスタム モードをサポートしていない場合は、次の操作を実行できます。

  • さまざまな段階で適切なプロンプトを手動で貼り付けます
  • または、 Please plan the following task: ......Please start executing the task...などの単純なコマンドを直接使用します。

🛠️ 利用可能なツールの概要

設定後、次のツールを使用できます。

カテゴリツール名説明
タスク計画plan_taskタスクの計画を開始する
タスク分析analyze_taskタスク要件の詳細な分析
process_thought複雑な問題に対する段階的な推論
ソリューション評価reflect_taskソリューションコンセプトの反映と改善
プロジェクト管理init_project_rulesプロジェクトの標準とルールを初期化または更新する
タスク管理split_tasksタスクをサブタスクに分割する
list_tasksすべてのタスクとステータスを表示する
query_taskタスクの検索と一覧表示
get_task_detail完了したタスクの詳細を表示する
delete_task未完了のタスクを削除する
タスク実行execute_task特定のタスクを実行する
verify_taskタスクの完了を確認する
complete_taskタスクを完了としてマークする

🔧 技術的な実装

  • Node.js : 高性能な JavaScript ランタイム環境
  • TypeScript : 型安全な開発環境を提供します
  • MCP SDK : 大規模言語モデルとのシームレスなインタラクションを実現するインターフェース
  • UUID : ユニークで信頼できるタスク識別子を生成する

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

推奨モデル

最適なエクスペリエンスを得るには、次のモデルを使用することをお勧めします。

  • クロード 3.7 : 強力な理解力と生成能力を備えています。
  • Gemini 2.5 : Google の最新モデル、優れたパフォーマンスを発揮します。

モデル間の学習方法や理解能力の違いにより、同じプロンプトに対して異なるモデルを使用すると結果が異なる場合があります。このプロジェクトは、Claude 3.7およびGemini 2.5向けに最適化されています。

スターの歴史

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

MCP Shrimp Task Managerは、思考の連鎖、リフレクション、そしてスタイルの一貫性を重視したAIエージェント向けのタスクツールです。依存関係の追跡と反復的な改良により、自然言語を構造化された開発タスクに変換し、推論AIシステムにおいてエージェントのような開発者の行動を可能にします。

  1. MCP Shrimp Task Manager
    1. ✨ <a id="features1"></a>Features
    2. 🧭 <a id="usage-guide"></a>Usage Guide
    3. 🧠 <a id="task-memory-function"></a>Task Memory Function
    4. 🤔 <a id="thought-chain"></a>Thought Chain Process
    5. 📋 <a id="project-rules"></a>Project Rules Initialization
    6. 📚 <a id="documentation"></a>Documentation Resources
    7. 🔧 <a id="installation"></a>Installation and Usage
    8. 🔌 <a id="clients"></a>Using with MCP-Compatible Clients
    9. 💡 <a id="prompt"></a>System Prompt Guidance
    10. 🛠️ <a id="tools"></a>Available Tools Overview
    11. 🔧 Technical Implementation
    12. 📄 <a id="license"></a>License
    13. <a id="recommended"></a>Recommended Models
    14. Star History

Related MCP Servers

  • -
    security
    F
    license
    -
    quality
    An MCP server that enables AI agents to interact with Atlassian products (Confluence and Jira) for content management, issue tracking, and project management through a standardized interface.
    Last updated -
    2
    TypeScript
  • -
    security
    A
    license
    -
    quality
    AI-driven task management application that operates via MCP, enabling autonomous creation, organization, and execution of tasks with support for subtasks, priorities, and progress tracking.
    Last updated -
    Python
    MIT License
    • Linux
  • A
    security
    A
    license
    A
    quality
    An MCP server that supercharges AI assistants with powerful tools for software development, enabling research, planning, code generation, and project scaffolding through natural language interaction.
    Last updated -
    11
    6
    TypeScript
    MIT License
    • Linux
    • Apple
  • -
    security
    -
    license
    -
    quality
    An MCP server that provides a "think" tool enabling structured reasoning for AI agents, allowing them to pause and record explicit thoughts during complex tasks or multi-step tool use.
    Last updated -
    1
    Python
    MIT License

View all related MCP servers

ID: buebie25qp