MCP Server for Backlog.md

This project provides an MCP (Model Context Protocol) server for the backlog.md CLI tool. It allows language models to interact with backlog.md to manage tasks, boards, and other project artifacts.

Getting Started

Prerequisites

• Node.js
• (Optional) This MCP Server uses npx but you can install backlog.md CLI tool globally (npm i -g backlog.md)
• Backlog.md initialization

Installation

VS Code

{
  "servers": {
    "mcp-backlog-md": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-backlog-md"]
    }
  }
}

Cline

{
  "mcpServers": {
    "mcp-backlog-md": {
      "command": "npx",
      "args": ["-y", "mcp-backlog-md"],
      "disabled": false,
      "autoApprove": [],
      "timeout": 30
    }
  }
}

Usage

Testing

To manually test the server with a client, you can use the MCP inspector:

npm run inspector

CI/CD

This project uses GitHub Actions to automate the build, test, and release process.

• Build and Test: On every push or pull request to the main and develop branches, the workflow in .github/workflows/build.yml is triggered. It installs dependencies, lints the code, builds the project, and runs the tests.
• Pull Request Creation: If a build on the develop branch is successful, a pull request is automatically created to merge develop into main.
• Release and Publish: When a push is made to the main branch, a new GitHub Release is created with a tag corresponding to the version in package.json. This, in turn, triggers the .github/workflows/publish.yml workflow to publish the package to the npm registry.

Development

For detailed information on the project structure, development workflow, and how to contribute, please see the Developer Guide.

📊 mcp-backlog-md Project Status (1.7.1)

This board was automatically generated by Backlog.md

Generated on: 2025-08-05 12:00:33

| To Do | | --- | | TASK-8 - Bug: export_board command fails with 'unknown command export'#bug #tool-issue |