关键词

能源数据转换EDIFACTBO4ELLM工具协议转换TransformerBee

项目简介

TransformerBee MCP服务是 Model Context Protocol (MCP) 的一个具体实现，它将外部的 TransformerBee 服务（用于EDIFACT和BO4E格式转换）封装成可以通过MCP协议调用的“工具”。这使得支持MCP的LLM客户端能够方便地调用这些转换功能，从而理解或生成特定格式的能源行业数据。

主要功能点

本MCP服务器核心功能是提供数据格式转换工具，具体包括：

  • EDIFACT转BO4E: 将符合特定版本EDIFACT标准的报文转换成BO4E（德国能源行业通用业务对象模型）的结构化数据。
  • BO4E转EDIFACT: 将BO4E结构化数据转换成符合特定版本EDIFACT标准的报文。

它本身不处理复杂的资源管理或Prompt渲染，专注于提供强大的外部工具调用能力。

安装步骤

确保您已安装 Python 环境（推荐使用虚拟环境）。

  1. 使用 pip 安装: 
    pip install transformerbeemcp
  2. 或使用 uv 安装: 
    uv install transformerbeemcp

建议在虚拟环境中进行安装，以便管理依赖。

服务器配置

本MCP服务器设计为由MCP客户端（如某些LLM应用）启动和管理。您需要在您的MCP客户端配置中添加本服务器的信息，通常是在一个JSON格式的配置文件中（例如Claude Desktop的 'claude_desktop_config.json'）。

核心配置信息包括：

  • 服务名称 (server name): 唯一标识此MCP服务，例如 'TransformerBee.mcp'。
  • 启动命令 (command): 用于启动服务器的可执行文件路径。安装后，通常是您的虚拟环境的 'Scripts' (Windows) 或 'bin' (Linux/macOS) 目录下的 'run-transformerbee-mcp-server'。您可能需要提供完整的路径。
  • 启动参数 (args): 启动命令的额外参数，通常为空列表 '[]'。
  • 环境变量 (env): 必须配置的环境变量是 'TRANSFORMERBEE_HOST'，指向实际的 TransformerBee 服务的地址（例如 'http://localhost:5021'）。如果TransformerBee服务需要认证，还需要配置 'TRANSFORMERBEE_CLIENT_ID' 和 'TRANSFORMERBEE_CLIENT_SECRET'。

示例（概念性的配置内容，具体路径和值请根据实际情况调整）：

// 这不是可以直接运行的代码，而是描述您需要在MCP客户端配置中填写的JSON结构
{
  "mcpServers": {
    "TransformerBee.mcp": { // 服务名称
      "command": "/path/to/your/virtualenv/bin/run-transformerbee-mcp-server", // 实际启动命令路径
      "args": [], // 启动参数列表
      "env": {
        "TRANSFORMERBEE_HOST": "http://your-transformerbee-host:port", // 实际TransformerBee服务地址
        "TRANSFORMERBEE_CLIENT_ID": "your_client_id", // 如果需要认证
        "TRANSFORMERBEE_CLIENT_SECRET": "your_client_secret" // 如果需要认证
      }
    }
  }
}

请将上述结构和您的实际路径、TransformerBee服务地址及认证信息填入您的MCP客户端配置文件中。

基本使用方法

配置完成后，启动您的MCP客户端（LLM应用）。客户端会自动发现并启动配置好的TransformerBee MCP服务。

LLM客户端现在可以通过MCP协议调用本服务器提供的工具。例如，一个支持MCP的LLM在处理涉及能源数据格式转换的任务时，可以识别并调用 'convert_edifact_to_bo4e' 或 'convert_bo4e_to_edifact' 这两个工具，并将需要转换的数据作为参数传递给工具。工具执行完成后，LLM将收到转换结果。

具体如何通过LLM界面或API调用这些工具，取决于您使用的MCP客户端（LLM应用）。通常，LLM会根据其能力和用户指令自动决定何时以及如何调用可用的MCP工具。

信息

分类

AI与计算

访问项目