Snowfakery MCP

🚀 VS Code開発環境

このリポジトリには、自動フォーマット、リンティング、型チェックが設定された完全なVS Code環境が含まれています。

🚀 クイックスタート

この環境は、Pythonパッケージ管理にuvを使用するように構成されています。

# 依存関係のインストール
uv sync

# またはCodespacesを使用する場合、postCreate.shが自動的にこれを行います

✨ 主な機能

保存時の自動処理

• フォーマット: 保存時にRuffフォーマッターが実行されます
• リンティング: Ruffリンターがコードスタイルをチェックします
• インポート: Ruffがインポートを整理します
• 型チェック: Pylanceがリアルタイムの型チェックを提供します（厳格モード）

利用可能なタスク

VS Codeのコマンドパレット (Cmd+Shift+P / Ctrl+Shift+P) を開き、「Tasks: Run Task」を検索します。

• 依存関係のインストール (uv) — すべての開発用依存関係をインストールします
• Ruffでフォーマット — コードベース全体をフォーマットします
• Ruffでリンティング — リンティングの問題をチェックします
• mypyで型チェック — ソースコードに対してmypyを実行します
• すべてのチェック — フォーマットチェック + リンティング + 型チェックを実行します
• テストの実行 — pytestスイートを実行します
• カバレッジ付きでテストを実行 — カバレッジレポートを生成します
• MCPサーバーを実行 — MCPサーバーを起動します

デバッグ設定

.vscode/launch.jsonには、以下のデバッグ設定が含まれています。

• Python: MCPサーバー — MCPサーバーをデバッグします
• Python: Pytest — 現在のテストファイルをデバッグします
• Python: Pytest (すべて) — すべてのテストをデバッグします

デバッグを開始するには、F5を押すか、サイドバーのデバッグアイコンをクリックします。

拡張機能

推奨の拡張機能は.vscode/extensions.jsonに記載されており、ワークスペースを開くと提案されます。

主要な拡張機能:

• Python - 公式のPythonサポート
• Pylance - 高度な型チェックと言語機能
• Ruff - 高速なPythonリンターとフォーマッター
• Debugpy - Pythonデバッガー

設定

設定は.vscode/settings.jsonで定義されており、このワークスペースにのみ適用されます。

• 対象Python: 3.12
• 行の長さ: 100文字
• 型チェック: 厳格モード
• フォーマッター: Ruff
• リンター: isortと統合されたRuff

📦 Codespacesにおける設定

このリポジトリをGitHub Codespacesで開くと、.devcontainer/devcontainer.jsonを介して環境が自動的に構成され、postCreate.shスクリプトが実行されます。

#!/bin/bash
set -e
echo "uvで依存関係をインストールしています..."
uv sync
echo "✓ 開発を開始できます！"

💻 ポータブルな使用方法

この設定は完全にポータブルで、以下の環境で動作します。

• ✅ uvがインストールされたローカル環境
• ✅ Codespaces（自動構成）
• ✅ Python 3.12以上がインストールされたDockerコンテナ
• ✅ 標準のVS Codeインストール環境

すべてのパスはワークスペース相対であり、設定には標準のVS Code設定が使用されています。