aspose

Aspose MCP Server provides centralized document processing capabilities built on .NET 8.0 and Aspose.Total. It exposes a set of tools for Word, Excel, PowerPoint, PDF, OCR, Email, BarCode, and conversion functions, with options to run in Stdio, HTTP, or WebSocket modes. By default, the server starts in Stdio mode and enables the Word tooling (you can adjust enabled tools via command-line arguments). The MCP SDK and tool annotations allow clients to request specific tool functionality and receive structured results. Use the example configuration to point your MCP client to the Aspose server and specify the tools you want available, for example enabling Word and conversion features. The server also supports session management, extension modules, and authentication mechanisms to fit multi-tenant or secure deployments.

Prerequisites:

• Install .NET 8.0 SDK/Runtime on the target machine.
• Ensure a compatible operating system (Windows, Linux, macOS) as per the prebuilt binaries for Aspose MCP Server.

Installation steps:

1. Download the appropriate Aspose MCP Server binary for your platform from the official releases.

2. Extract/unpack the package to a desired installation directory.

3. Optional: set environment variables to configure transport, port, host, and enabled tools (see environment variables below).

4. Run the server using the CLI, for example:

   • Windows: ./AsposeMcpServer.exe --word
   • Linux/macOS: ./AsposeMcpServer --word

5. Verify the server is listening and accessible by using a MCP client or by curling the HTTP/WebSocket endpoint if HTTP/WebSocket mode is enabled.

Notes:

• If you need HTTP or WebSocket access, you will typically run the server with --http or --ws and specify a port, e.g., --port 3000 --word.
• You may need proper Aspose licenses configured via --license, environment variable, or automatic search as described in the docs.

• Environment variables: ASPOSE_TRANSPORT (stdio/http/ws), ASPOSE_PORT (default 3000), ASPOSE_HOST (default localhost), ASPOSE_TOOLS (all or a comma-separated list like word,excel,pdf).
• For container deployments (Docker/Kubernetes), set ASPOSE_HOST=0.0.0.0 to expose the service outside the container.
• Licensing: ensure an Aspose license is provided (Aspose.Total.lic or individual component licenses) via command-line --license, ASPOSE_LICENSE_PATH, or automatic search; if missing, the server will run in trial mode.
• Security: enable Origin validation and proper input validation as described in the project docs to mitigate common MCP security risks.
• Cross-platform: the server supports Windows, Linux, macOS with ARM64 and x64 builds; some features (e.g., Rosetta for ARM macOS) may apply for certain toolsets.