MCP 3D Printer Server

🚀 MCP 3D プリンターサーバードキュメント

MCP 3D プリンターサーバーは、3D プリンターを制御および管理するためのツールです。RESTful API を通じたやり取りに対応しており、STL ファイルの処理、GCode の生成、印刷進捗の監視、基本的な温度制御を行うことができます。

✨ 主な機能

• STL ファイル操作: STL モデルファイルの読み取り、書き込み、および修正をサポートします。
• GCode 生成: PrusaSlicer などのスライシングツールを統合して、印刷コードを生成します。
• 温度監視と制御: プリンターの温度を設定および監視する機能を提供します。
• ファイル管理: プリンターへのファイルのアップロードとダウンロードをサポートします。
• 印刷状態照会: 現在の印刷タスクの状態情報を返します。

📦 インストール

1. まず、システムに Node.js（推奨バージョン 18.0.0 以上）がインストールされていることを確認してください。
2. npm を使用して MCP 3D プリンターサーバーをインストールします。

   npm install mcp-3d-printer-server
   

3. サービスを起動します。

   node index.js
   

📚 ドキュメント

インターフェースの概要

リクエストとレスポンスの例

モデルのアップロード

リクエスト例:

POST /api/models
Content-Type: multipart/form-data

file=@model.stl

レスポンス例:

{
  "status": "success",
  "message": "Model uploaded successfully.",
  "modelId": "12345"
}

モデルの処理

リクエスト例:

POST /api/models/12345/process
Content-Type: application/json

{
  "operations": ["extend_base", "slice", "check_temperatures"]
}

レスポンス例:

{
  "status": "success",
  "message": "Model processing started.",
  "taskId": "abc123"
}

💻 使用例

基本的な使用法

const express = require('express');
const app = express();

app.get('/api/models', (req, res) => {
    // モデルリストを返すロジック
});

app.post('/api/models', (req, res) => {
    // ファイルアップロードを処理するロジック
});

app.listen(3000, () => {
    console.log('Server running on port 3000');
});

高度な使用法

// 拡張基底操作
function extendBase(model) {
    // 拡張基底のロジックを実装
}

// スライシング処理
const slicer = new PrusaSlicer();
slicer.process('model.stl', 'output.gcode');

Bambu Lab プリンターの制限

特別な注意事項

• 印刷タスクの開始: 特定の API 呼び出しを通じて行う必要があります。
• 温度制御: 直接制御は制限される場合があり、提供されたインターフェースを使用する必要があります。
• ファイル管理: ファイルは特定の形式とサイズの要件を満たす必要があります。

🔧 技術詳細

拡張基底操作

function extendBase(model) {
    // 拡張基底のロジックを実装
}

スライシング処理

const slicer = new PrusaSlicer();
slicer.process('model.stl', 'output.gcode');

制限と注意事項

メモリ使用量

大きなモデルを処理する場合、サーバーに十分なメモリがあることを確認してください。

パフォーマンスの考慮

• マルチスレッドサポート: パフォーマンスを向上させるために、マルチコアプロセッサーで実行することをお勧めします。
• ディスク容量: STL ファイルと GCode の処理および保存に十分なストレージ容量があることを確認してください。

テストの提案

1. 本番環境にデプロイする前に、十分なテストを行ってください。
2. さまざまなサイズと複雑さのモデルを使用して検証してください。

📄 ライセンス

参考資料

1. Node.js 公式ドキュメント
2. PrusaSlicer API ドキュメント
3. RESTful API 設計ガイド

さらなるサポートが必要な場合や問題が発生した場合は、技術サポートにお問い合わせください。