Practices MCP Server

🚀 MCP サーバー実践規範

Model Context Protocol（MCP）サーバーで、開発実践を強制し自動化するためのツールを提供します。

🚀 クイックスタート

この MCP サーバーは、以下の開発実践を実施および自動化するためのツールを提供します。

• ブランチ名の検証
• バージョン管理
• プルリクエストの準備
• ライセンスヘッダーの管理
• プリコミットフックのインストール

📦 インストール

pip install mcp-server-practices

開発用のインストール方法：

pip install -e .

UV ツールの使用

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

オプション 1：install_full スクリプトの使用

# クリーンアップ、ビルド、一度にインストール
./install_full.sh

このスクリプトは以下の操作を実行します。

1. 以前のビルドアーティファクトをクリーンアップする
2. パッケージをビルドする
3. UV ツールを使用して最新の wheel ファイルをインストールする

オプション 2：手動手順

1. まず、パッケージの wheel ファイルをビルドします。

   python -m build
   

2. wheel ファイルを直接インストールします（ソースディレクトリではなく）。

   uv tool install dist/mcp_server_practices-0.3.0-py3-none-any.whl
   

⚠️ 重要提示

ソースディレクトリで uv tool install . コマンドを直接使用しないでください。これはファイルの損傷を引き起こす可能性があります。常に wheel ファイルを先にビルドしてください。

💻 使用例

MCP サーバーとして

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

# --from パラメータを使用してサーバーを起動
uvx --from mcp-server-practices practices [オプション]

# バージョン番号を表示
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 ツールとして

# CLI 機能にアクセス
uvx --from mcp-server-practices practices cli [コマンド] [オプション]

⚠️ 重要提示

直接 uvx mcp-server-practices cli で呼び出す機能は、将来のバージョンでサポートされる予定です。

ブランチコマンド

# ブランチ名を検証
uvx --from mcp-server-practices practices cli branch validate feature/ABC-123-description

# ブランチを作成
uvx --from mcp-server-practices practices cli branch create feature/ABC-123-description

Jira コマンド

# 問題の詳細を取得
uvx --from mcp-server-practices practices cli jira issue ABC-123

# 問題の状態を更新
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

📄 ライセンス

MIT