docs(README): Updating

Author: LittleCoinCoin

README.md

@@ -2,20 +2,23 @@
 
 ![Hatch Logo](./docs/resources/images/Logo/hatch_wide_dark_bg_transparent.png)
 
-Hatch is the package manager for the Cracking Shells ecosystem. The documentation in `docs/index.md` is the canonical, up-to-date entry point for users and contributors — this README is a short pointer to those resources.
+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.
 
-## Quick links
+The canonical documentation is at `docs/index.md` and published at <https://hatch.readthedocs.io/en/latest/>.
 
-The major documentation entry points are:
+## Quick start
 
-- Documentation (canonical): `docs/index.md`
-- Getting started (users): `docs/articles/users/GettingStarted.md`
-- CLI reference: `docs/articles/users/CLIReference.md`
-- Developer docs and architecture: `docs/articles/devs/index.md`
+### Install from PyPI
 
-But, really, just look at the site: <https://crackingshells.github.io/Hatch/>
+```bash
+pip install hatch-xclam
+```
 
-## Quick start
+Verify installation:
+
+```bash
+hatch --version
+```
 
 ### Install from source
 
@@ -25,52 +28,90 @@ cd Hatch
 pip install -e .
 ```
 
-Verify installation:
+### Create your first environment and *Hatch!* MCP server package
 
 ```bash
-hatch --version
+# 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
 ```
 
-### Create a package template
+### Deploy MCP servers to your tools
+
+Add a Hatch package and automatically configure it on Claude Desktop and Cursor:
 
 ```bash
-hatch create my_package --description "My MCP server package"
+hatch package add ./my_mcp_server --host claude-desktop,cursor
 ```
 
+Configure an arbitrary MCP server (non-Hatch package) on Claude Desktop:
+
+```bash
+# 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:
+
+```bash
+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](https://hatch.readthedocs.io/en/latest/)** — Complete reference and guides
+- **[Getting Started](./docs/articles/users/GettingStarted.md)** — Quick start for users
+- **[CLI Reference](./docs/articles/users/CLIReference.md)** — All commands and options
+- **[Tutorials](./docs/articles/users/tutorials/)** — Step-by-step guides from installation to package authoring
+- **[MCP Host Configuration](./docs/articles/users/MCPHostConfiguration.md)** — Deploy to multiple platforms
+- **[Developer Docs](./docs/articles/devs/)** — Architecture, implementation guides, and contribution guidelines
+- **[Troubleshooting](./docs/articles/users/Troubleshooting/ReportIssues.md)** — Common issues and solutions
+
 ## Contributing
 
-We welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details.
+We welcome contributions! See the [How to Contribute](./docs/articles/devs/contribution_guides/how_to_contribute.md) guide for details.
 
-### Quick Start
+### 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 -c "import hatch; print('Hatch package imports successfully')"`
+6. **Run tests**: `python -m pytest tests/`
 7. **Create a pull request**
 
-### Commit Messages
-
-We use [Conventional Commits](https://www.conventionalcommits.org/) for automated versioning:
-
-```bash
-feat: add new feature
-fix: resolve bug
-docs: update documentation
-test: add tests
-chore: maintenance tasks
-```
-
-Use `npm run commit` for guided commit messages.
-
-For detailed guidelines, see [CONTRIBUTING.md](./CONTRIBUTING.md).
+We use [Conventional Commits](https://www.conventionalcommits.org/) for automated versioning. Use `npm run commit` for guided commit messages.
 
-## Getting Help
+## Getting help
 
-- Read developer onboarding and contribution guides in `docs/articles/devs/`
-- Report issues or feature requests on the GitHub repository: <https://github.com/CrackingShells/Hatch/issues>
+- Search existing [GitHub Issues](https://github.com/CrackingShells/Hatch/issues)
+- Read [Troubleshooting](./docs/articles/users/Troubleshooting/ReportIssues.md) for common problems
+- Check [Developer Onboarding](./docs/articles/devs/development_processes/developer_onboarding.md) for setup help
 
 ## License