Install
Three ways to run this device. Each one serves its fake backend: no instrument, no simulator install and no upstream checkout.
OpenAI4S (one command)
openai4s lab add robots/qdeyna__ur10e_2f140_topic_based_ros2_controlInstalls the device into the OpenAI4S Lab on its fake backend and starts it. First time? See setup below.
Or, in the workbench, open the Lab tab → Market → Install.
Standalone MHS endpoint
git clone --depth 1 https://github.com/PKU-YuanGroup/OpenMHS.git && cd OpenMHS
PYTHONPATH=MHS/sdk/src python3 -m mhs serve robots/qdeyna__ur10e_2f140_topic_based_ros2_control --port 7400
# in a second terminal, from the same directory:
PYTHONPATH=MHS/sdk/src python3 -m mhs describe --endpoint http://127.0.0.1:7400Serves the device as an MHS endpoint on port 7400 from an OpenMHS clone (Python 3.10 or later, standard library only); describe prints what it offers.
Any MCP host (Claude Desktop, Cursor, …)
{
"mcpServers": {
"ur10e-2f140-topic-based-ros2-control": {
"command": "python3",
"args": [
"-m",
"mhs",
"serve",
"robots/qdeyna__ur10e_2f140_topic_based_ros2_control",
"--mcp"
],
"env": {
"PYTHONPATH": "/path/to/OpenMHS/MHS/sdk/src"
}
}
}
}Add this server to the host's MCP configuration and replace /path/to/OpenMHS with the path of your OpenMHS clone. The host starts the server and talks to it on stdin and stdout.
What it does
Measures
joint_positionsjoint_velocitiesread_joint_state
Adjusts
Nothing declared.
Actions
follow_arm_trajectory- Send FollowJointTrajectory points on the fake-hardware scaled controller; return the controller error_code and error_string
activate_trajectory_controller- The declared re-enable after a safety reset: switch scaled_joint_trajectory_controller on again through /controller_manager/switch_controller (STRICT), so the trajectory the e-stop dropped is not resumed. On activation the controller holds the state it starts from. With this deployment's position-only command interface and position and velocity state interfaces, that is the measured position. Reset itself does not activate the controller
Names as the driver declares them. Units, limits and the safety declaration are in the package's REFERENCE.md.
First-time setup
The OpenAI4S workbench with the OpenMHS lab, from a source checkout:
# OpenAI4S workbench with the OpenMHS lab (source checkout)
git clone --recursive https://github.com/PKU-YuanGroup/OpenAI4S.git
cd OpenAI4S && ./setup.sh && source .venv/bin/activate
openai4s lab add robots/qdeyna__ur10e_2f140_topic_based_ros2_control
openai4s serve # open the Lab tabThe standalone endpoint and the MCP server need only an OpenMHS clone and Python 3.10 or later. More in the market's getting-started guide and on the OpenAI4S host page.
Source and evidence
- Pinned commit
7db5397edae2- Licence
- NOASSERTION
- Stars
- 0
- Evidence
contract_checkedon the fake backend- Backends
- fake
The upstream repository asserts no licence (NOASSERTION); check it before you redistribute the upstream code.
The driver package MHS/drivers/robots/qdeyna__ur10e_2f140_topic_based_ros2_control wraps the upstream code at the pinned commit. Its REFERENCE.md documents the full contract: every value, action, unit, limit and the safety declaration.