IvoryOS MCP

Created By

Ivory Zhang6 months ago

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 through direct function calls and stacking into workflows for later iteration. The IvoryOS MCP support all features including designing, managing workflows, and interacting with the loaded hardware/software execution layer. * paper: https://www.nature.com/articles/s41467-025-60514-w * code: https://gitlab.com/heingroup/ivoryos

# Python

# Robotics

Overview Content Tools Comments

Content

IvoryOS MCP server

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

📦 Installation

Install uv.

1. Clone the Repository

git clone https://gitlab.com/heingroup/ivoryos-mpc
cd ivoryos-mcp

2. Install dependencies

When using IDE (e.g. PyCharm), the uv environment might be configured, you can skip this section.

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -r uv.lock

⚙️ Configuration

Option 1: in .env, change ivoryOS url and login credentials.

IVORYOS_URL=http://127.0.0.1:8000/ivoryos
IVORYOS_USERNAME=admin
IVORYOS_PASSWORD=admin

Option 2: In ivoryos_mcp/server.py, change ivoryOS url and login credentials.

url = "http://127.0.0.1:8000/ivoryos"
login_data = {
    "username": "admin",
    "password": "admin",
}

🚀 Install the server (in Claude Desktop)

mcp install ivoryos_mcp/server.py

✨ Features

Category	Feature	Description
ℹ️ General Tools	`platform-info`	Get ivoryOS info and signature of the platform
	`execution-status`	Check if system is busy and current/last task status
ℹ️ Workflow Design	`list-workflow-scripts`	List all workflow scripts from the database
	`load-workflow-script`	Load a workflow script from the database
	`submit-workflow-script`	Save a workflow Python script to the database
ℹ️ Workflow Data	`list-workflow-data`	List available workflow execution data
	`load-workflow-data`	Load CSV and execution log from selected workflow
🤖 Direct Control	`execute-task`	Call platform function directly
🤖 Workflow Run	`run-workflow-repeat`	Run workflow scripts repeatedly with static parameters
	`run-workflow-kwargs`	Run workflow scripts with dynamic parameters
	`run-workflow-campaign`	Run workflow campaign with an optimizer
🤖 Workflow Control	`pause-and-resume`	Pause or resume the workflow execution
	`abort-pending-workflow`	Finish current iteration, abort future executions
	`stop-current-workflow`	Safe stop of current workflow

⚠️ It's recommended to only use allow always for tasks with ℹ️ and use allow once for tasks with 🤖. These tasks will trigger actual actions on your hosted Python code.

🧪 Examples

The example prompt uses the abstract SDL example.

Platform info

Load prebuilt workflow script

load script.gif

Server Config

{
  "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>"
      }
    }
  }
}

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

Serper MCP ServerA Serper MCP Server

Zhipu Web SearchZhipu Web Search MCP Server is a search engine specifically designed for large models. It integrates four search engines, allowing users to flexibly compare and switch between them. Building upon the web crawling and ranking capabilities of traditional search engines, it enhances intent recognition capabilities, returning results more suitable for large model processing (such as webpage titles, URLs, summaries, site names, site icons, etc.). This helps AI applications achieve "dynamic knowledge acquisition" and "precise scenario adaptation" capabilities.

MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs

Playwright McpPlaywright MCP server

CursorThe AI Code Editor

ChatWiseThe second fastest AI chatbot™

EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

DeepChatYour AI Partner on Desktop

Jina AI MCP ToolsA Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.

BlenderBlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.