PicToSTL

pictostl-mcp

pictostl.com 用のローカル stdio MCP サーバーです。生成処理は pictostl.com で実行されます。このパッケージは写真をアップロードして 3D ジョブを開始し、MCP サーバーをホストするマシンに GLB または STL ファイルを書き込みます。

結果は、ビジュアライゼーションや 3D プリントの実験向けに AI が再構築したメッシュです。エンジニアリング図面ではありません。

これは GitHub リポジトリから配布されるローカル stdio MCP サーバーです。pictostl.com はリモート MCP HTTP エンドポイントをホストしていません。

アーキテクチャとデータフロー

MCP client → local pictostl-mcp process → pictostl.com API
                                      ← generation status and GLB
MCP client ← local GLB/STL file       ←

MCP プロセスはローカルで実行され、HTTPS 経由で https://pictostl.com と通信します。画像、生成パラメーター、API キーは、入力のアップロード、ジョブの作成、結果の取得のために pictostl.com に送信されます。GLB から STL への変換と最終ファイルの書き込みは、MCP サーバーを実行しているマシン上でローカルに行われます。

ホスト型の PicToSTL MCP エンドポイントはありません。MCP クライアントはこのパッケージを stdio 経由でローカルに起動し、ローカルプロセスがホスト型の PicToSTL API を呼び出します。

API キーを取得する

1. サインアップ
2. API キーでキーを作成
3. 料金プランでクレジットを購入

API またはこの MCP サーバーを使用することで、利用規約に同意したものとみなされます。

ウェブサイトのブラウザー経由での生成は、MCP とは別のものです。MCP では常に API キーを使用します。

GitHub からインストールする

Node.js 20 以降が必要です。以下のコマンドは npm の Git サポートを使ってリポジトリをインストールし、コミット済みの JavaScript ビルドを実行します。公開済みの npm パッケージやローカルの TypeScript コンパイラーは必要ありません。

Claude / Cursor の設定

{
  "mcpServers": {
    "pictostl": {
      "command": "npx",
      "args": [
        "-y",
        "--package=github:qduoduo-hwh/pictostl-mcp",
        "pictostl-mcp"
      ],
      "env": {
        "PICTOSTL_API_KEY": "ps_live_..."
      }
    }
  }
}

PICTOSTL_API_KEY に https://pictostl.com/settings/api-keys の有効なキーを設定してください。

任意：ローカルのウェブサイトを使用する場合は PICTOSTL_API_BASE を設定します（デフォルトは https://pictostl.com）。

API キーは、MCP クライアントのシークレットまたはユーザーレベルの設定に保存してください。有効なキーをソース管理にコミットしないでください。

バージョンを固定してインストールするには、リポジトリ名の後に Git タグまたはコミットを追加します。たとえば github:qduoduo-hwh/pictostl-mcp#v0.1.0 のように指定します。

ローカル開発

git clone https://github.com/qduoduo-hwh/pictostl-mcp.git
cd pictostl-mcp
corepack enable
pnpm install --frozen-lockfile
pnpm build

次に、MCP クライアントが node を実行し、最初の引数として dist/index.js の絶対パスを渡すように設定してください。

ツール

MCP ツールは 7 つあります。

ツール	用途
list_generation_options	品質、テクスチャ、複数視点のルール、クレジットコスト
upload_image	ローカルファイルまたは HTTPS URL をアップロードし、assetId を返す
generate_model	非同期の 3D ジョブを開始する（省略した場合も clientRequestId を送信）
get_task	タスク ID で生成結果を取得する。waitSeconds は任意（最大 60）
list_my_generations	この API キーでの最近の生成を一覧表示する
get_account	残りのクレジットと、Pro / Ultra の有料クレジットの状態
download_model	元の GLB、またはローカルで生成したバイナリ STL を指定したパスに書き込む

一般的な流れ：upload_image → generate_model → get_task（60 秒を超える場合は同じタスク ID で繰り返す）→ そのタスク IDを指定して download_model。

アップロードの assetId を get_task または download_model に渡さないでください。

download_model のデフォルトは format=stl で、最長辺は100 mmです。元の GLB からローカルで変換されます（ウェブサイトのプレビュー用メッシュではありません）。STL に含まれるのはジオメトリのみで、色やテクスチャはありません。format=glb を指定すると、元のファイルが変更されずに書き込まれます。

同じジョブを再試行するときは、以前の generate_model の結果に含まれる clientRequestId を再利用してください。

コントリビューション

エージェントが適切なツールを適切なフィールドで呼び出せるよう、ツールの説明を改善してください。内部の fal プロンプトやプロバイダーのペイロードを求めないでください。

ライセンス

MIT