ParaView MCP

ParaView を Model Context Protocol を通じて LLM アシスタントに接続します。

Python サーバーは FastMCP 3.x で構築されています。 2026-07-28 MCP 仕様のサポートは、FastMCP 4 が安定版リリースに達した後に計画されています。

paraview-mcp-server は2つのランタイム部分で構成されています：

• ParaView プラグイン (C++/Qt) — ParaView GUI 内に TCP ブリッジを公開します

• Python MCP サーバー — プラグインに接続し、任意の MCP クライアントにツールを提供します

前提条件

• ParaView ≥ 5.13。プリビルド済みプラグインは 以下に記載された正確なバージョンとプラットフォームで利用可能です。その他の ParaView リリースでは、 対応する SDK を使用したソースビルドが必要です。

• uv

Related MCP server: MCP-Slicer

クイックスタート

まず ParaView プラグインをセットアップ します。その後、以下の1コマンドで Python MCP サーバーを Claude Code に追加します：

claude mcp add paraview -- uvx paraview-mcp-server

ParaView で Tools > ParaView MCP を開き、ブリッジを起動して Claude Code から接続します。

ParaView プラグインのセットアップ

最新の GitHub リリース からプリビルド済みのプラグインバイナリをダウンロードします。リリースでは以下のマトリックスが提供されています：

お使いの ParaView の正確なバージョンとプラットフォームに該当するパッケージを選択してください。隣接する .sha256 ファイルをダウンロードし、パッケージを検証した後、開くか展開して、含まれている INSTALL.md に従ってください。プルリクエストからも、短命の GitHub Actions アーティファクトとして対応するプラットフォームのバイナリが生成されます。GitHub リリースが恒久的な配布チャネルです。

macOS リリースイメージは Developer ID 署名され、Apple による公証が行われ、ステープルされた公証チケットが含まれています。 .dmg を開き、含まれているプラグインディレクトリを永続的な場所にコピーし、そのコピーしたディレクトリから ParaViewMCP.so をロードしてください。プルリクエストのアーティファクトは署名なしのテストビルドであり、.tar.gz ファイルのままです。

あるいは、ParaView 5.13 以降の SDK に対してソースからプラグインをビルドすることもできます。完全なビルド手順については CONTRIBUTING.md を参照してください。バイナリ互換性はリリースシリーズ固有ですので、使用する ParaView のメジャー.マイナーバージョン用にビルドされたプラグインを使用してください。

インストール後：

1. ParaView で Tools > Manage Plugins を開きます。

2. Load New... をクリックし、プラグインディレクトリから ParaViewMCP.so（Linux/macOS）または ParaViewMCP.dll（Windows）を選択します。

3. Auto Load を有効にします。

4. Tools > ParaView MCP を開きます。

5. Start Server をクリックします。

ParaView MCP パネルには接続状態と実行履歴が表示されます。非ループバックのバインドには認証トークンが必要です。

MCP クライアントの設定

Claude Code (CLI)

claude mcp add paraview -- uvx paraview-mcp-server

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "paraview": {
      "command": "uvx",
      "args": ["paraview-mcp-server"]
    }
  }
}

その他の MCP クライアント

uvx をコマンド、paraview-mcp-server をその唯一の引数として、ローカルの stdio MCP サーバーを設定します：

{
  "mcpServers": {
    "paraview": {
      "command": "uvx",
      "args": ["paraview-mcp-server"]
    }
  }
}

お使いのクライアントのドキュメントで、MCP サーバー設定ファイルの場所と正確な形式を確認してください。

設定

サーバーは以下の環境変数を使用して ParaView プラグインに接続します：

デフォルト値は標準的なローカル設定で動作します。リモートマシン上の ParaView や非標準ポートに接続する場合は、これらを上書きしてください：

{
  "mcpServers": {
    "paraview": {
      "command": "uvx",
      "args": ["paraview-mcp-server"],
      "env": {
        "PARAVIEW_HOST": "192.168.1.10",
        "PARAVIEW_PORT": "9877",
        "PARAVIEW_AUTH_TOKEN": "your-token"
      }
    }
  }
}

利用可能なツール

設計思想と ParaView_MCP との違い

このプロジェクトは Blender-MCP や Slicer-MCP のアプローチに従っており、いずれも LLM にそれぞれのアプリケーションランタイム内での直接的なコード実行を許可しています。

既存の ParaView_MCP 実装¹は異なるアプローチをとっており、基礎となる Python ランタイムにアクセスせず、固定された高レベルツールセットを公開するため、カスタムワークフローの柔軟性が制限されます。主な違いは以下の通りです：

1. execute_paraview_code ツールを提供し、ParaView セッション内で任意の Python を実行できるようにしています。 プラグインは各実行を記録し、ParaView がパイプラインスナップショットを取得できる場合、 ユーザーがその実行の直前の状態に復元できるようにします。これにより、生成されたスクリプトの 検査、再利用、バッチ処理などのタスクへの適用が容易になります。

2. アーキテクチャ的には、ParaView_MCP 自身の免責事項 は、pvserver と ParaView クライアント間の同期に依存していることを述べています。 その同期メカニズムは最近の ParaView バージョンでは非推奨であり、誤ったアプリケーションビューや 全般的な安定性の問題を引き起こす可能性があります。本プロジェクトは代わりに、対話型 ParaView プロセス内で プラグインを実行し、TCP ブリッジを公開することで、pvserver/クライアントの同期経路を完全に回避しています。

コントリビューション

ビルド手順、開発環境のセットアップ、プルリクエストのガイドラインについては CONTRIBUTING.md を参照してください。

ライセンス

MIT — 依存ライブラリのライセンスについては THIRD-PARTY-NOTICES.txt を参照してください。