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:

Clean previous build artifacts
Build the package
Install the latest wheel using UV tool

Option 2: Manual process

First, build the package wheel:
python -m build
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

This server cannot be installed

-

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.

Practices MCP Server