Rosetta

Provides an MCP-based Excel translation service using Claude, preserving formatting and data integrity.

python

2

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ewalid-rosetta": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/rosetta",
        "python",
        "-m",
        "rosetta.api.mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "your-key-here"
      }
    }
  }
}

Rosetta is an MCP server that enables translating Excel files using Claude AI while preserving formulas, formatting, and layout. It lets you run translation through an MCP client, treating translation as a service you can call programmatically from your workflows or web app.

How to use

You connect to the Rosetta MCP server from your MCP client by referencing the configured MCP entry. The server runs locally and exposes a set of endpoints or a streaming translation path that accepts an Excel file and returns a translated file, while keeping all structural integrity intact.

How to install

Prerequisites: ensure you have Python 3.11 or newer and an Anthropic API key ready.

Install the Rosetta Python package from PyPI.

pip install rosetta-xl

Configuration and MCP setup

The MCP configuration enables the Rosetta server to run locally and be invoked by your MCP client. The following configuration shows how to run Rosetta as a local MCP server using the uv tool.

{
  "mcpServers": {
    "rosetta": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/rosetta", "python", "-m", "rosetta.api.mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-key-here"
      }
    }
  }
}

Security and credentials

Protect your Anthropic API key. Do not commit it in code or share it. Use environment variables to load ANTHROPIC_API_KEY and keep keys out of version control.

If you use a .env file, store it securely and ensure access is restricted to trusted users and CI systems.

Troubleshooting

If the MCP server cannot start, verify that you have a valid ANTHROPIC_API_KEY and that the uv runtime is available on your system. Ensure the directory path in the config matches where Rosetta is located.

Notes and limitations

Claude Web users should be aware that browser environments may not support custom MCP servers directly. For browser-based usage, use the web app for translations and route requests through the API when feasible.

Tools and endpoints

Rosetta exposes translation-related capabilities via its API endpoints. The following tools are available to coordinate translations, estimates, and previews through the MCP interface.

Available tools

translate

Translates an Excel file from a source language to a target language while preserving formulas, formatting, and layout.

translate_stream

Translates with real-time progress streaming via an endpoint, allowing feedback during long translations.

estimate

Provides a cost and cell count estimate for translating a given Excel file.

sheets

Lists the sheet names within a workbook.

count

Counts the number of translatable cells in a workbook.

preview

Previews which cells will be translated without performing full translation.

health

Performs a health check on the MCP server and its connectivity to dependencies.