backlog-prr-mcp

MCP Server for automatically reviewing Nulab Backlog Git Pull Requests. An LLM client (like Claude Desktop) uses this server's tools to fetch open PRs, read local Git diffs, and post code review comments back to Backlog.

Prerequisites

• Node.js 18+
• A Nulab Backlog account with API key
• A local git clone of the target repository

Setup

npm install
npm run build

Credential Configuration

Credentials are stored in ~/.backlog-prr-mcp.json and managed via the setup_credentials MCP tool.

On first use, the LLM client will be prompted to call setup_credentials with the following parameters:

| Parameter | Description | |---|---| | spaceUrl | Your Backlog space URL (e.g. https://your-space.backlog.com) | | apiKey | Your Backlog API key | | projectKey | Project key (e.g. MYPROJECT) | | repoName | Repository name |

After setup, credentials persist across sessions. To update credentials, call setup_credentials again.

MCP Tools

| Tool | Description | |---|---| | setup_credentials | Saves Backlog credentials (spaceUrl, apiKey, projectKey, repoName) | | list_open_prs | Fetches open Pull Requests from Backlog | | get_local_git_diff | Runs git diff between base and head branches locally | | post_review_comment | Posts a Markdown review comment to a Backlog PR |

Claude Desktop Configuration

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "backlog-prr": {
      "command": "node",
      "args": ["/absolute/path/to/backlog-prr-kit/dist/index.js"]
    }
  }
}

Note: You should run Claude Desktop from the local git clone of your target repository (or set cwd to it), so that get_local_git_diff can execute git fetch and git diff correctly.