Enhanced Dev Env

🚀 強化開発環境とMCPサーバー

この開発環境は、UVパッケージマネージャー、Openインタープリター（開発ブランチ）、およびモデルコンテキストプロトコルサーバーを備えた包括的な開発環境です。

✨ 主な機能

• UVパッケージマネージャーによる高速Pythonパッケージ管理
• 現代的なCLIツール（exa、bat、ripgrepなど）
• Oh My Zshと有用なプラグインを搭載したZshシェル
• 開発ツール（git、vim、tmuxなど）
• Rustベースのパフォーマンスツール
• DockerとVagrantの設定
• 最適化されたPython開発環境

🛠️ 含まれるツール

Pythonツール

• UVパッケージマネージャー
• IPython
• Black（コードフォーマッター）
• isort（インポートソートツール）
• mypy（型チェックツール）
• ruff（コードチェックツール）
• pytest（テストフレームワーク）
• debugpy（デバッグツール）
• pre-commit（プリコミットフック）

現代的なCLIツール

• exa（現代的なls代替ツール）
• bat（現代的なcat代替ツール）
• ripgrep（現代的なgrep代替ツール）
• fd-find（現代的なfind代替ツール）
• delta（git diff強化ツール）
• zoxide（スマートcdツール）
• starship（シェルプロンプトツール）
• dust（現代的なdu代替ツール）
• hyperfine（ベンチマークツール）

開発ツール

• Git
• Vim
• Tmux
• HTTPx
• Docker
• Docker Compose

🚀 クイックスタート

Dockerを使用する場合

# コンテナをビルドして起動
docker-compose up -d

# コンテナに入る
docker-compose exec dev zsh

# または実行コマンドを使用
docker-compose run --rm dev

Vagrantを使用する場合

# 仮想マシンを起動
vagrant up

# SSHで仮想マシンに入る
vagrant ssh

# 仮想マシンを破棄
vagrant destroy

📁 ディレクトリ構造

.
├── Dockerfile           # コンテナ定義ファイル
├── docker-compose.yml   # コンテナオーケストレーションファイル
├── Vagrantfile         # 仮想マシン定義ファイル
├── .zshrc              # シェル設定ファイル
├── workspace/          # あなたのプロジェクトディレクトリ
└── .config/
    └── uv/            # UV設定ディレクトリ

🔧 使用例

パッケージ管理

# パッケージをインストール
python-install pandas numpy

# 仮想環境を作成
venv-create

# 仮想環境をアクティブ化
venv-activate

# プロジェクトの依存関係をインストール
python-deps

開発ワークフロー

# 新しいプロジェクトを初期化
uv-init myproject

# テンプレートからプロジェクトを作成
uv-scaffold fastapi myapi

# テストを設定
uv-test-setup

# プロジェクト構造をチェック
uv-project-check

メンテナンス

# UVキャッシュをクリーンアップ
uv-clean

# 仮想環境を再構築
uv-venv-rebuild

# システムをチェック
uv-doctor

⚙️ カスタム設定

ローカル設定の追加

~/.zshrc.localを作成して、マシン固有の設定を行います。

# ローカル環境変数
export MY_VAR="value"

# ローカルエイリアス
alias myalias="mycommand"

UV設定の変更

~/.config/uv/uvconfig.tomlを編集します。

[cache]
最大容量 = "10GB"
共享 = true

[network]
并发下载数 = 8

🔍 トラブルシューティング

一般的な問題

1. パッケージインストール問題

   uv-clean
   uv-doctor
   

2. 仮想環境問題

   uv-venv-rebuild
   

3. パフォーマンス問題

   bench "your-command"  # hyperfineを使用してベンチマークテストを行う
   

📦 メンテナンス

コンテナの更新

# キャッシュを使用せずにコンテナを再構築して更新を取得
docker-compose build --no-cache

# 最新のベースイメージを取得
docker-compose pull

仮想マシンの更新

# 仮想マシンを更新
vagrant provision

# 仮想マシンイメージを更新
vagrant box update

🔒 セキュリティに関する注意事項

• コンテナは非rootユーザーで実行されます。
• SSHキーは読み取り専用でマウントされます。
• Git設定は読み取り専用でマウントされます。
• 最小限のベースイメージが使用されます。
• 定期的にセキュリティ更新を行ってください。