Practices MCP Server

by agentience

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

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.

  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

        Related MCP Servers

        • 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
          • Linux
          • Apple
        • -
          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
        • 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
        • 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

        ID: ixsr6gq2bs