MCP 서버 연습

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

How are these scores calculated?

hybrid server

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

표준화된 Git 브랜치 관리 및 Jira 통합을 위한 도구를 제공하는 MCP 서버로, 개발자가 규칙에 따라 브랜치를 만들고 검증하며 Jira 이슈와 동기화할 수 있도록 해줍니다.

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
0
4
TypeScript
Git Forensics MCP
davidorex
A
security
A
license
A
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
630
7
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
3
Python

View all related MCP servers

Practices MCP Server