nova.mcp-bcp-counting

MCP Server for BCP Plus complexity counting — 10 functional + 3 non-functional dimensions.

Built on the BCP Plus methodology (CI&T, May 2026). Enables Claude to guide developers through structured complexity estimation during planning or coding sessions in VSCode, Claude Code, and Cursor.

What it does

When a developer asks Claude to count BCP for a story, Claude automatically:

1. Assesses story maturity — warns if the story is too vague to count reliably

2. Counts each dimension in isolation — 1 prompt per dimension, reducing cross-dimensional interference (per whitepaper recommendations)

3. Calculates BCP Plus total — Functional BCP + NFR BCP + NFR Ratio + risk classification

4. Persists the result — saves to .bcp/counts.json in the project for H/BCP tracking

Related MCP server: DevPlan MCP Server

Quick start

Prerequisites

• Node.js ≥ 18

• One of: VSCode, Claude Code, or Cursor

Install

# Clone and build
git clone https://github.com/danielvm-git/nova.mcp-bcp-counting.git
cd nova.mcp-bcp-counting
npm install
npm run build

# Install for your platform
node dist/installer/install.js --platform vscode       # VSCode
node dist/installer/install.js --platform claude-code  # Claude Code
node dist/installer/install.js --platform cursor       # Cursor

# Or interactive (asks which platform)
node dist/installer/install.js

Use

Open a story file or paste it in the chat, then ask Claude:

Count the BCP Plus for this story.

Decompose this epic into stories and estimate the BCP for each.

Show me the project BCP metrics so far.

The 13 dimensions

Functional (D01–D10) — inherited from BCP open-source release

Non-functional (D11–D13) — BCP Plus exclusive

CV% = coefficient of variation from the 43-story empirical baseline (CI&T Flow team, April 2026).
D04 and D05 are flagged as LOW CONFIDENCE in all outputs — always validate with the team.

Fibonacci scale

NFR Ratio risk levels

Available MCP tools

Story maturity and counting reliability

Story maturity is the strongest predictor of counting accuracy:

A story reaches maturity 3+ when it has:

• A defined actor

• Clear acceptance criteria (Given/When/Then)

• Business value stated

• Key entities named

Project metrics

After counting stories, BCP data is saved locally in .bcp/counts.json:

{
  "project": "my-project",
  "summary": {
    "story_count": 12,
    "total_bcp": 148,
    "avg_bcp_per_story": 12.3,
    "avg_nfr_ratio_pct": 18.5
  },
  "stories": [...]
}

Use total_bcp + actual delivery hours to compute H/BCP (hours per BCP point) — the key productivity indicator for AI-augmented teams.

Platform config files generated

References

• BCP Plus Whitepaper — Daniel Vieira Magalhães, CI&T, May 2026

• ScopeCounting — related scope counting tooling

• BCP open-source release — CI&T & Itaú Unibanco, MIT License, May 2026

License

MIT — © CI&T