MCP server that exposes Aspose.HTML Cloud document conversion (HTML, Markdown, SVG, EPUB ? PDF, DOCX, PNG, etc.) as tools for AI assistants.
Project description
Aspose.HTML Cloud MCP Server (Python)
A Model Context Protocol (MCP) server that exposes Aspose.HTML Cloud document conversion as tools for AI assistants like Claude Desktop, Cursor, VS Code Copilot, and other MCP-compatible clients.
What it does
Converts documents between formats via the Aspose.HTML Cloud API.
| Supported input formats | Supported output formats |
|---|---|
html, mhtml, xhtml, epub, svg, md |
pdf, xps, docx, doc, jpeg, png, bmp, gif, tiff, webp, md, mhtml, svg |
Available tools:
| Tool | Input source |
|---|---|
convert_url_to_format |
Public URL |
convert_content_to_format |
Raw HTML / SVG / Markdown string |
convert_base64_to_format |
Base64-encoded document |
convert_file_to_format |
Local file path |
vectorize_image |
Raster image ? SVG vectorization |
Example prompts:
"Convert https://example.com to PDF"
"Convert this HTML to DOCX: <html><body><h1>Hello</h1></body></html>"
"Convert C:\docs\report.html to PNG"
"Vectorize this PNG image into SVG"
Prerequisites
- Python 3.10+
- A free Aspose Cloud account -- sign up at dashboard.aspose.cloud and create an application to get your Client ID and Client Secret
Installation
pip install aspose-html-cloud-mcp
Or run directly with uvx (no install needed):
uvx aspose-html-cloud-mcp
Configuration with MCP Clients
Credentials are passed via environment variables ASPOSE_CLIENT_ID and ASPOSE_CLIENT_SECRET.
Claude Desktop
Edit your Claude Desktop config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"aspose-html-cloud": {
"command": "uvx",
"args": ["aspose-html-cloud-mcp"],
"env": {
"ASPOSE_CLIENT_ID": "your-client-id",
"ASPOSE_CLIENT_SECRET": "your-client-secret"
}
}
}
}
VS Code (Copilot)
Add to your .vscode/settings.json or user settings:
{
"mcp": {
"servers": {
"aspose-html-cloud": {
"command": "uvx",
"args": ["aspose-html-cloud-mcp"],
"env": {
"ASPOSE_CLIENT_ID": "your-client-id",
"ASPOSE_CLIENT_SECRET": "your-client-secret"
}
}
}
}
}
Cursor
Add to your Cursor MCP configuration (~/.cursor/mcp.json):
{
"mcpServers": {
"aspose-html-cloud": {
"command": "uvx",
"args": ["aspose-html-cloud-mcp"],
"env": {
"ASPOSE_CLIENT_ID": "your-client-id",
"ASPOSE_CLIENT_SECRET": "your-client-secret"
}
}
}
}
Alternative: Using pip + python
If you installed via pip install instead of uvx, replace the command:
{
"command": "aspose-html-cloud-mcp"
}
Or:
{
"command": "python",
"args": ["-m", "aspose_html_cloud_mcp"]
}
Environment Variables
| Variable | Required | Description |
|---|---|---|
ASPOSE_CLIENT_ID |
Yes | Your Aspose Cloud application Client ID |
ASPOSE_CLIENT_SECRET |
Yes | Your Aspose Cloud application Client Secret |
ASPOSE_HTML_API_URL |
No | Override the API base URL (default: https://api.aspose.cloud) |
Development
# Clone the repository
git clone https://github.com/aspose-html-cloud/Aspose.HTML-Cloud-MCP.git
cd Aspose.HTML-Cloud-MCP/python
# Create a virtual environment and install in dev mode
python -m venv .venv
source .venv/bin/activate # or .venv\Scripts\activate on Windows
pip install -e .
# Run the server
export ASPOSE_CLIENT_ID="your-client-id"
export ASPOSE_CLIENT_SECRET="your-client-secret"
aspose-html-cloud-mcp
Publishing to PyPI
pip install build twine
python -m build
twine upload dist/*
License
This project is licensed under the MIT License. See LICENSE for details.
The Aspose.HTML Cloud API itself requires a separate subscription -- a free tier is available at aspose.cloud.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file aspose_html_cloud_mcp-1.0.0.tar.gz.
File metadata
- Download URL: aspose_html_cloud_mcp-1.0.0.tar.gz
- Upload date:
- Size: 8.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
03be99bc1140d87e98342cc13e87c5143f8340f77af4195d40ca4729bee14ea3
|
|
| MD5 |
1af57e8e35e81a079d18fd97f93a2d63
|
|
| BLAKE2b-256 |
9a180614c43a12b8bda23bdbcc89f0c46a1fb5d2722ce7a5e143b24c0aa6cbd5
|
File details
Details for the file aspose_html_cloud_mcp-1.0.0-py3-none-any.whl.
File metadata
- Download URL: aspose_html_cloud_mcp-1.0.0-py3-none-any.whl
- Upload date:
- Size: 9.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
15258111dc5ea66d3991db08d70f76093a978a44f119246bc0d0f2c6dcdbbbda
|
|
| MD5 |
9c7673a70f7052a25b148ff6a69b9d1e
|
|
| BLAKE2b-256 |
3ecc08cd3c0e32f14f7c15e2d8ed8cbe0593e0c3a20a9e201ff1f431d863e440
|
