关于 TransformerBee.MCP
TransformerBee.MCP 是用 Python 编写的 transformer.bee MCP 服务封装,面向需要通过 MCP 连接该转换器的用户。它可作为 Python 包或 Docker 镜像安装和启动。
主要功能
- 01封装 transformer.bee 客户端
- 02提供 Python 包安装方式
- 03提供 Docker 镜像
- 04通过命令行启动服务
适用场景
- 01将 transformer.bee 接入 MCP 客户端
- 02在 Python 环境中运行服务
- 03通过 Docker 启动服务
MCP 相关
该 MCP 服务将 transformer.bee 接入 MCP 客户端。运行时需配置 transformer.bee 的主机地址及相关客户端环境变量。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
TransformerBee.MCP
这是一个使用 Python 编写的 transformer.bee Model Context Protocol(MCP)服务简单概念验证(PoC)。
它在底层使用 python-mcp 和 transformerbeeclient.py。
安装
你可以将 MCP 服务安装为 Python 包,也可以拉取 Docker 镜像。
安装为 Python 包
uv install transformerbeemcp
或者,如果你使用 pip:
pip install transformerbeemcp
安装为 Docker 镜像
docker pull ghcr.io/hochfrequenz/transformerbee.mcp:latest
通过 CLI 启动服务
Python
_此包提供了一个简单的 CLI 参数来启动服务。
在终端中**(位于你安装此包的虚拟环境内,此处为 myvenv)**,调用:
(myvenv) run-transformerbee-mcp-server
Docker
docker run --network host -i --rm -e TRANSFORMERBEE_HOST=http://localhost:5021 ghcr.io/hochfrequenz/transformerbee.mcp:latest
(环境变量 -e ... 的相关信息请见下文或 transformerbeeclient.py 文档。)
在 Claude Desktop 中注册 MCP 服务
如果你检出了此仓库
cd path/to/reporoot/src/transformerbeemcp
fastmcp install server.py
如果你通过 pip/uv 安装了此包
修改你的 claude_desktop_config.json(可在 Claude Desktop 菜单中通过“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": ""
}
}
}
}
其中,C:\github\MyProject\.myvenv 是你安装此包的虚拟环境路径,而 localhost:5021 用于访问在 Docker 容器中运行的 transformer.bee。
另外,如果你尚未配置这个实用的 CLI 命令
https://github.com/Hochfrequenz/TransformerBee.mcp/blob/c0898769670469df13f23b57a55fe4b71ed9795b/pyproject.toml#L101-L102
你也可以直接使用非空参数调用 python。
请注意,许多 MCP 工具都假设你已安装 uv,因此你可能还需要在虚拟环境中安装它。
有关环境变量和/或在本地启动 transformer.bee 的详情,请查看 transformerbeeclient.py 文档。
如果你通过 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": ""
}
}
}
}
我知道,使用 --network host 选项有点取巧,也不是最佳实践。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。