UnityLangPX

Provides MCP-based translation services with a unified configuration, command-line tools, and an MCP server for translating text and Markdown.

python

1

GitHub Stars

python

Language

6 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": {
    "nphenix-unitylangpx": {
      "command": "python",
      "args": [
        "scripts/run_mcp_server.py"
      ]
    }
  }
}

UnityLangPX MCP Server exposes translation capabilities via the MCP protocol, allowing you to host a centralized translation service that your clients can connect to. It combines a modular configuration system, an MCP server interface, and command-line tooling to translate text and Markdown content across platforms with solid testing and performance monitoring.

How to use

You connect your MCP client to the local MCP server started by this package. Start the server to expose a standardized translation API you can call from your translation frontends, editors, or automation scripts. You can translate plain text, Markdown documents, or integration with Obsidian through the supported MCP pathway.

How to install

Prerequisites: ensure you have Python 3.11 or newer installed on your system.

Clone the project and install dependencies in editable mode to enable local development and testing.

# Clone the repository
git clone https://github.com/nphenix/UnityLangPX.git

# Enter the project directory
cd UnityLangPX

# Install dependencies in editable mode
pip install -e .

To run the MCP server locally, start the provided Python script.

python scripts/run_mcp_server.py

Verify available commands and options for usage and configuration.

python -m src.cli.main --help

Configuration and usage notes

Set up your translation model provider and credentials through the unified configuration interface. You can view current settings, modify providers, and supply API keys for your chosen provider.

# Show current unified configuration
unitylangpx config show

# Set the translation model provider (e.g., OpenAI)
unitylangpx config set model.provider openai

# Set the API key for the chosen provider
unitylangpx config set model_openai.api_key "YOUR-API-KEY-HERE"

Notes and troubleshooting

If you encounter connection issues, verify that the MCP server is running and listening on its default port, then confirm your client configuration points to the correct URL or local stdio interface.