Practices MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides tools for managing Git branches according to standardized conventions, including validating branch names, creating branches of different types (feature, bugfix, hotfix, release, docs), and retrieving branch information.

  • Integrates with Jira to fetch issue summaries for use in branch names and update issue status when creating branches, allowing for automated workflow transitions when development work begins.

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

-
security - not tested
A
license - permissive license
-
quality - not tested

An MCP server that provides tools for standardized Git branch management and Jira integration, allowing developers to create, validate branches according to conventions and synchronize with Jira issues.

  1. Overview
    1. Installation
      1. Using UV Tool
    2. Usage
      1. As an MCP Server
      2. As a CLI Tool
    3. MCP Configuration
      1. Development
        1. Testing
        2. License Headers
      2. License
        ID: ixsr6gq2bs