Metadata-Version: 2.4
Name: aspose-cells-cloud-mcp
Version: 26.4.0
Summary: MCP server for Aspose.Cells Cloud automation (FastMCP-based)
Author-email: Aspose Cloud <support@aspose.com>
License: MIT License
        
        Copyright (c) 2025 Aspose.Cells Cloud Product Family
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Documentation, https://github.com/aspose-cells-cloud/Aspose.Cells-Cloud-MCP-Server#readme
Project-URL: Repository, https://github.com/aspose-cells-cloud/Aspose.Cells-Cloud-MCP-Server
Project-URL: Free Support, https://forum.aspose.cloud/c/cells/7
Keywords: MCP,Aspose,Aspose.Cells Cloud,Excel,Xlsx,PDF,server
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Classifier: Topic :: Office/Business
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: <3.14,>=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastmcp
Requires-Dist: asposecellscloud
Dynamic: license-file

![](https://img.shields.io/badge/aspose.cells%20Cloud%20MCP-26.4.0-green?style=for-the-badge&logo=python)
![Python Version](https://img.shields.io/badge/python-3.11%2B-blue?style=for-the-badge&logo=python)
![License](https://img.shields.io/badge/license-MIT-green?style=for-the-badge&logo=python)

## Overview

**Aspose.Cells Cloud MCP Server** is a FastMCP-based MCP server built on top of [Aspose.Cells Cloud SDK for Python](https://products.aspose.cloud/cells/python/). It automates the creation and editing of Microsoft Excel spreadsheets and exposes operations as MCP tools that any MCP-compatible client can call. Supported transports: `stdio`, `streamable-http`, `sse`.

## Features

- convert spreadsheet

## Requirements

- Python 3.11+
- [Aspose.Cells Cloud SDK for Python](https://products.aspose.cloud/cells/python/). This library is a [commercial product](https://purchase.aspose.cloud/buy/cells/python).  
  You'll need to obtain a valid license for Aspose.Cells Cloud. The package will install this dependency, but you're responsible for complying with Aspose's licensing terms.

## Installation

```powershell

python -m pip install aspose-cells-cloud-mcp

```

From source (download repo and install requirements):

```powershell

git clone https://github.com/aspose-cells-cloud/Aspose.Cells-Cloud-MCP-Server
cd Aspose.Cells-Cloud-MCP-Server
python -m pip install -r requirements.txt

```

## Command Line Interface

After installation, the CLI command is available:

```bash
aspose-cells-cloud-mcp
```

By default, the server runs with the `stdio` transport.

Run without installation:

```bash
python mcp_server.py
```

## Transports and Configuration

Supported MCP transports: `stdio`, `streamable-http`, `sse`.

### Environment Variables

- `MCP_TRANSPORT` — `stdio` | `streamable-http` | `sse` (default `stdio`)
- `MCP_HOST` — host address (default `0.0.0.0`)
- `MCP_PORT` — port (default `8080`)
- `MCP_PATH` — HTTP path for `streamable-http` (default `/mcp`)
- `MCP_SSE_PATH` — events path for `sse` (default `/sse`)
- `LOG_LEVEL` — logging level (`INFO`, `DEBUG`, ...)

## How to run Aspose Cells Cloud MCP Server in Docker Container

### Build Docker Image

```cmd

docker build -t aspose-cells-cloud-mcp-server:26.4.0 .

```

### Run Docker Image

```cmd

 docker run -itdp 28080:8080  -e MCP_TRANSPORT="streamable-http" -e ASPOSE_CLOUD_CLIENT_ID="yourt-aspose-cloud-client_id" -e ASPOSE_CLOUD_CLIENT_SECRET="your-aspose-cloud-client-secret" --isolation hyperv  --name my-aspose-cells-cloud-mcp-instance  aspose-cells-cloud-mcp-server:26.4.0

```

## License

This package is licensed under the MIT [LICENSE](LICENSE). However,  it depends on Aspose.Cells Cloud SDK for Python is an open-source library.

You must obtain [valid client credentials](https://purchase.aspose.cloud/) for Aspose.Cells Cloud.

## Integration with MCP Clients

- Claude Desktop MCP: add this server with `streamable-http` or `sse` transport and the URL printed by the server at startup.
- Any MCP (JSON) clients — configure the matching transport and path.
