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サーバーの実践

開発プラクティスを実施するためのツールを提供するモデル コンテキスト プロトコル サーバー。

概要

この MCP サーバーは、次のような開発プラクティスの実施と自動化を支援するツールを提供します。

  • 支店名の検証
  • バージョン管理
  • PR準備
  • ライセンスヘッダー管理
  • コミット前のフックのインストール

インストール

pip install mcp-server-practices

開発インストールの場合:

pip install -e .

UVツールの使用

UV を使用してパッケージをグローバルにインストールする場合は、ファイルの破損を避けるために次の手順に従ってください。

オプション1: install_fullスクリプトを使用する

# Clean, build, and install in one step ./install_full.sh

このスクリプトは次のことを行います。

  1. 以前のビルド成果物をクリーンアップする
  2. パッケージをビルドする
  3. UVツールを使用して最新のホイールをインストールする

オプション2: 手動プロセス

  1. まず、パッケージ ホイールをビルドします。
    python -m build
  2. ホイールを直接インストールします (ソース ディレクトリの代わりに):
    uv tool install dist/mcp_server_practices-0.3.0-py3-none-any.whl

重要:ソースディレクトリで直接uv tool install .実行しないでください。ファイルが破損する可能性があります。必ず最初にホイールをビルドしてください。

使用法

MCPサーバーとして

サーバーは次の方法で呼び出すことができます。

# Run server using the --from parameter uvx --from mcp-server-practices practices [options] # Show version uvx --from mcp-server-practices practices --version

注: uvx mcp-server-practicesによる直接呼び出しのサポートは、将来のリリースで計画されています。

サーバーオプション

  • --log-level : ログレベルを設定する (DEBUG、INFO、WARNING、ERROR、CRITICAL)
  • --project-root : プロジェクトのルートディレクトリを指定する
  • --log-file : ファイルへのログ記録を有効にする(デフォルト)
  • --no-log-file : ファイルへのログ出力を無効にする
  • --log-file-path : カスタムログファイルパスを指定する

CLIツールとして

# Access CLI functionality uvx --from mcp-server-practices practices cli [command] [options]

注: uvx mcp-server-practices cliによる直接呼び出しのサポートは、将来のリリースで計画されています。

分岐コマンド

# 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 コマンド

# 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構成

"practices": { "command": "practices", "args": [ "--log-level", "ERROR" ], "disabled": false, "autoApprove": [ "validate_branch_name", "get_branch_info", "validate_version" ] }

発達

テスト

python -m pytest

ライセンスヘッダー

uvx --from mcp-server-practices practices cli headers add /path/to/your/source/directory

ライセンス

マサチューセッツ工科大学

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

標準化された Git ブランチ管理と Jira 統合のためのツールを提供する MCP サーバー。開発者は規則に従ってブランチを作成、検証し、Jira の問題と同期できます。

  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