Trans.eu

MCP (Model Context Protocol) server for Trans.eu freight exchange integration. Enables AI assistants to interact with the Trans.eu platform — search freight offers, manage loads, send messages via XMPP, and more.

Features

• Authentication — Headless OAuth2 login via Playwright with MFA support (SMS/email)
• Freight API — Search and manage freight offers, loads, and vehicles on Trans.eu
• XMPP Messaging — Send and receive real-time messages via Trans.eu's XMPP infrastructure
• Token Management — Automatic token refresh and persistent file-based storage

Setup

Prerequisites

• Python 3.11+
• uv (recommended) or pip

Installation

# Clone the repository
git clone https://github.com/k4cper-g/transeu-mcp.git
cd transeu-mcp

# Install dependencies
uv sync

# Install Playwright browsers
uv run playwright install chromium

Configuration

Set environment variables for default credentials (optional):

export TRANSEU_LOGIN="your-login"
export TRANSEU_PASSWORD="your-password"
export TRANSEU_DATA_DIR="/path/to/token/storage"  # defaults to /data/transeu

Running

# stdio transport (default, for local MCP clients)
uv run mcp-server-transeu

# HTTP transport (for remote/Docker deployments)
MCP_TRANSPORT=http MCP_HOST=0.0.0.0 MCP_PORT=8080 uv run mcp-server-transeu

Docker

docker build -t transeu-mcp .
docker run -p 8080:8080 \
  -e TRANSEU_LOGIN=your-login \
  -e TRANSEU_PASSWORD=your-password \
  transeu-mcp

MCP Client Configuration

Add to your MCP client config (e.g. Claude Desktop):

{
  "mcpServers": {
    "transeu": {
      "command": "uv",
      "args": ["--directory", "/path/to/transeu-mcp", "run", "mcp-server-transeu"],
      "env": {
        "TRANSEU_LOGIN": "your-login",
        "TRANSEU_PASSWORD": "your-password"
      }
    }
  }
}

License

MIT