Snowfakery MCP

🚀 VS Code Development Environment

This repository provides a fully configured VS Code environment that supports automatic formatting, linting, and type checking, streamlining your development process.

🚀 Quick Start

The environment is configured to work with uv for Python package management:

# Install dependencies
uv sync

# Or if using Codespaces, the postCreate.sh will do this automatically

✨ Features

Automatic on Save

• Format: The Ruff formatter runs automatically when you save your code.
• Lint: The Ruff linter checks your code style.
• Imports: Ruff organizes your imports.
• Type Check: Pylance offers real - time type checking in strict mode.

Available Tasks

Open the VS Code Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "Tasks: Run Task":

• Install dependencies (uv) — Install all development dependencies.
• Format with Ruff — Format the entire codebase.
• Lint with Ruff — Check for linting issues.
• Type check with mypy — Run mypy on the source code.
• Check all — Run format check, lint, and type check.
• Run tests — Run the pytest test suite.
• Run tests with coverage — Generate a coverage report.
• Run MCP server — Start the MCP server.

Debug Configurations

The .vscode/launch.json file includes the following debug configurations:

• Python: MCP Server — Debug the MCP server.
• Python: Pytest — Debug the current test file.
• Python: Pytest (all) — Debug all tests.

To start debugging, press F5 or click the Debug icon in the sidebar.

Extensions

Recommended extensions are listed in .vscode/extensions.json, and they will be suggested when you open the workspace. Key extensions:

• Python - Official Python support.
• Pylance - Advanced type checking and language features.
• Ruff - Fast Python linter and formatter.
• Debugpy - Python debugger.

Configuration

The settings are defined in .vscode/settings.json and only apply to this workspace:

📦 Codespaces

When opening this repo in GitHub Codespaces, the environment is automatically configured via .devcontainer/devcontainer.json, and the postCreate.sh script runs:

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

💻 For Portable Use

The configuration is fully portable and can be used in various environments:

• ✅ Locally with uv installed.
• ✅ In Codespaces (automatically configured).
• ✅ In Docker containers with Python 3.12+.
• ✅ With any standard VS Code installation.

All paths are workspace - relative, and the configuration uses standard VS Code settings.