IvoryOS MCP

IvoryOS MCP サーバー

IvoryOS と Model Context Protocol（MCP）を使用したロボット制御インターフェースとして機能し、ワークフローの設計と管理、および現在のハードウェア／ソフトウェア実行レイヤーとのやり取りを行います。

🧩 Claude Desktop へのワンクリックインストール（デスクトップ拡張機能）

1. ivoryos-mcp-<version>.mcpb をダウンロードします。
2. ダブルクリックします（または Claude Desktop にドラッグするか、「Settings」→「Extensions」→「Advanced settings」→「Install Extension…」を選択します）。
3. IvoryOS の URL、ユーザー名、パスワードを入力し、拡張機能を有効にします。

Claude Desktop が Python と依存関係を自動でセットアップするため、ほかにインストールするものはありません。拡張機能はお使いのコンピューター上で実行されるため、ネットワーク経由で IvoryOS に接続できれば利用できます。

.mcpb をビルドするには（このリポジトリから実行し、Node.js が必要です）：

npx @anthropic-ai/mcpb pack . ivoryos-mcp-<version>.mcpb

manifest.json の version を pyproject.toml と同期させてください。.mcpbignore により、.env とビルドファイルはバンドルに含まれません。

🚀 Claude Desktop でのクイックスタート（手動設定）

uv をインストールします。 設定ファイルを開き、IvoryOS MCP の設定を追加します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

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

📦 インストール

uv をインストールします。

1. リポジトリをクローンする

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

2. 依存関係をインストールする

IDE（例：PyCharm）を使用している場合、uv 環境が設定済みのことがあるため、このセクションはスキップできます。

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

⚙️ 設定

オプション 1：.env で IvoryOS の URL とログイン認証情報を変更します。

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

オプション 2：ivoryos_mcp/server.py で IvoryOS の URL とログイン認証情報を変更します。

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

🚀 サーバーのインストール（Claude Desktop）

mcp install ivoryos_mcp/server.py

✨ 機能

カテゴリー	機能	ルート	説明
ℹ️ 一般ツール	platform-info	GET /instruments	ivoryOS の情報とプラットフォームの署名を取得します
	execution-status	GET /executions/status	システムがビジー状態かどうか、および現在／最後のタスクの状態を確認します
ℹ️ ワークフロー設計	list-workflow-scripts	GET /library/<deck_name>	データベース内のすべてのワークフロースクリプトを一覧表示します
	load-workflow-script	GET /library/<workflow_name>	データベースからワークフロースクリプトを読み込みます
	submit-workflow-script	POST /draft/submit_python	ワークフローの Python スクリプトをデータベースに保存します
	get-optmizer-schema	POST /executions/optimizer_schema	すべてのオプティマイザーのスキーマを取得します
ℹ️ ワークフローデータ	list-workflow-data	GET /executions/records	利用可能なワークフロー実行データを一覧表示します
	load-workflow-data	GET /executions/records/<workflow_id>	実行ログとデータファイルを読み込みます
🤖 直接制御	execute-task	POST /instruments/<component>	プラットフォームの関数を直接呼び出します
🤖 ワークフロー実行	run-workflow-repeat	POST /executions/config	固定パラメーターでワークフロースクリプトを繰り返し実行します
	run-workflow-kwargs	POST /executions/config	動的パラメーターでワークフロースクリプトを実行します
	run-workflow-campaign	POST /executions/campaign	オプティマイザーを使ってワークフローキャンペーンを実行します
🤖 ワークフロー制御	pause-and-resume	GET /executions/pause-resume	ワークフローの実行を一時停止または再開します
	abort-pending-workflow	GET /executions/abort/next-iteration	現在のイテレーションを完了し、以降の実行を中止します
	stop-current-workflow	GET /executions/abort/next-task	現在のワークフローを安全に停止します

⚠️ ℹ️ はリソースですが、MCP Python SDK と Claude Desktop の統合に関する現在の問題により、ツールとして表示されています。
ℹ️ タスクには allow always のみを使用することをおすすめします。
🤖 タスクには allow once を使用してください。
これらのタスクは、ホストされている Python コードで実際のアクションを実行します。

🧪 例

プロンプトの例では、抽象的な SDL の例を使用します。

プラットフォーム情報

事前構築済みワークフロースクリプトを読み込む