hatch-xclam 0.7.0.dev12

Package manager for the Cracking Shells ecosystem

Hatch

Hatch is the package manager for the Cracking Shells ecosystem, designed specifically for managing Model Context Protocol (MCP) servers. It handles complex dependency resolution across system packages, Python packages, Docker containers, and other Hatch packages — all in isolated environments.

The canonical documentation is at docs/index.md and published at https://hatch.readthedocs.io/en/latest/.

Quick start

Install from PyPI

pip install hatch-xclam

Verify installation:

hatch --version

Install from source

git clone https://github.com/CrackingShells/Hatch.git
cd Hatch
pip install -e .

Create your first environment and Hatch! MCP server package

# Create an isolated environment
hatch env create my_project

# Switch to it
hatch env use my_project

# Create a package template
hatch create my_mcp_server --description "My MCP server"

# Validate the package
hatch validate ./my_mcp_server

Deploy MCP servers to your tools

Add a Hatch package and automatically configure it on Claude Desktop and Cursor:

hatch package add ./my_mcp_server --host claude-desktop,cursor

Configure an arbitrary MCP server (non-Hatch package) on Claude Desktop:

# Local server with command and arguments
hatch mcp configure my-weather-server --host claude-desktop \
  --command python --args weather_server.py \
  --env-var API_KEY=your_key

# Remote server with URL
hatch mcp configure api-server --host gemini \
  --httpUrl https://api.example.com \
  --header Authorization="Bearer token"

List configured servers and hosts:

hatch mcp list servers
hatch mcp list hosts --detailed

Key features

• Environment isolation: Create separate workspaces for different projects
• Multi-type dependencies: Automatically resolve and install system packages, Python packages, Docker containers, and Hatch packages
• MCP host configuration: Deploy MCP servers to Claude Desktop, Cursor, VSCode, and other platforms
• Package validation: Ensure packages meet schema requirements before distribution
• Development-focused: Optimized for rapid development and testing of MCP server ecosystems

Documentation

• Full Documentation — Complete reference and guides
• Getting Started — Quick start for users
• CLI Reference — All commands and options
• Tutorials — Step-by-step guides from installation to package authoring
• MCP Host Configuration — Deploy to multiple platforms
• Developer Docs — Architecture, implementation guides, and contribution guidelines
• Troubleshooting — Common issues and solutions

Contributing

We welcome contributions! See the How to Contribute guide for details.

Quick start for developers

1. Fork and clone the repository
2. Install dependencies: pip install -e . and npm install
3. Create a feature branch: git checkout -b feat/your-feature
4. Make changes and add tests
5. Use conventional commits: npm run commit for guided commits
6. Run tests: python -m pytest tests/
7. Create a pull request

We use Conventional Commits for automated versioning. Use npm run commit for guided commit messages.

Getting help

• Search existing GitHub Issues
• Read Troubleshooting for common problems
• Check Developer Onboarding for setup help

License

This project is licensed under the GNU Affero General Public License v3 — see LICENSE for details.