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.
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 |
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"
- .NET 8 SDK or later
- A free Aspose Cloud account — sign up at dashboard.aspose.cloud and create an application to get your Client ID and Client Secret
git clone https://github.com/aspose-html-cloud/Aspose.HTML-Cloud-MCP.git
cd Aspose.HTML-Cloud-MCP
dotnet buildCredentials are passed via environment variables ASPOSE_CLIENT_ID and ASPOSE_CLIENT_SECRET.
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": "dotnet",
"args": ["run", "--project", "/absolute/path/to/Aspose.HTML-Cloud-MCP"],
"env": {
"ASPOSE_CLIENT_ID": "your-client-id",
"ASPOSE_CLIENT_SECRET": "your-client-secret"
}
}
}
}Add to your .vscode/settings.json or user settings:
{
"mcp": {
"servers": {
"aspose-html-cloud": {
"command": "dotnet",
"args": ["run", "--project", "/absolute/path/to/Aspose.HTML-Cloud-MCP"],
"env": {
"ASPOSE_CLIENT_ID": "your-client-id",
"ASPOSE_CLIENT_SECRET": "your-client-secret"
}
}
}
}
}Add to your Cursor MCP configuration (~/.cursor/mcp.json):
{
"mcpServers": {
"aspose-html-cloud": {
"command": "dotnet",
"args": ["run", "--project", "/absolute/path/to/Aspose.HTML-Cloud-MCP"],
"env": {
"ASPOSE_CLIENT_ID": "your-client-id",
"ASPOSE_CLIENT_SECRET": "your-client-secret"
}
}
}
}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.
