Backlog MCP Server

Instructions

Implementation Reference

• packages/server/src/tools/backlog-delete.ts:5-19 (handler)

  Main handler implementation for backlog_delete tool. Registers the tool with the MCP server, defines the input schema (requiring an 'id' string parameter), and executes the delete operation by calling storage.delete(id) and returning a confirmation message.

  export function registerBacklogDeleteTool(server: McpServer) {
    server.registerTool(
      'backlog_delete',
      {
        description: 'Delete an item permanently.',
        inputSchema: z.object({
          id: z.string().describe('Task ID to delete'),
        }),
      },
      async ({ id }) => {
        storage.delete(id);
        return { content: [{ type: 'text', text: `Deleted ${id}` }] };
      }
    );
  }

• packages/server/src/tools/index.ts:6-15 (registration)

  Registration of backlog_delete tool. Imports registerBacklogDeleteTool and calls it within the registerTools function to make the tool available on the MCP server.

  import { registerBacklogDeleteTool } from './backlog-delete.js';
  import { registerBacklogSearchTool } from './backlog-search.js';
  import { registerBacklogContextTool } from './backlog-context.js';
  
  export function registerTools(server: McpServer) {
    registerBacklogListTool(server);
    registerBacklogGetTool(server);
    registerBacklogCreateTool(server);
    registerBacklogUpdateTool(server);
    registerBacklogDeleteTool(server);

• packages/server/src/storage/backlog-service.ts:139-143 (helper)

  Storage delete implementation. The delete method performs the actual deletion from TaskStorage and removes the document from the search index if search is ready. Returns a boolean indicating success.

  delete(id: string): boolean {
    const deleted = this.taskStorage.delete(id);
    if (deleted && this.searchReady) this.search.removeDocument(id);
    return deleted;
  }

• packages/server/src/operations/types.ts:12-12 (schema)

  Type definition for backlog_delete as part of the ToolName union type, which includes all write tools (backlog_create, backlog_update, backlog_delete, write_resource).

  export type ToolName = 'backlog_create' | 'backlog_update' | 'backlog_delete' | 'write_resource';

• packages/server/src/operations/middleware.ts:9-14 (registration)

  Middleware event mapping for backlog_delete. Maps the tool to the 'task_deleted' event type, which is emitted via the event bus when the tool executes to notify subscribers of the deletion.

  const TOOL_EVENT_MAP: Record<ToolName, BacklogEventType> = {
    backlog_create: 'task_created',
    backlog_update: 'task_changed',
    backlog_delete: 'task_deleted',
    write_resource: 'resource_changed',
  };