mirror of
https://github.com/hanzoai/mcp.git
synced 2026-10-15 12:30:12 +00:00
zeekay
6db5cf2d7e
- Add docker-publish.yml workflow for ghcr.io - Add production-ready Dockerfile (if missing) - Enable automated builds on push to main - Support for semantic versioning tags
Hanzo AI Desktop Extension (DXT) Packaging
This directory contains the files needed to package Hanzo AI as a Desktop Extension (.dxt) file for easy installation in Claude Desktop.
What is DXT?
Desktop Extensions (DXT) are a packaging format for MCP servers that allows:
- One-click installation in Claude Desktop
- Automatic dependency management
- Cross-platform compatibility
- Secure credential storage
- Easy distribution
Files in this Directory
manifest.json- Extension metadata and configurationbuild_dxt.py- Build script to create the .dxt packageREADME.md- This file
Building a DXT Package
To build a .dxt file, run:
make build-dxt
This will:
- Package the Hanzo AI Python code
- Include the manifest.json with tool definitions
- Add installation scripts for all platforms
- Create a .dxt file in the
dist/directory
Installing the DXT File
Users can install the Hanzo AI extension by:
- Double-clicking the .dxt file
- Drag and drop into Claude Desktop's extension manager
- Using the extension manager in Claude Desktop settings
Manifest Configuration
The manifest.json file defines:
- Extension metadata (name, version, description)
- Runtime requirements (Python version)
- Required permissions (filesystem, network, execute)
- Available tools and their categories
- Configuration options (allowed paths, feature flags)
Development Notes
When updating the extension:
- Modify tool definitions in
manifest.jsonif tools change - Update version number (handled automatically by build script)
- Test the .dxt file installation on all platforms
- Ensure all dependencies are properly specified
Distribution
The generated .dxt files can be:
- Uploaded to GitHub releases
- Distributed via the Desktop Extensions Hub
- Shared directly with users
- Installed from local filesystem
Security Considerations
The DXT format includes:
- Permission declarations for transparency
- Sandboxed execution environment
- Secure credential storage via OS keychain
- Code signing support (future enhancement)
Troubleshooting
If the .dxt build fails:
- Ensure all dependencies are installed:
make install - Check that the virtual environment is activated
- Verify the manifest.json is valid JSON
- Check file permissions in the project directory
For more information about Desktop Extensions, see: https://desktop-extensions.com