beans-mcp

リクエスト：

{ "prefix": "project" }

レスポンス（structuredContent）：

{ "initialized": true }

リクエスト：

{ "beanId": "bean-abc" }

リクエスト（複数の Beans）：

{ "beanIds": ["bean-abc", "bean-def"] }

レスポンス（structuredContent）：

{
  "bean": {
    "id": "bean-abc",
    "title": "Fix login timeout",
    "status": "todo",
    "type": "bug",
    "priority": "critical",
    "body": "...markdown...",
    "createdAt": "2025-12-01T12:00:00Z",
    "updatedAt": "2025-12-02T08:00:00Z"
  }
}

リクエスト：

{}

レスポンス（例）：

{ "archived": true, "archivedCount": 3 }

リクエスト：

{
  "title": "Add dark mode",
  "type": "feature",
  "status": "todo",
  "priority": "normal",
  "body": "Implement theme toggle and styles",
  "parent": "epic-123"
}

description は非推奨の別名として body の代わりに使用できます。

レスポンス（structuredContent）：

{
  "bean": {
    "id": "new-1",
    "title": "Add dark mode",
    "status": "todo",
    "type": "feature"
  }
}

リクエスト：

{
  "parent": "epic-123",
  "beans": [
    { "title": "Design mockups", "type": "task" },
    { "title": "Implement API", "type": "task", "priority": "high" },
    { "title": "Write tests", "type": "task", "parent": "epic-456" }
  ]
}

トップレベルの parent は、独自の parent が指定されていない Bean のデフォルトとして適用されます。ここでは、Design mockups と Implement API に epic-123 が割り当てられ、Write tests では epic-456 に上書きされます。

レスポンス（structuredContent）：

{
  "requestedCount": 3,
  "successCount": 3,
  "failedCount": 0,
  "results": [
    { "bean": { "id": "task-1", "title": "Design mockups" } },
    { "bean": { "id": "task-2", "title": "Implement API" } },
    { "bean": { "id": "task-3", "title": "Write tests" } }
  ]
}

リクエスト（タスクの一括移動で進行中にし、親を割り当てる場合）：

{
  "parent": "epic-123",
  "beans": [
    { "beanId": "task-1", "status": "in-progress" },
    { "beanId": "task-2", "status": "in-progress" },
    { "beanId": "task-3", "status": "in-progress", "parent": "epic-456" }
  ]
}

レスポンス（structuredContent）：

{
  "requestedCount": 3,
  "successCount": 3,
  "failedCount": 0,
  "results": [
    { "beanId": "task-1", "bean": { "id": "task-1", "status": "in-progress" } },
    { "beanId": "task-2", "bean": { "id": "task-2", "status": "in-progress" } },
    { "beanId": "task-3", "bean": { "id": "task-3", "status": "in-progress" } }
  ]
}

どちらの一括ツールもベストエフォートで動作します。バッチ全体を中断するのではなく、部分的な失敗が項目ごとに報告されます。

リクエスト（ステータスの変更とブロックの追加）：

{
  "beanId": "bean-abc",
  "status": "in-progress",
  "blocking": ["bean-def"],
  "ifMatch": "etag-value"
}

リクエスト（本文のアトミックな変更）：

{
  "beanId": "bean-abc",
  "bodyReplace": [
    { "old": "- [ ] Task 1", "new": "- [x] Task 1" },
    { "old": "- [ ] Task 2", "new": "- [x] Task 2" }
  ],
  "bodyAppend": "## Summary\n\nAll checklist items completed."
}

注：body（全体の置き換え）は、同じリクエスト内で bodyAppend または bodyReplace と併用できません。

レスポンス（structuredContent）：

{
  "bean": {
    "id": "bean-abc",
    "status": "in-progress",
    "blockingIds": ["bean-def"]
  }
}

リクエスト：

{ "beanId": "bean-old", "force": false }

レスポンス：

{ "deleted": true, "beanId": "bean-old" }

一括リクエスト：

{ "beanIds": ["bean-old", "bean-older"], "force": false }

一括レスポンス（概要）：

{
  "requestedCount": 2,
  "deletedCount": 2,
  "failedCount": 0,
  "results": [
    { "beanId": "bean-old", "deleted": true },
    { "beanId": "bean-older", "deleted": true }
  ]
}

リクエスト：

{
  "beanId": "bean-closed",
  "requiredCurrentStatus": "completed",
  "targetStatus": "todo"
}

レスポンス：

{ "bean": { "id": "bean-closed", "status": "todo" } }

リクエスト：

{ "beanId": "bean-abc" }

レスポンス：

{
  "bean": {
    "id": "bean-abc",
    "status": "todo"
  },
  "totalTaskCount": 5,
  "updatedTaskCount": 3,
  "unchangedTaskCount": 2
}

更新（すべての Bean を一覧表示）：

{ "operation": "refresh" }

レスポンス（一部）：

{ "count": 12, "beans": [] }

フィルター（ステータス／タイプ／タグ）：

{
  "operation": "filter",
  "statuses": ["in-progress", "todo"],
  "types": ["bug", "feature"],
  "tags": ["auth"]
}

検索（全文検索）：

{ "operation": "search", "search": "authentication", "includeClosed": false }

並べ替え（モード：status-priority-type-title、updated、created、id）：

{ "operation": "sort", "mode": "updated" }

準備完了（実行可能な Bean のみ）：

{ "operation": "ready" }

LLM コンテキスト（Copilot の指示を生成。ワークスペースへの書き込みは任意）：

{ "operation": "llm_context", "writeToWorkspaceInstructions": true }

レスポンス（structuredContent）：

{
  "graphqlSchema": "...",
  "generatedInstructions": "...",
  "instructionsPath": "/workspace/.github/instructions/beans-prime.instructions.md"
}

GraphQL の生データをそのまま渡す（beans query と同等の CLI）：

{
  "operation": "graphql",
  "graphql": "{ beans(filter: { type: [\"bug\"] }) { id title status } }"
}

変数を指定する場合：

{
  "operation": "graphql",
  "graphql": "query($q: String!) { beans(filter: { search: $q }) { id title } }",
  "variables": { "q": "authentication" }
}

リクエスト（読み取り）：

{ "operation": "read", "path": "beans-vscode-123--title.md" }

レスポンス：

{
  "path": "/workspace/.beans/beans-vscode-123--title.md",
  "content": "---\n...frontmatter...\n---\n# Title\n"
}

リクエスト（frontmatter のアトミックな更新）：

{
  "operation": "update_frontmatter",
  "path": "beans-vscode-123--title.md",
  "fields": {
    "status": "in-progress",
    "pr": "123",
    "branch": "feature/cascade-status-and-skills-npm"
  }
}

レスポンス：

{
  "path": "/workspace/.beans/beans-vscode-123--title.md",
  "bytes": 256,
  "updatedFields": ["status", "pr", "branch"],
  "frontmatter": {
    "status": "in-progress",
    "pr": "123",
    "branch": "feature/cascade-status-and-skills-npm"
  }
}

リクエスト（直近 200 行を読み取り）：

{ "operation": "read", "lines": 200 }

レスポンス：

{
  "path": "/workspace/.vscode/logs/beans-output.log",
  "content": "...log lines...",
  "linesReturned": 200
}