hatch-xclam 0.7.0.dev11__py3-none-any.whl → 0.7.0.dev12__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,144 @@
1
+ Metadata-Version: 2.4
2
+ Name: hatch-xclam
3
+ Version: 0.7.0.dev12
4
+ Summary: Package manager for the Cracking Shells ecosystem
5
+ Author: Cracking Shells Team
6
+ Project-URL: Homepage, https://github.com/CrackingShells/Hatch
7
+ Project-URL: Bug Tracker, https://github.com/CrackingShells/Hatch/issues
8
+ Classifier: Programming Language :: Python :: 3.12
9
+ Classifier: License :: OSI Approved :: GNU Affero General Public License v3
10
+ Classifier: Operating System :: OS Independent
11
+ Requires-Python: >=3.12
12
+ Description-Content-Type: text/markdown
13
+ License-File: LICENSE
14
+ Requires-Dist: jsonschema>=4.0.0
15
+ Requires-Dist: requests>=2.25.0
16
+ Requires-Dist: packaging>=20.0
17
+ Requires-Dist: docker>=7.1.0
18
+ Requires-Dist: pydantic>=2.0.0
19
+ Requires-Dist: hatch-validator>=0.8.0
20
+ Provides-Extra: docs
21
+ Requires-Dist: mkdocs>=1.4.0; extra == "docs"
22
+ Requires-Dist: mkdocstrings[python]>=0.20.0; extra == "docs"
23
+ Provides-Extra: dev
24
+ Requires-Dist: wobble>=0.2.0; extra == "dev"
25
+ Dynamic: license-file
26
+
27
+ # Hatch
28
+
29
+ ![Hatch Logo](./docs/resources/images/Logo/hatch_wide_dark_bg_transparent.png)
30
+
31
+ 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.
32
+
33
+ The canonical documentation is at `docs/index.md` and published at <https://hatch.readthedocs.io/en/latest/>.
34
+
35
+ ## Quick start
36
+
37
+ ### Install from PyPI
38
+
39
+ ```bash
40
+ pip install hatch-xclam
41
+ ```
42
+
43
+ Verify installation:
44
+
45
+ ```bash
46
+ hatch --version
47
+ ```
48
+
49
+ ### Install from source
50
+
51
+ ```bash
52
+ git clone https://github.com/CrackingShells/Hatch.git
53
+ cd Hatch
54
+ pip install -e .
55
+ ```
56
+
57
+ ### Create your first environment and *Hatch!* MCP server package
58
+
59
+ ```bash
60
+ # Create an isolated environment
61
+ hatch env create my_project
62
+
63
+ # Switch to it
64
+ hatch env use my_project
65
+
66
+ # Create a package template
67
+ hatch create my_mcp_server --description "My MCP server"
68
+
69
+ # Validate the package
70
+ hatch validate ./my_mcp_server
71
+ ```
72
+
73
+ ### Deploy MCP servers to your tools
74
+
75
+ Add a Hatch package and automatically configure it on Claude Desktop and Cursor:
76
+
77
+ ```bash
78
+ hatch package add ./my_mcp_server --host claude-desktop,cursor
79
+ ```
80
+
81
+ Configure an arbitrary MCP server (non-Hatch package) on Claude Desktop:
82
+
83
+ ```bash
84
+ # Local server with command and arguments
85
+ hatch mcp configure my-weather-server --host claude-desktop \
86
+ --command python --args weather_server.py \
87
+ --env-var API_KEY=your_key
88
+
89
+ # Remote server with URL
90
+ hatch mcp configure api-server --host gemini \
91
+ --httpUrl https://api.example.com \
92
+ --header Authorization="Bearer token"
93
+ ```
94
+
95
+ List configured servers and hosts:
96
+
97
+ ```bash
98
+ hatch mcp list servers
99
+ hatch mcp list hosts --detailed
100
+ ```
101
+
102
+ ## Key features
103
+
104
+ - **Environment isolation**: Create separate workspaces for different projects
105
+ - **Multi-type dependencies**: Automatically resolve and install system packages, Python packages, Docker containers, and Hatch packages
106
+ - **MCP host configuration**: Deploy MCP servers to Claude Desktop, Cursor, VSCode, and other platforms
107
+ - **Package validation**: Ensure packages meet schema requirements before distribution
108
+ - **Development-focused**: Optimized for rapid development and testing of MCP server ecosystems
109
+
110
+ ## Documentation
111
+
112
+ - **[Full Documentation](https://hatch.readthedocs.io/en/latest/)** — Complete reference and guides
113
+ - **[Getting Started](./docs/articles/users/GettingStarted.md)** — Quick start for users
114
+ - **[CLI Reference](./docs/articles/users/CLIReference.md)** — All commands and options
115
+ - **[Tutorials](./docs/articles/users/tutorials/)** — Step-by-step guides from installation to package authoring
116
+ - **[MCP Host Configuration](./docs/articles/users/MCPHostConfiguration.md)** — Deploy to multiple platforms
117
+ - **[Developer Docs](./docs/articles/devs/)** — Architecture, implementation guides, and contribution guidelines
118
+ - **[Troubleshooting](./docs/articles/users/Troubleshooting/ReportIssues.md)** — Common issues and solutions
119
+
120
+ ## Contributing
121
+
122
+ We welcome contributions! See the [How to Contribute](./docs/articles/devs/contribution_guides/how_to_contribute.md) guide for details.
123
+
124
+ ### Quick start for developers
125
+
126
+ 1. **Fork and clone** the repository
127
+ 2. **Install dependencies**: `pip install -e .` and `npm install`
128
+ 3. **Create a feature branch**: `git checkout -b feat/your-feature`
129
+ 4. **Make changes** and add tests
130
+ 5. **Use conventional commits**: `npm run commit` for guided commits
131
+ 6. **Run tests**: `python -m pytest tests/`
132
+ 7. **Create a pull request**
133
+
134
+ We use [Conventional Commits](https://www.conventionalcommits.org/) for automated versioning. Use `npm run commit` for guided commit messages.
135
+
136
+ ## Getting help
137
+
138
+ - Search existing [GitHub Issues](https://github.com/CrackingShells/Hatch/issues)
139
+ - Read [Troubleshooting](./docs/articles/users/Troubleshooting/ReportIssues.md) for common problems
140
+ - Check [Developer Onboarding](./docs/articles/devs/development_processes/developer_onboarding.md) for setup help
141
+
142
+ ## License
143
+
144
+ This project is licensed under the GNU Affero General Public License v3 — see `LICENSE` for details.
@@ -21,7 +21,7 @@ hatch/mcp_host_config/host_management.py,sha256=sXyGluFQpfXKggxAVvV9riGRis29JnoE
21
21
  hatch/mcp_host_config/models.py,sha256=WLAdeJc-t4zyiiHByQHYGpC55t6ViggBAs4N1ksJ6W8,24548
22
22
  hatch/mcp_host_config/reporting.py,sha256=Q8UKBJRfvJTbb5PM9xwLEOh3OJjf19AKpWKxs-2622k,6889
23
23
  hatch/mcp_host_config/strategies.py,sha256=deFdAbj8G6Mzs7W8fBlPMPnijxzSnQ2SS5AAx0JR6oY,20293
24
- hatch_xclam-0.7.0.dev11.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
24
+ hatch_xclam-0.7.0.dev12.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
25
25
  node_modules/npm/node_modules/node-gyp/gyp/gyp_main.py,sha256=gOsKGUgjDIMvF7-Z8xqHKdVARNgEac_g_srOaeerZqY,1250
26
26
  node_modules/npm/node_modules/node-gyp/gyp/test_gyp.py,sha256=7PWZav30J2V-o0h5VFmqEyxmhPpjUPH9xYBJQnhcF8k,7691
27
27
  node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/MSVSNew.py,sha256=mzNxGJv3xJz8NLNfPaj1V9Yv1BH38PktL9i7hYphDOo,13029
@@ -145,8 +145,8 @@ tests/test_data/packages/schema_versions/schema_v1_1_0_pkg/main.py,sha256=_B5aqX
145
145
  tests/test_data/packages/schema_versions/schema_v1_2_0_pkg/main.py,sha256=rinhVySJpjXKd2sRCS0ps7xTrVqImWcZ8l4aYbidYR8,238
146
146
  tests/test_data/packages/schema_versions/schema_v1_2_1_pkg/hatch_mcp_server.py,sha256=FT14llzHlA4i8I__8GugzBRowhg_CbLmsOwjq0IWFsY,368
147
147
  tests/test_data/packages/schema_versions/schema_v1_2_1_pkg/mcp_server.py,sha256=BRPAyyAseE2CGR3W647SwjlluYfi7ejhZck0An5581I,467
148
- hatch_xclam-0.7.0.dev11.dist-info/METADATA,sha256=acdg6f2vm9jymsjLoQplFXTyFQGeAO9lPsVLtf5te1g,3129
149
- hatch_xclam-0.7.0.dev11.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
150
- hatch_xclam-0.7.0.dev11.dist-info/entry_points.txt,sha256=6xbkwFUtr7nRa56vUFMyJk2wjwFQ_XVaU53ruecWKI0,47
151
- hatch_xclam-0.7.0.dev11.dist-info/top_level.txt,sha256=1filTSzkOKvsGvPyo2JJiM8OAHLzqNIjRkz8KxnnKjg,25
152
- hatch_xclam-0.7.0.dev11.dist-info/RECORD,,
148
+ hatch_xclam-0.7.0.dev12.dist-info/METADATA,sha256=ve7xm5bDxv39eMA-VmKhL6ie4wWzwMgmAmdUg-qepaw,5120
149
+ hatch_xclam-0.7.0.dev12.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
150
+ hatch_xclam-0.7.0.dev12.dist-info/entry_points.txt,sha256=6xbkwFUtr7nRa56vUFMyJk2wjwFQ_XVaU53ruecWKI0,47
151
+ hatch_xclam-0.7.0.dev12.dist-info/top_level.txt,sha256=1filTSzkOKvsGvPyo2JJiM8OAHLzqNIjRkz8KxnnKjg,25
152
+ hatch_xclam-0.7.0.dev12.dist-info/RECORD,,
@@ -1,103 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: hatch-xclam
3
- Version: 0.7.0.dev11
4
- Summary: Package manager for the Cracking Shells ecosystem
5
- Author: Cracking Shells Team
6
- Project-URL: Homepage, https://github.com/CrackingShells/Hatch
7
- Project-URL: Bug Tracker, https://github.com/CrackingShells/Hatch/issues
8
- Classifier: Programming Language :: Python :: 3.12
9
- Classifier: License :: OSI Approved :: GNU Affero General Public License v3
10
- Classifier: Operating System :: OS Independent
11
- Requires-Python: >=3.12
12
- Description-Content-Type: text/markdown
13
- License-File: LICENSE
14
- Requires-Dist: jsonschema>=4.0.0
15
- Requires-Dist: requests>=2.25.0
16
- Requires-Dist: packaging>=20.0
17
- Requires-Dist: docker>=7.1.0
18
- Requires-Dist: pydantic>=2.0.0
19
- Requires-Dist: hatch-validator>=0.8.0
20
- Provides-Extra: docs
21
- Requires-Dist: mkdocs>=1.4.0; extra == "docs"
22
- Requires-Dist: mkdocstrings[python]>=0.20.0; extra == "docs"
23
- Provides-Extra: dev
24
- Requires-Dist: wobble>=0.2.0; extra == "dev"
25
- Dynamic: license-file
26
-
27
- # Hatch
28
-
29
- ![Hatch Logo](./docs/resources/images/Logo/hatch_wide_dark_bg_transparent.png)
30
-
31
- 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.
32
-
33
- ## Quick links
34
-
35
- The major documentation entry points are:
36
-
37
- - Documentation (canonical): `docs/index.md`
38
- - Getting started (users): `docs/articles/users/GettingStarted.md`
39
- - CLI reference: `docs/articles/users/CLIReference.md`
40
- - Developer docs and architecture: `docs/articles/devs/index.md`
41
-
42
- But, really, just look at the site: <https://crackingshells.github.io/Hatch/>
43
-
44
- ## Quick start
45
-
46
- ### Install from source
47
-
48
- ```bash
49
- git clone https://github.com/CrackingShells/Hatch.git
50
- cd Hatch
51
- pip install -e .
52
- ```
53
-
54
- Verify installation:
55
-
56
- ```bash
57
- hatch --version
58
- ```
59
-
60
- ### Create a package template
61
-
62
- ```bash
63
- hatch create my_package --description "My MCP server package"
64
- ```
65
-
66
- ## Contributing
67
-
68
- We welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details.
69
-
70
- ### Quick Start
71
-
72
- 1. **Fork and clone** the repository
73
- 2. **Install dependencies**: `pip install -e .` and `npm install`
74
- 3. **Create a feature branch**: `git checkout -b feat/your-feature`
75
- 4. **Make changes** and add tests
76
- 5. **Use conventional commits**: `npm run commit` for guided commits
77
- 6. **Run tests**: `python -c "import hatch; print('Hatch package imports successfully')"`
78
- 7. **Create a pull request**
79
-
80
- ### Commit Messages
81
-
82
- We use [Conventional Commits](https://www.conventionalcommits.org/) for automated versioning:
83
-
84
- ```bash
85
- feat: add new feature
86
- fix: resolve bug
87
- docs: update documentation
88
- test: add tests
89
- chore: maintenance tasks
90
- ```
91
-
92
- Use `npm run commit` for guided commit messages.
93
-
94
- For detailed guidelines, see [CONTRIBUTING.md](./CONTRIBUTING.md).
95
-
96
- ## Getting Help
97
-
98
- - Read developer onboarding and contribution guides in `docs/articles/devs/`
99
- - Report issues or feature requests on the GitHub repository: <https://github.com/CrackingShells/Hatch/issues>
100
-
101
- ## License
102
-
103
- This project is licensed under the GNU Affero General Public License v3 — see `LICENSE` for details.