An MCP server for executing tasks one by one in a defined pipeline
Server has 4 tools with complete input schemas and descriptions present. Naming follows verb_noun convention (create_pipeline, start_task, complete_task, get_status). Descriptions are detailed and include Japanese context guidance, but are verbose (200-400+ chars, exceeding the 10-200 char baseline for LLM optimization). Schemas are properly typed with object/string/integer/array. However, descriptions are written as procedural instructions rather than concise tool-selection guidance. Output schemas are not documented. Error handling is minimal, no recovery guidance or error categorization visible. The next_action pattern is implemented but not formally annotated in tool definitions.
【いつ使うか】 - タスクの実行が完了したとき - ユーザーが「次へ」「完了」と言ったとき 【LLMへの指示】 - pipeline_id: 対象のパイプラインID - task_id: 完了させるタスクのID(start_task のレスポンスに含まれる task_id を使うこと) - output: タスクの実行結果(生成した設計書・コード・レビュー内容など)を文字列で渡すこと
【いつ使うか】 ユーザーが「●●というパイプラインを作成して」「以下のタスクを順番に実行して」と言ったとき、最初に1回だけ呼ぶ。 パイプラインと全タスクをまとめて登録する。 【返却後の処理】 このツールの返却値には pipeline_id, name, total_tasks, tasks_summary が含まれます。 ★重要★ 返却後は、この情報をもとにパイプラインの全体像(名前・タスク数・各タスクのタイトル一覧)をユーザーに説明してください。 ユーザーが「開始」と言ったら、その後に start_task を呼んでください。 【パラメータ】 - name: パイプラインの名前(例: "設計→コード生成フロー") - description: パイプラインの説明(省略可) - tasks: タスクのリスト。各タスクに order, title, prompt を含める - order: タスクの順番(1始まりの整数) - title: タスクのタイトル(例: "設計書作成") - prompt: このタスクでLLMが実行すべき指示内容(具体的なプロンプト)
【いつ使うか】 - 会話が途切れた後にパイプラインを再開するとき - ユーザーが「今どこまで進んだ?」「進捗を教えて」と聞いたとき - どの pipeline_id を使えばいいか分からなくなったとき - pipeline_id を省略した場合は全パイプラインの一覧を返す 【LLMへの指示】 - pipeline_id を指定すると特定パイプラインの進捗詳細を返す - 省略すると登録済み全パイプラインの概要一覧を返す
【いつ使うか】 - ユーザーが「パイプライン開始」「次のタスクへ」と言ったとき - complete_task の next_action に従って次のタスクを開始するとき 【LLMへの指示】 - pipeline_id: create_pipeline で返却された pipeline_id - task_order: 開始するタスクの順番(1始まりの整数) - 返却された prompt に従ってタスクを実行すること - previous_task_output が含まれている場合は、前タスクの結果を踏まえてタスクを実行すること
Descriptions are procedural instructions (200-400+ chars) rather than concise tool-selection guidance. LLM-optimized descriptions should be 50-200 chars, stating WHAT the tool does and WHEN to use it, not HOW to use it step-by-step.
Output schemas are not documented. Callers cannot predict what fields to expect (e.g., does create_pipeline return pipeline_id, name, total_tasks, tasks_summary?). LLMs need documented return types to plan downstream calls.
No error handling guidance. Error responses do not tell the LLM what to do next (retry, ask user, or fail). No error categorization (retryable vs user-fixable vs fatal).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | 2026-07-28+ | v2 |
Tool annotations (readOnlyHint, destructiveHint, idempotentHint) are not declared. create_pipeline and complete_task are destructive (WRITE risk noted), but this is not formally signaled in the tool definition.
Parameter 'tasks' in create_pipeline is an array of objects with nested properties (order, title, prompt), but the nested object schema lacks explicit type declarations for each property (should be 'type': 'integer', 'type': 'string', etc.).