MCP Server Practices

A Model Context Protocol server that provides tools for enforcing development practices.

Overview

This MCP server provides tools to help enforce and automate development practices like:

• Branch name validation
• Version management
• PR preparation
• License header management
• Pre-commit hook installation

Installation

pip install mcp-server-practices

For development installation:

pip install -e .

Using UV Tool

If you want to install the package globally using UV, follow these steps to avoid file corruption:

Option 1: Using the install_full script

# Clean, build, and install in one step
./install_full.sh

This script will:

1. Clean previous build artifacts
2. Build the package
3. Install the latest wheel using UV tool

Option 2: Manual process

1. First, build the package wheel:

   python -m build
   

2. Install the wheel directly (instead of the source directory):

   uv tool install dist/mcp_server_practices-0.3.0-py3-none-any.whl
   

Important: Do not use uv tool install . directly on the source directory as it may result in corrupted files. Always build a wheel first.

Usage

As an MCP Server

The server can be invoked through the following method:

# Run server using the --from parameter
uvx --from mcp-server-practices practices [options]

# Show version
uvx --from mcp-server-practices practices --version

Note: Support for direct invocation via uvx mcp-server-practices is planned for a future release.

Server Options

• --log-level: Set logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
• --project-root: Specify the project root directory
• --log-file: Enable logging to a file (default)
• --no-log-file: Disable logging to a file
• --log-file-path: Specify a custom log file path

As a CLI Tool

# Access CLI functionality
uvx --from mcp-server-practices practices cli [command] [options]

Note: Support for direct invocation via uvx mcp-server-practices cli is planned for a future release.

Branch Commands

# Validate a branch name
uvx --from mcp-server-practices practices cli branch validate feature/ABC-123-description

# Create a branch
uvx --from mcp-server-practices practices cli branch create feature/ABC-123-description

Jira Commands

# Get issue details
uvx --from mcp-server-practices practices cli jira issue ABC-123

# Update issue status
uvx --from mcp-server-practices practices cli jira update ABC-123 "In Progress"

MCP Configuration

"practices": {
  "command": "practices",
  "args": [
    "--log-level",
    "ERROR"
  ],
  "disabled": false,
  "autoApprove": [
    "validate_branch_name",
    "get_branch_info",
    "validate_version"
  ]
}

Development

Testing

python -m pytest

License Headers

uvx --from mcp-server-practices practices cli headers add /path/to/your/source/directory

License

MIT