ParaView MCP

ParaView를 Model Context Protocol을 통해 LLM 어시스턴트에 연결하세요.

파이썬 서버는 FastMCP 3.x를 기반으로 구축되었습니다. 2026-07-28 MCP 사양에 대한 지원은 FastMCP 4가 안정적인 릴리스에 도달하면 계획되어 있습니다.

paraview-mcp-server는 두 개의 런타임 부분으로 구성됩니다:

• ParaView 플러그인 (C++/Qt): ParaView GUI 내부에 TCP 브리지를 노출합니다.

• 파이썬 MCP 서버: 플러그인에 연결하고 모든 MCP 클라이언트에 도구를 제공합니다.

사전 요구 사항

• ParaView ≥ 5.13. 아래 나열된 정확한 버전 및 플랫폼에 대해 사전 빌드된 플러그인이 제공됩니다. 다른 ParaView 릴리스는 일치하는 SDK로 소스 빌드가 필요합니다.

• uv

Related MCP server: MCP-Slicer

빠른 시작

먼저 ParaView 플러그인을 설정하세요. 그런 다음 한 번의 명령으로 Claude Code에 파이썬 MCP 서버를 추가하세요:

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

ParaView에서 도구 > ParaView MCP를 열고 브리지를 시작한 다음 Claude Code에서 연결하세요.

ParaView 플러그인 설정

최신 GitHub 릴리스에서 사전 빌드된 플러그인 바이너리를 다운로드하세요. 릴리스는 다음 매트릭스를 제공합니다:

정확한 ParaView 버전과 플랫폼을 명명한 패키지를 선택하세요. 인접한 .sha256 파일을 다운로드하여 패키지를 확인한 다음, 열거나 추출하고 포함된 INSTALL.md를 따르세요. Pull Request도 해당 플랫폼 바이너리를 단기 GitHub Actions 아티팩트로 생성합니다. GitHub 릴리스가 영구 배포 채널입니다.

macOS 릴리스 이미지는 Developer ID로 서명되고, Apple에서 공증되었으며, 스테이플링된 공증 티켓이 포함되어 있습니다. .dmg를 열고, 포함된 플러그인 디렉터리를 영구 위치로 복사한 다음, 복사된 디렉터리에서 ParaViewMCP.so를 로드하세요. Pull Request 아티팩트는 서명되지 않은 테스트 빌드이며 .tar.gz 파일로 유지됩니다.

또는 ParaView 5.13 이상 SDK에 대해 소스에서 플러그인을 빌드하세요. 전체 빌드 지침은 CONTRIBUTING.md를 참조하세요. 바이너리 호환성은 릴리스 시리즈별로 다르므로, 사용 중인 ParaView major.minor 버전에 맞게 빌드된 플러그인을 사용하세요.

설치가 완료되면:

1. ParaView에서 도구 > 플러그인 관리를 엽니다.

2. **새로 로드...**를 클릭하고 플러그인 디렉터리에서 ParaViewMCP.so (Linux/macOS) 또는 ParaViewMCP.dll (Windows)을 선택합니다.

3. 자동 로드를 활성화합니다.

4. 도구 > ParaView MCP를 엽니다.

5. 서버 시작을 클릭합니다.

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. 우리는 ParaView 세션 내에서 임의의 Python을 실행하는 execute_paraview_code 도구를 제공합니다. 플러그인은 각 실행을 기록하고, ParaView가 파이프라인 스냅샷을 캡처할 수 있을 때 사용자가 해당 실행 직전의 상태로 복원할 수 있도록 합니다. 이렇게 하면 생성된 스크립트를 검사, 재사용 및 배치 처리와 같은 작업에 적용하기가 더 쉬워집니다.

2. 아키텍처적으로, ParaView_MCP의 자체 고지에 따르면 pvserver와 ParaView 클라이언트 간의 동기화에 의존합니다. 해당 동기화 메커니즘은 최근 ParaView 버전에서 더 이상 사용되지 않으며, 잘못된 애플리케이션 뷰 및 일반적인 안정성 문제를 일으킬 수 있습니다. 이 프로젝트는 대신 대화형 ParaView 프로세스 내에서 플러그인을 실행하고 TCP 브리지를 노출하여 pvserver/클라이언트 동기화 경로를 완전히 피합니다.

기여

빌드 지침, 개발 환경 설정 및 풀 리퀘스트 가이드라인은 CONTRIBUTING.md를 참조하세요.

라이선스

MIT — 종속성 라이선스는 THIRD-PARTY-NOTICES.txt를 참조하세요.