UNPKG

mcp-backlog-md

Version:

An MCP (Model Context Protocol) server for the backlog.md CLI tool.

50 lines (33 loc) • 3.03 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
--- id: task-3 title: Update Tool Schemas to Match CLI Definitions status: Done assignee: - Cline created_date: '2025-07-24' updated_date: '2025-07-24' labels: - refactor - schema - mcp dependencies: [] priority: high --- ## Description Analyze docs/cli.ts and update all tool schemas in src/tools to accurately reflect the commands, options, and descriptions defined in the CLI. ## Acceptance Criteria - [x] - All tool schemas in `src/tools` match their corresponding command definitions in `docs/cli.ts` - [x] - Descriptions for all tool parameters are present and accurate - [x] - The `mcp-inspector` tool shows the updated and correct schemas for all tools. ## Implementation Plan 1. **Analyze `docs/cli.ts`:** Thoroughly read `docs/cli.ts` to create a complete map of all `commander` commands, aliases, options, and descriptions.\n2. **Review Existing Tools:** Systematically review each file in the `src/tools/` directory.\n3. **Identify Gaps:** For each tool, compare its current Zod schema against the command definition in `docs/cli.ts`. Note any missing options, incorrect types, or inadequate descriptions.\n4. **Update `editTask.ts`:**\n - Read the file `src/tools/editTask.ts`.\n - Update its Zod schema to include all options from `task edit` command (`--title`, `--description`, `--assignee`, `--status`, `--label`, `--priority`, `--add-label`, `--remove-label`, `--ac`, `--plan`, `--notes`, `--depends-on`).\n - Add detailed descriptions for each option.\n - Verify the `execute` function handles the new options.\n5. **Update `createTask.ts`:**\n - Read the file `src/tools/createTask.ts`.\n - Update its Zod schema to match the `task create` command.\n - Ensure all options are correctly typed and described.\n6. **Update Remaining Tools:** Repeat the process for all other tools in the `src/tools` directory, ensuring each one perfectly matches its corresponding CLI command. ## Implementation Notes Started work on task. First step is to update schema and execution logic. Started work on task. First step is to update `createTask.ts` schema and execution logic. Updated `src/tools/createTask.ts` to align its Zod schema and execution logic with the CLI definitions. The schema now includes detailed descriptions and uses the primary option names. Updated `src/tools/editTask.ts` to align its Zod schema and execution logic with the CLI definitions. The schema now includes all available options from the `task edit` command. Updated `src/tools/listTasks.ts` to include the `priority` and `sort` options, aligning it with the CLI definitions. Updated `src/tools/createDraft.ts` to include `description`, `assignee`, `status`, and `labels` options, aligning it with the CLI definitions. Updated `src/tools/listDocs.ts` to include the `plain` option, aligning it with the CLI definitions. Updated `src/tools/exportBoard.ts` to include the `readme` and `exportVersion` options, aligning it with the CLI definitions. Completed all schema updates for the tools. Total time spent: ~8 minutes.