Snowfakery MCP

🚀 VS Code開發環境

本倉庫包含一個配置完善的VS Code開發環境，具備自動格式化、代碼檢查和類型檢查功能。

🚀 快速開始

本環境配置為使用 uv 進行Python包管理：

# 安裝依賴
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 中定義，僅適用於此工作區：

📦 Codespaces支持

在GitHub Codespaces中打開此倉庫時，環境會通過 .devcontainer/devcontainer.json 自動配置，並且 postCreate.sh 腳本會運行：

#!/bin/bash
set -e
echo "Installing dependencies with uv..."
uv sync
echo "✓ Ready to develop!"

💻 便攜使用

此配置具有完全的可移植性，可在以下環境中使用：

• ✅ 本地安裝 uv 的環境
• ✅ Codespaces（自動配置）
• ✅ 包含Python 3.12+的Docker容器
• ✅ 任何標準VS Code安裝環境 所有路徑均相對於工作區，配置使用標準VS Code設置。