IvoryOS MCP

Name: IvoryOS MCP
Author: ivoryzh

@ivoryzh

关于 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

基本信息

分类

其他

传输方式

stdio

发布者

ivoryzh

提交者

Ivory Zhang

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

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

概览

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.