Django Migrations

🚀 Django マイグレーション MCP サービス

Django マイグレーション MCP（Migration Control Panel）サービスは、Django プロジェクトのデータベースマイグレーションを管理するためのツールです。完全な API とコンソールインターフェースを提供し、データベースマイグレーションのプロセスを簡素化します。

✨ 主な機能

• 統一されたコントロールパネル：シンプルな HTTP インターフェースを通じて、すべてのマイグレーション操作を管理します。
• 自動化プロセス：未適用のマイグレーションを自動検出し、実行します。
• ログ記録とトラッキング：各操作と結果を詳細に記録し、デバッグと監査を容易にします。
• 拡張性：カスタムコマンドとプラグインをサポートします。

📦 インストール

開発環境

# リポジトリをクローンする
git clone git@github.com:your-repository.git
cd django-migration-mcp

# 仮想環境を作成し、依存関係をインストールする
python -m venv env
source env/bin/activate  # Windows では .\env\Scripts\activate を使用
pip install -r requirements.txt

本番環境

# サービスをインストールする（リポジトリをクローン済みと仮定）
sudo systemctl enable simple_http_server
sudo systemctl start simple_http_server

💻 使用例

基本的な使用法

Django プロジェクトの設定

Django プロジェクトの settings.py に以下の設定を追加します。

MIGRATION_MCP_ENABLED = True
MIGRATION_MCP_URL = 'http://localhost:8000'  # 実際の状況に合わせて変更

コマンドラインツール

MCP サービスはコマンドラインから直接使用できます。

# ヘルプ情報を表示する
python manage.py migration_mcp --help

# すべての未適用のマイグレーションを実行する
python manage.py migrate_all

# 指定したアプリケーションのマイグレーションを実行する
python manage.py migrate app_name

# 最後のマイグレーションをロールバックする
python manage.py rollback

# 現在のデータベースの状態を表示する
python manage.py show_migrations

高度な使用法

API ドキュメント

リクエスト形式

すべてのリクエストは /mcp エンドポイントに POST メソッドで送信する必要があり、JSON 形式の本文を含める必要があります。

{
    "method": "メソッド名",
    "params": {
        "パラメータ1": 値,
        "パラメータ2": 値
    }
}

具体的なインターフェース

1. すべてのマイグレーションをリストする

curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{"method": "list_migrations"}'

2. 指定したアプリケーションのマイグレーションを実行する

curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{"method": "migrate", "params": {"app": "your_app"}}'

3. 指定したアプリケーションのマイグレーションをロールバックする

curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{"method": "rollback", "params": {"app": "your_app"}}'

📚 ドキュメント

高度な機能

Redis 統合

Redis を統合することで、より効率的なマイグレーション管理と状態トラッキングを実現できます。

ログシステム

組み込みのログ記録モジュールは、開発者が問題を迅速に特定するのに役立ちます。ログファイルはデフォルトで mcp_logs/ ディレクトリに保存されます。

セキュリティ対策

• 認証：基本認証と Token 認証をサポートします。
• 権限制御：ユーザーごとに異なる操作権限を設定できます。

Docker 使用ガイド

クイックスタート

docker run -d --name django-migration-mcp \
  -e DJANGO_SETTINGS_MODULE=your_project.settings \
  -p 8000:8000 \
  your-django-mcp-image

インタラクティブ環境に入る

docker exec -it django-migration-mcp /bin/bash

ネットワーク構成

ネットワークを作成する

docker network create mcp-network

ネットワークに接続する

docker network connect mcp-network your-container-name

監視とメンテナンス

ログ監視

docker logs -f django-migration-mcp

自動再起動ポリシー

起動コマンドに再起動ポリシーを追加します。

docker run --restart unless-stopped ...

FAQ

1. マイグレーションの競合をどのように処理しますか？

   • settings.py で競合検出機能を有効にします。

2. 複数のアプリケーションのマイグレーションを一括で実行するにはどうすればいいですか？

   • migrate_all コマンドを使用するか、API を介して一括で呼び出します。

3. マイグレーションの履歴をどのように確認しますか？

   • show_migrations コマンドを使用するか、ログファイルを照会します。

貢献ガイド

コミュニティからのコードとドキュメントの貢献を歓迎します！リポジトリを Fork し、Pull Request で変更内容を明記してください。

📄 ライセンス

このプロジェクトは MIT ライセンスに準拠しています。