MCP.so
Sign In

IvoryOS MCP

@ivoryzh

Repository

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

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

14

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.

Frequently asked questions

What are the prerequisites to install IvoryOS MCP?

You need [uv](https://docs.astral.sh/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.

Comments

Basic information

Category

Other

Transports

stdio

Author

ivoryzh

Submitted by

Ivory Zhang

More Other MCP servers

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K

Mobile Mcp

mobile-next

Model Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)

5.4K