BRD Enhancer MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
pip install git+https://github.com/arushsingh17/mcp.git
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add -e "API_KEY=${API_KEY}" -e "PROJECT_ID=${PROJECT_ID}" brd-enhancer -- node "<FULL_PATH_TO_MCP>/dist/index.js"

Replace <FULL_PATH_TO_MCP>/dist/index.js with the actual folder you prepared in step 1.

Required:API_KEYPROJECT_ID+ 1 optional
README.md

Enhances developer tasks with context pulled from your project documentation.

brd-enhancer-mcp

An MCP server that enhances developer tasks with context pulled from your project documentation.


Prerequisites

⚠️ Use Official Python (NOT Microsoft Store Python)

Download Python from https://www.python.org/downloads/

During installation, make sure to check:

"Add Python to PATH"

Verify you have the correct Python:

where python
Output Status
C:\Python313\python.exe ✅ Official Python — Good
C:\Users\...\WindowsApps\python.exe ❌ Microsoft Store Python — Reinstall from python.org

Installation

Option A — Global Install (Recommended for most developers)

pip install git+https://github.com/arushsingh17/mcp.git

Verify installation:

pip show brd-enhancer-mcp
where brd-enhancer-mcp        # Windows
which brd-enhancer-mcp        # Mac/Linux

Option B — Virtual Environment Install

# Step 1: Create and activate a virtual environment
python -m venv venv
venv\Scripts\activate          # Windows
source venv/bin/activate       # Mac/Linux

# Step 2: Install the package
pip install git+https://github.com/arushsingh17/mcp.git

# Step 3: Get the exact executable path (needed for config)
python -c "import shutil; print(shutil.which('brd-enhancer-mcp'))"

Example output:

C:\Users\YourName\Desktop\myproject\venv\Scripts\brd-enhancer-mcp.exe

Copy this path — you will need it in the config below.


Configuration

🌍 Global Install Config

Since brd-enhancer-mcp is registered in system PATH, no file path is needed.

Claude Desktop%APPDATA%\Claude\claude_desktop_config.json (Windows) Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.json (Mac) Claude Code~/.claude.json

{
    "mcpServers": {
        "brd-enhancer": {
            "command": "brd-enhancer-mcp",
            "env": {
                "API_KEY": "your_api_key",
                "PROJECT_ID": "your_project_id",
                "API_URL": "https://your-backend.com"
            }
        }
    }
}

📦 Virtual Environment Config

Use the full path you got from the command above.

⚠️ On Windows replace every \ with \\ in the path

{
    "mcpServers": {
        "brd-enhancer": {
            "command": "C:\\Users\\YourName\\Desktop\\myproject\\venv\\Scripts\\brd-enhancer-mcp.exe",
            "env": {
                "API_KEY": "your_api_key",
                "PROJECT_ID": "your_project_id",
                "API_URL": "https://your-backend.com"
            }
        }
    }
}

Mac/Linux venv config:

{
    "mcpServers": {
        "brd-enhancer": {
            "command": "/Users/yourname/myproject/venv/bin/brd-enhancer-mcp",
            "env": {
                "API_KEY": "your_api_key",
                "PROJECT_ID": "your_project_id",
                "API_URL": "https://your-backend.com"
            }
        }
    }
}

Environment Variables

Variable Required Default Description
API_KEY ✅ Yes Your personal API key
PROJECT_ID ✅ Yes Your project ID/GUID
API_URL ❌ No http://localhost:8000 Backend URL

Quick Reference

Scenario Command in config
Global install (Official Python) "command": "brd-enhancer-mcp"
Global install (Microsoft Store Python) Full path from where brd-enhancer-mcp
Virtual environment (any OS) Full path from python -c "import shutil; print(shutil.which('brd-enhancer-mcp'))"

Environment Variables

API_KEYrequiredYour personal API key
PROJECT_IDrequiredYour project ID/GUID
API_URLBackend URL

Configuration

claude_desktop_config.json
{
    "mcpServers": {
        "brd-enhancer": {
            "command": "brd-enhancer-mcp",
            "env": {
                "API_KEY": "your_api_key",
                "PROJECT_ID": "your_project_id",
                "API_URL": "https://your-backend.com"
            }
        }
    }
}

Try it

Enhance this task description using context from my project documentation.
Generate a prompt for this feature request based on the technical details in my project docs.
Retrieve relevant context for the current task from the project documentation.

Frequently Asked Questions

What are the key features of BRD Enhancer?

Retrieves relevant context from project documentation. Integrates technical details into task descriptions. Generates enriched prompts for developer tasks. Connects to custom backend APIs for documentation retrieval.

What can I use BRD Enhancer for?

Automating the creation of detailed technical task descriptions. Ensuring developer tasks align with project documentation standards. Quickly pulling project-specific technical context into AI workflows.

How do I install BRD Enhancer?

Install BRD Enhancer by running: pip install git+https://github.com/arushsingh17/mcp.git

What MCP clients work with BRD Enhancer?

BRD Enhancer works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep BRD Enhancer docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare