Backlog.md MCP Implementation (MVP)
This directory exposes a minimal stdio MCP surface so local agents can work with backlog.md without duplicating business logic.
What’s included
server.ts/createMcpServer()– bootstraps a stdio-only server that extendsCoreand registers task and document tools (task_*,document_*) for MCP clients.tasks/– consolidated task tooling that delegates to shared Core helpers (including plan/notes/AC editing).documents/– document tooling layered onCore’s document helpers for list/view/create/update/search flows.tools/dependency-tools.ts– dependency helpers reusing shared builders.resources/– lightweight resource adapters for agents.guidelines/mcp/– task workflow content surfaced via MCP.
Everything routes through existing Core APIs so the MCP layer stays a protocol wrapper.
Development workflow
# Run the stdio server from the repo
bun run cli mcp start
# Or via the globally installed CLI
backlog mcp start
# Tests
bun test src/test/mcp-*.test.ts
The test suite keeps to the reduced surface area and focuses on happy-path coverage for tasks, dependencies, and server bootstrap.