Elegoo Mcp Server

Elegoo MCP Server

SDCP プロトコルを介して Elegoo 3D プリンターを制御するためのローカル MCP（Model Context Protocol）サーバーです。

完全ローカルで動作し、クラウドへの依存はありません。

⚠️ コンピューターとプリンターは同じローカルネットワーク（WiFi または Ethernet）に接続されている必要があります。

Elegoo Centauri Carbon と Claude Desktop でテスト済みです。MCP 対応クライアント（VS Code、Cursor など）であれば動作するはずです。

機能

機能	対応状況	備考
複数プリンターの管理	✓	プリンターの追加、削除、切り替え
接続／切断	✓	WebSocket 接続
ステータスの取得	✓	温度、位置、印刷の進捗
印刷の一時停止／再開／停止	✓
印刷の開始	✓	プリンター内のファイルから
ライトの制御	✓	オン／オフ
ファイル一覧	✓	印刷済みファイルのサムネイル付き
カメラストリーム	✓	ライブ MJPEG URL
温度制御	✗	SDCP 経由では非対応
ファン制御	✗	SDCP 経由では非対応
速度制御	✗	SDCP 経由では非対応
移動／原点復帰	✗	SDCP 経由では非対応
ファイルの削除	✗	SDCP 経由では非対応

✗ が付いた機能は、プリンターのタッチスクリーンから操作する必要があります。

前提条件

• Node.js 18+
• Elegoo Centauri Carbon（または SDCP 対応プリンター）
• プリンターが同じローカルネットワークに接続されていること

インストール

オプション 1：npx（推奨）

インストールは不要です！Claude Desktop を直接設定するだけです。

オプション 2：グローバルインストール

npm install -g elegoo-mcp-server

オプション 3：ソースから

git clone https://github.com/skribascode/elegoo-mcp-server.git
cd elegoo-mcp-server
npm install
npm run build

Claude Desktop の設定

Claude Desktop の設定ファイルに追加します。

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

npx を使用（推奨）

{
  "mcpServers": {
    "elegoo": {
      "command": "npx",
      "args": ["elegoo-mcp-server"]
    }
  }
}

グローバルインストールを使用

{
  "mcpServers": {
    "elegoo": {
      "command": "elegoo-mcp-server"
    }
  }
}

ローカルクローンを使用

{
  "mcpServers": {
    "elegoo": {
      "command": "node",
      "args": ["/path/to/elegoo-mcp-server/dist/index.js"]
    }
  }
}

保存後、Claude Desktop を再起動してください。

クイックスタート

1. MCP をインストールします（上記を参照）。
2. Claude Desktop を再起動します。
3. 「Elegoo プリンターに接続して」 と伝えます。
4. Claude がプリンターの IP アドレスを尋ねます。
5. 完了です！プリンターは今後のセッションでも保存されています。

使用例

"What's the printer status?"
"Pause the print"
"Resume printing"
"Turn on the light"
"Show me the files on the printer"
"Start printing benchy.gcode"
"Show me the camera"

利用可能なツール

起動

ツール	説明
elegoo_start	デフォルトのプリンターを初期化して接続
elegoo_setup	新しいプリンターを設定
elegoo_select	保存済みプリンターを切り替え

設定

ツール	説明
elegoo_add_printer	プリンターを追加
elegoo_remove_printer	プリンターを削除
elegoo_list_printers	保存済みプリンターを一覧表示
elegoo_set_default	デフォルトのプリンターを設定
elegoo_update_printer	プリンターの設定を更新

プリンターの制御

ツール	説明
elegoo_connect	プリンターに接続
elegoo_disconnect	接続を切断
elegoo_status	詳細なステータスを取得（温度、位置、進捗）
elegoo_wake	スリープ中のプリンターを起動
elegoo_pause	印刷を一時停止
elegoo_resume	印刷を再開
elegoo_stop	印刷をキャンセル
elegoo_start_print	印刷ジョブを開始
elegoo_set_light	ライトをオン／オフ
elegoo_list_files	ファイル／印刷履歴を一覧表示（✓ が付いたファイルは印刷済み）
elegoo_view_file	ファイルのサムネイルを表示（印刷済みファイルのみ）
elegoo_camera	カメラストリームの URL を取得

プロトコル

このサーバーは SDCP（Smart Device Control Protocol）v3.0.0 を実装しています。

• 接続： ws://{IP}:3030/websocket の WebSocket
• 設定の保存先： ~/.elegoo/config.json

既知の問題

• ファームウェア v1.1.29： 印刷中にライトを制御できない場合があります。ファームウェア v1.1.25 では正常に動作します。

作者

vibe coding で @skribascode が作成 ;-)

クレジット

• SDCP のドキュメント：OpenCentauri
• プロトコルのリファレンス：sdcp-centauri-carbon

ライセンス

MIT