mcpField
T
TransformerBee.MCP

TransformerBee.MCP

Local
github.com/HochfrequenzBusiness & Marketing1Updated 3d ago
Repository

About TransformerBee.MCP

TransformerBee.MCP is a Python MCP server wrapper for transformer.bee, intended for users who want to connect the converter through MCP. It can be installed and run as a Python package or Docker image.

Key features

  1. 01Wraps the transformer.bee client
  2. 02Installable as a Python package
  3. 03Available as a Docker image
  4. 04Starts through a CLI command

Use cases

  1. 01Connect transformer.bee to an MCP client
  2. 02Run the server in a Python environment
  3. 03Start the server with Docker

MCP support

The MCP server connects transformer.bee to MCP clients. It uses the transformer.bee host address and related client environment variables at runtime.

#mcp#transformer#edifact#energiewirtschaft#fastmcp

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "TransformerBee.mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "pull"
      ]
    }
  }
}
Run commanddocker run -i --rm pull

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocipull

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

TransformerBee.MCP

This is a simple PoC of a Model Context Protocol (MCP) server for transformer.bee, written in Python. Under the hood it uses python-mcp and transformerbeeclient.py.

Installation

You can install the MCP server as Python package or pull the Docker image.

Install as Python Package
uv install transformerbeemcp

or if you are using pip:

pip install transformerbeemcp
Install as Docker Image
docker pull ghcr.io/hochfrequenz/transformerbee.mcp:latest

Start the Server via CLI

Python

_The package ships a simple CLI argument to start the server. In a terminal inside the virtual environment in which you installed the package (here myvenv), call:

(myvenv) run-transformerbee-mcp-server
Docker
docker run --network host -i --rm -e TRANSFORMERBEE_HOST=http://localhost:5021 ghcr.io/hochfrequenz/transformerbee.mcp:latest

(For the environment variables -e ..., see below or the transformerbeeclient.py docs.)

Register MCP Server in Claude Desktop

If you checked out this repository
cd path/to/reporoot/src/transformerbeemcp
fastmcp install server.py
If you installed the package via pip/uv

Modify your claude_desktop_config.json (that can be found in Claude Desktop menu via "Datei > Einstellungen > Entwickler > Konfiguration bearbeiten"):

{
  "mcpServers": {
    "TransformerBee.mcp": {
      "command": "C:\\github\\MyProject\\.myvenv\\Scripts\\run-transformerbee-mcp-server.exe",
      "args": [],
      "env": {
        "TRANSFORMERBEE_HOST": "http://localhost:5021",
        "TRANSFORMERBEE_CLIENT_ID": "",
        "TRANSFORMERBEE_CLIENT_SECRET": ""
      }
    }
  }
}

where C:\github\MyProject\.myvenv is the path to your virtual environment where you installed the package and localhost:5021 exposes transformer.bee running in a docker container. Alternatively, if you haven't configured this handy CLI command https://github.com/Hochfrequenz/TransformerBee.mcp/blob/c0898769670469df13f23b57a55fe4b71ed9795b/pyproject.toml#L101-L102

you can just call python with non-empty args.

Note that a lot of MCP tooling assumes you have uv installed, so you might need to install it in your virtual environment as well.

For details about the environment variables and/or starting transformer.bee locally, check transformerbeeclient.py docs.

If you installed the package via Docker
{
  "mcpServers": {
    "TransformerBee.mcp": {
      "command": "docker",
      "args": [
        "run",
        "--network",
        "host",
        "-i",
        "--rm",
        "-e",
        "TRANSFORMERBEE_HOST=http://localhost:5021",
        "ghcr.io/hochfrequenz/transformerbee.mcp:latest"
      ],
      "env": {
        "TRANSFORMERBEE_HOST": "http://localhost:5021",
        "TRANSFORMERBEE_CLIENT_ID": "",
        "TRANSFORMERBEE_CLIENT_SECRET": ""
      }
    }
  }
}

I'm aware, that using the --network host option is a bit hacky and not best practice.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.