wehub-resource-sync
91e75e620b
CI: cua-driver distro-compat matrix / debian:12 (glibc 2.36) (push) Has been cancelled
CI: SPDX Headers / Check SPDX headers (warn-only) (push) Has been cancelled
CD: Docs MCP Server / build (linux/amd64) (push) Has been cancelled
CD: Docs MCP Server / build (linux/arm64) (push) Has been cancelled
CD: Docs MCP Server / merge (push) Has been cancelled
CI: cua-driver distro-compat matrix / Resolve release version (push) Has been cancelled
CI: cua-driver distro-compat matrix / fedora:41 (glibc 2.40) (push) Has been cancelled
CI: cua-driver distro-compat matrix / rockylinux:9 (glibc 2.34) (push) Has been cancelled
CI: cua-driver distro-compat matrix / ubuntu:22.04 (glibc 2.35) (push) Has been cancelled
CI: cua-driver distro-compat matrix / ubuntu:24.04 (glibc 2.39) (push) Has been cancelled
CI: cua-driver distro-compat matrix / Distro compat summary (push) Has been cancelled
CI: Rust Linux unit / Rust Linux unit and compile (push) Has been cancelled
CI: Rust Windows unit / Rust Windows unit and compile (push) Has been cancelled
CI: Nix Linux Rust source / Nix / compositor build (push) Has been cancelled
CI: Nix Linux Rust source / Nix / driver package (push) Has been cancelled
CI: Nix Linux Rust source / Nix / Rust unit tests (push) Has been cancelled
67 lines
2.0 KiB
Markdown
67 lines
2.0 KiB
Markdown
# Cua Desktop Extension
|
|
|
|
This directory contains the build artifacts for the Cua Desktop Extension (`.mcpb` file).
|
|
|
|
## Building the Extension
|
|
|
|
To build the extension, run the build script from the parent directory:
|
|
|
|
```bash
|
|
cd /path/to/libs/python/mcp-server
|
|
python3 build-extension.py
|
|
```
|
|
|
|
This will:
|
|
|
|
1. Copy the MCP server code from `mcp_server/` directory
|
|
2. Copy static files (manifest, icons, scripts)
|
|
3. Create a `.mcpb` zip archive in `desktop-extension/cua-extension.mcpb`
|
|
4. Set custom file icon (platform-specific):
|
|
- macOS: Uses `fileicon` (install with `brew install fileicon`)
|
|
- Windows/Linux: Not yet supported
|
|
|
|
## Directory Structure
|
|
|
|
```
|
|
desktop-extension/
|
|
├── README.md # This file
|
|
├── manifest.json # Extension manifest
|
|
├── desktop_extension.png # Extension icon
|
|
├── requirements.txt # Python dependencies
|
|
├── run_server.sh # Server launcher script
|
|
├── setup.py # Dependency installer
|
|
└── cua-extension.mcpb # Generated extension archive
|
|
```
|
|
|
|
## Source Files
|
|
|
|
The actual MCP server code lives in `../mcp_server/`:
|
|
|
|
- `server.py` - Main MCP server implementation
|
|
- `session_manager.py` - Session management and resource pooling
|
|
|
|
## Static Files
|
|
|
|
These files are maintained in this directory:
|
|
|
|
- `manifest.json` - Extension metadata and configuration
|
|
- `desktop_extension.png` - Extension icon
|
|
- `requirements.txt` - Python package dependencies
|
|
- `run_server.sh` - Shell script to launch the server
|
|
- `setup.py` - Python script to install dependencies
|
|
|
|
## Generated Files
|
|
|
|
The `.mcpb` file is generated by the build script and is gitignored.
|
|
|
|
## Installing the Extension
|
|
|
|
Once built, you can install the extension in Claude Desktop by:
|
|
|
|
1. Opening Claude Desktop Settings
|
|
2. Going to the Extensions section
|
|
3. Dropping the `cua-extension.mcpb` file into the window
|
|
4. Following the installation prompts
|
|
|
|
For more information, see the [Anthropic Desktop Extensions documentation](https://www.anthropic.com/engineering/desktop-extensions).
|