Hatch Documentation¶

Overview¶

Hatch is a CLI tool for configuring MCP servers across AI host platforms. Instead of editing JSON config files for each tool separately, you register servers from the command line — once, on as many hosts as you need.

hatch mcp configure context7 --host claude-desktop,cursor,vscode \
  --command npx --args "-y @upstash/context7-mcp"

Hatch also has a package system for installing MCP servers with dependency isolation (Python, system packages, Docker). That part is still being developed and will eventually integrate with MCP registries.

Supported hosts: Claude Desktop, Claude Code, VS Code, Cursor, Kiro, Codex, LM Studio, Google Gemini CLI, Mistral Vibe, OpenCode, Augment Code (Auggie CLI and Intent).

Documentation Sections¶

For Users¶

Getting Started - Installation and first steps
MCP Host Configuration - Configure MCP servers across host platforms
Command Reference - Complete CLI reference
Tutorials - Step-by-step guides, including package authoring

For Developers¶

Comprehensive documentation for developers and contributors working on the Hatch codebase.

Architecture ¶

High-level system understanding and design patterns for developers getting familiar with the Hatch codebase.

System Overview - Introduction to Hatch's architecture
Component Architecture - Detailed component breakdown
MCP Host Configuration - Architecture for MCP host configuration management

Implementation Guides ¶

Technical how-to guides for implementing specific features and extending the system.

Adding New Installers - Implementing new dependency installer types
Registry Integration - Working with package registries
MCP Host Configuration Extension - Adding support for new MCP host platforms

Development Processes ¶

Workflow, standards, and processes for effective development on the Hatch project.

Developer Onboarding - Setting up your development environment
Testing Standards - Testing requirements and best practices

Contribution Guidelines ¶

Process-focused guidance for contributing to the Hatch project.

How to Contribute - General contribution workflow
Release Policy - Release management policies

Quick Links¶

GitHub Repository - Project repository
Hatchling Integration - Primary consumer of Hatch

Additional Resources¶

Reference Materials¶

Glossary - Key terms and definitions
State and Data Models - Data structures and state management

External Resources¶

Hatch Schemas - Package metadata schemas
Hatch Registry - Central package registry
Hatch Validator - Package validation tools

Getting Help¶

Search existing GitHub Issues
Create a new issue for bugs or feature requests