IvoryOS MCP

Name: IvoryOS MCP
Author: ivoryzh

@ivoryzh

About IvoryOS MCP

IvoryOS is a Python-based unified robot control web interface, developed for user-friendly workflow design and control for Self-Driving Labs (SDLs). It works by introspecting the Python script, dynamically searching for available module and their method. The methods are available

#python #robotics #workflow #optimization

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "IvoryOS MCP": {
      "command": "uvx",
      "args": [
        "ivoryos-mcp"
      ],
      "env": {
        "IVORYOS_URL": "http://127.0.0.1:8000/ivoryos",
        "IVORYOS_USERNAME": "<IVORYOS_USERNAME>",
        "IVORYOS_PASSWORD": "<IVORYOS_PASSWORD>"
      }
    }
  }
}

Tools

summarize ivoryOS and the current deck functions, no authentication required.

Get workflow status

Execute a robot task and return task_id.

List workflow scripts

Load a workflow script

Submit a workflow script

Toggle pause and resume for workflow execution

Abort pending workflow execution

Stop workflow execution after current step

Run the loaded workflow with repeat times

Run the loaded workflow with a list of keyword arguments

Run the loaded workflow with ax-platform (credit: Honegumi)

List workflow data

Load workflow data

Overview

What is IvoryOS MCP?

IvoryOS MCP serves as a robot control interface using IvoryOS and the Model Context Protocol (MCP) to design, manage workflows, and interact with the current hardware/software execution layer.

How to use IvoryOS MCP?

Install uv, clone the repository, and install dependencies with uv pip install -r uv.lock. Configure the IvoryOS URL and login credentials in a .env file or directly in ivoryos_mcp/server.py. Then install the server in Claude Desktop using mcp install ivoryos_mcp/server.py.

Key features of IvoryOS MCP

Get IvoryOS platform info and signature (platform-info)
List, load, and submit workflow scripts from the database
List and load workflow execution data (CSV and logs)
Call platform functions directly with execute-task
Run workflow scripts repeatedly or with dynamic parameters
Pause, resume, abort, or safely stop workflow execution

Use cases of IvoryOS MCP

Obtain real-time platform information and execution status
Design and manage robot workflow scripts programmatically
Run repeated or parameterised robot workflows from an AI assistant
Pause or abort running workflows safely without hardware risk

FAQ from IvoryOS MCP

What are the prerequisites to install IvoryOS MCP?

You need uv installed, Python, and the cloned repository. Dependencies are handled via uv pip install -r uv.lock.

How do I configure the IvoryOS server connection?

Set IVORYOS_URL, IVORYOS_USERNAME, and IVORYOS_PASSWORD in a .env file, or modify the corresponding variables directly in ivoryos_mcp/server.py.

How do I install the server in Claude Desktop?

Run mcp install ivoryos_mcp/server.py after configuring the environment. Claude Desktop will then be able to use the MCP tools.

What is the difference between ℹ️ and 🤖 tools?

Tools marked ℹ️ (General, Workflow Design, Workflow Data) are read-only or safe and can be allowed always. Tools marked 🤖 (Direct Control, Workflow Run, Workflow Control) trigger actual hardware/software actions and should be allowed once per invocation.