Practices MCP Server

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

license - permissive license

quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

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.

Related MCP Servers

GitHub MCP Server Plus
PhialsBasement
A
security
F
license
A
quality
MCP Server for the GitHub API, providing features for file operations, repository management, and advanced search, with automatic branch creation and comprehensive error handling.
Last updated -
18
4
3
TypeScript
Git Forensics MCP
davidorex
-
security
A
license
-
quality
A specialized MCP server for in-depth analysis of git repositories, offering tools for branch overview, time period analysis, file changes, and merge recommendations.
Last updated -
4
1
JavaScript
Apache 2.0
Gitee
normal-coder
A
security
A
license
A
quality
MCP Tool Server for Gitee, supporting the management of repository files/branches, Issues, and Pull Requests.
Last updated -
20
10
4
TypeScript
MIT License
Git MCP
kjozsa
A
security
F
license
A
quality
MCP server for managing Git operations on local repositories, allowing users to list repositories, get and create tags, list commits, push tags, and refresh repositories through a standardized interface.
Last updated -
6
Python

View all related MCP servers