OriginLab-MCP

OriginLab Origin용 MCP 서버입니다. 워크시트를 읽고 쓰고, 다중 패널 그래프를 만들고 스타일을 지정하며, 그림을 내보냅니다. 그리고 Origin이 수락한 것과 Origin이 실제로 수행한 것 사이의 차이에 주의를 기울입니다.

1.0.0. 여기의 모든 도구는 실제 Origin 2024에서 실행되었고, Origin App이 브리지를 설치하고 시작하며, examples/five_panel_figure.py가 5개 패널 그림을 처음부터 끝까지 만듭니다.

알려진 한계를 미리 밝혀 두므로 놀라지 않도록 합니다. 모서리에 배치된 범례는 패널 내부에 있는지 확인할 뿐, 데이터 위에 있는지 확인하지 않습니다. 로그 축은 요청하지 않으면 보조 눈금이 없습니다. 그리고 213개 항목의 옵션 표는 각 옵션이 실제로 무엇을 했는지 측정한 것이 아니라 Origin이 문서화한 것을 기록한 것입니다. 그중 16개는 실제로 그림을 변화시키는 것이 관찰되었습니다.

요구 사항

• Origin 또는 OriginPro 2021b 이상(임베디드 Python 3.9+)

• 서버용 Python 3.10+

• Windows(네이티브 또는 VM)

Related MCP server: Aspose.Cells Cloud MCP Server

설치

pip install originlab-mcp
originlab-mcp --build-app .

이 명령은 Origin이 필요한 세 단계를 출력하는데, 여기서 명시할 가치가 있습니다. 왜냐하면 가장 쉽게 보이는 방법은 아무 효과도 없기 때문입니다: 폴더를 Apps 갤러리에 끌어다 놓으면 조용히 수락될 뿐 버튼이 추가되지 않습니다. 생성된 OriginLab MCP Bridge 폴더를 %LOCALAPPDATA%\OriginLab\Apps에 복사하고, Origin의 Command Window에서 다음 명령으로 패키징합니다.

mkOPX app:="OriginLab MCP Bridge" opx:="C:\path\to\OriginLab MCP Bridge.opx";

— 백슬래시를 사용해야 합니다. 왜냐하면 슬래시는 mkOPX를 멈추게 하기 때문입니다. — 그리고 결과 .opx 파일을 Origin으로 끌어다 놓습니다. 버튼이 나타납니다. 버튼을 클릭하면 Script Window가 앞으로 나오며, 브리지가 starting, loaded, serving을 보고합니다.

MCP 클라이언트를 originlab-mcp에 연결합니다.

originlab-mcp --status는 브리지가 듣고 있는지 알려주고, 대기가 없으면 0이 아닌 상태로 종료합니다. originlab-mcp --stop은 종료합니다.

중지는 두 번째 버튼이 아니라 명령으로 하는 이유는 버튼이 스스로 작업을 수행해서는 안 되기 때문입니다: 브리지가 서비스하는 동안 Origin의 UI 스레드를 보유하므로, 버튼이 실행한 모든 것은 메시지 펌프 내부에서 실행될 것입니다. 외부 프로세스만 시작하는 버튼은 가능합니다 — 그것이 업스트림 프로젝트가 하는 방식입니다 — 하지만 명령은 여전히 소켓을 통해 브리지에 도달해야 하며, --stop은 그러한 명령을 중간 단계 없이 전달하는 것입니다.

무엇이 다른가

Origin은 말없이 무시하는 것을 많이 수락합니다.

• set <plot> -zzzz 9 — Origin이 들어본 적 없는 옵션 —은 true를 반환하고 9.0으로 다시 읽히며 그래프를 픽셀 단위로 동일하게 유지합니다.

• plot:=2003은 플롯 유형이 아닙니다. Origin은 플롯하지 않고 창을 만들고, 축을 그리고, 범례를 작성합니다.

• 그룹 내부 플롯에 작성된 스타일은 요청된 대로 정확히 다시 읽히지만, Origin은 그룹 스타일을 계속 그립니다.

이 중 어느 것도 응답에서 잡을 수 없습니다. 그래서 확인은 쓰기 전과 그림 후에 수행됩니다:

쓰기 전. 옵션은 Origin의 자체 문서화된 목록을 기준으로 확인되며, 지어낸 옵션은 거부됩니다. 이는 실제 이름을 추측할 수 없기 때문에 중요합니다. 그러나 그 생성 이름이 무엇이었을지 추적되지 않습니다 — 선선 굵기는가 -w, 막대 채우기 패턴은 -pfp — 그렇기 때문에 그럴듯한 추측이 오타 대신 실패로 이어질 수 있습니다. 그룹화된 플롯 멤버에 쓰기는 즉시 거부됩니다. 플롯 유형은 문서에서 가져온 것이 아니라 Origin 설치의 oPlotIDs.h에서 가져오며, 테이블의 모든 이름이 그리고 관찰되었습니다.

그림 후. 호출별 체크는 중요한 질문, 즉 그림이 올바른지에 도달할 수 없습니다. 그래서 그림을 만드는 작업은 자신을 모순할 수 있는 것을 보고합니다:

이 목록은 측정된 실패 때문에 존재합니다. 모든 23단계가 OK 상태를 보고했지만 그 결과를 쓸 수 없었던 5패널 그림이었습니다. 하나의 범례가 6432 너비 페이지에서 left = 24953에 배치되었습니다 — legend.x는 데이터 좌표에 있으며, 그것이 주어진 백분율이 아닙니다 — Origin의 내보내기가 포함하는 캔버스를 확장하여 그림을 구석에 밀어 넣었습니다. 어떤 응답에서도 무엇이 잘못되었는지 알 수 없었습니다.

읽음 다시 읽기는 증명으로가 아니라 읽기로 보고됩니다:

{
  "requested": 60,
  "readback": {"readable": true, "value": 60.0, "matches_request": true},
  "readback_means": "Origin stored this value where 'get' can find it. It is not
                     proof that the graph changed: Origin also stores options it
                     does not recognise."
}

그래프를 내보내는 것만이 문제를 해결하는 유일한 방법입니다. 그래서 origin_graph_export는 사진 저장 방법이 아닌 일반 도구입니다.

이 서버가 지정에 없는 인수는 거부합니다. 가장 가까운 이름을 가진 인수로 거부합니다. Origin에서 그것이 지켜는 것과 같은 실패가 여기서 먼저 발견되었습니다: worksheet_read는 max_rows를 받지만, rows=3을 전달하는 호출은 시트의 모든 행을 가져왔고 인자가 무시되었는지 알지 못했습니다.

도구 표면은 의도적으로 작습니다. 차트 유형별 하나가 아닌 plot_type 매개변수가 있는 하나의 plot 도구, 속성별 래퍼가 아닌 하나의 plot_option_get/set 쌍이 있습니다.

도구

examples/five_panel_figure.py는 5 패널 그림을 처음부터 끝까지 만들고 모든 단계에서 그 숫자를 인쇄합니다.

설정

Windows, 모두 로컬 — 일반적인 경우입니다. 서버와 Origin은 같은 컴퓨터에 있으며 TCP에서 통신합니다.

Windows VM에서 Origin, macOS 또는 Linux에서 작업 — 지원합니다. 서버는 VM 내부에서 SSH로 실행되고, 호스트에는 MCP 클라이언트만 있습니다. 이것은 서버가 COM이 아닌 루프백 소켓으로 Origin에 연결하기 때문에 작동합니다. COM은 Windows 세션 경계를 넘을 수 없습니다.

MCP client  ──ssh──▶  server (Windows)  ──TCP 127.0.0.1──▶  Origin

docs/remote-origin.md는 이 과정을 안내합니다: ssh 서버, 직접 키(Windows가 관리자를 다른 파일에 넣고 일반 키를 말없이 무시), 그리고 MCP 클라이언트를 그에 포인팅하는 방법.

Origin의 동작에 대한 참고 사항

여기서 측정한 것 중 어떤 문서에도 언급되지 않은 것:

• originpro는 절대적으로 단일 스레드입니다. Origin의 UI 스레드가 아닌 다른 스레드에서 호출하면 GIL 응 보유하고 차단하여 임베디드 인터프리터 전체가 교착 상태가 됩니다. Origin의 창은 여전히 반응하지만 Python은 사라집니다. 그렇지만 브리지는 그 스레드에 서비스를 제공하며 요청 사이에 Origin의 메시지 큐를 펌패습니다.

• 모달 대화상자는 브리지를 중지합니다. 대화상자가 브리지가 서비스하는 스레드를 보유하기 때문입니다 — 핸드셰이크 파일은 계속 유지되는 것처럼 보여줍니다. 존재하지 않는 디렉터리로 내보내면 대화상자가 열리므로, 내보내기를 보내기 전에 확인합니다.

• 범례는 다른 공간에서 두 쌍좌표를 가집니다. legend.x/legend.y는 레이어의 데이터 좌표입니다 — legend.left/.top은 페이지 좌표이며 page.width와 같은 단위입이다.

• plotxy ogl:=<new>는 새 페이지가 아니라 새로운 레이어를 만듭니다. 활성화되지 않습니다. [<new>]가 새 페이지입니다.

• Origin은 막대 그래프에 대해 축을 교환합니다. 그럼에도 레이어 속성을 통해 보고하지 않습니다. 제목 객체를 일치시켜 회전을 유지하므로 값 축 제목이 프레임 아래에 bottomtotop으로 나타납니다.

• -w는 포인트 × 500입니다; -wp는 포인트를 사용합니다. 포인트 값을 -w에 전달하면 오번 대신 가는 선이 생성됩니다.

• -pfp만으로 설정된 채우기 패턴은 보이지 않습니다: Origin은 그것을 채우기 색상으로 그리므로 -pfc도 필요합니다. 그리고 둘 다 자체적으로는 아무것도 변경하지 않습니다.

• LabTalk는 첫 번째 거부된 문에서 중지합니다. 따라서 실패를 보고하는 스크립트는 그 자체의 알 수 없는 접두사를 실행했습니다.

• Origin은 명령을 실행하는 동안 Python을 시작하지 않으며, 모든 브리지 요청은 명령입니다. run -pyf 또는 py.exec를 포함하는 스크립트는 설명 없이 실패하는 것이 아니라 처음부터 거부됩니다.

참고 자료

• Ge-Shun/origin-mcp — 이 프로젝트의 아키텍처가 따르는 내장 브리지 전송 방식입니다.

• garethbeaumo/originlab-mcp — COM에 연결된 서버; Origin이 동일한 데스크톱 세션에 있을 때 더 간단하게 실행할 수 있습니다.

• Origin LabTalk reference · originpro

Origin 및 OriginPro은 OriginLab Corporation의 상품입니다. 이 프로젝트는 OriginLab의 프로젝트가 아닙니다.

라이선스

MIT.# OriginLab-MCP

OriginLab Origin을 위한 MCP 서버입니다. 워크시트를 읽고 쓰고, 다중 패널 그래프를 만들고 스타일을 지정하며, 그림을 내보냅니다. 그리고 Origin이 수락한 것과 Origin이 실제로 수행한 것 사이의 차이를 주의 깊게 다룹니다.

1.0.0. 여기의 모든 도구는 실제 Origin 2024에서 실행되었고, Origin App은 브리지를 설치하고 시작하며, examples/five_panel_figure.py는 5개의 패널 그림을 처음부터 끝까지 만듭니다.

알려진 한계점을 미리 밝히므로 놀라지 않도록 합니다: 구석에 배치한 범례는 데이터 위에 있는지가 아니라 패널 내부에 있는지 확인됩니다. 로그 축은 요청하지 않는 한 보조 눈금이 없습니다. 그리고 213개 항목의 옵션 표는 각 옵션이 어떻게 동작했는지 측정한 것이 아니라 Origin이 문서화한 내용을 기록합니다. 그중 16개는 실제로 그림을 바꾸는 것이 관찰되었습니다.

요구 사항

• Origin 또는 OriginPro 2021b 이상(내장 Python 3.9+)

• 서버에는 Python 3.10+

• Windows(네이티브 또는 VM)

설치

pip install originlab-mcp
originlab-mcp --build-app .

위 명령은 Origin에 필요한 세 단계를 출력하는데, 여기서 명시해서 언급할 가치가 있습니다. 가장 분명한 방법이 아무 효과가 없기 때문입니다: 폴더를 Apps 갤러리에 끌어다 놓으면 조용히 수락될 뿐 버튼이 추가되지 않습니다. 생성된 OriginLab MCP Bridge 폴더를 %LOCALAPPDATA%\OriginLab\Apps에 복사하고, Origin의 Command Window에서 다음 명령으로 패키징합니다.

mkOPX app:="OriginLab MCP Bridge" opx:="C:\path\to\OriginLab MCP Bridge.opx";

— 백슬래시를 사용해야 합니다. 정슬래시는 mkOPX를 중단시키기 때문입니다. — 생성된 .opx 파일을 Origin으로 끌어다 놓습니다. 버튼이 나타납니다. 클릭하면 Script Window가 앞으로 나오며, 브리지가 starting, loaded, serving을 보고합니다.

MCP 클라이언트를 originlab-mcp에 연결하십시오.

originlab-mcp --status는 브리지가 수신 대기 중인지 알려주며, 수신 대기 중이 아닐 때 0이 아닌 상태로 종료합니다. originlab-mcp --stop은 종료합니다.

중지는 두 번째 버튼이 아니라 명령으로 하는 이유는, 버튼이 작업 자체를 수행하면 안 되기 때문입니다. 브리지가 서비스하는 동안 Origin의 UI 스레드를 잡고 있으므로, 버튼이 실행하는 것은 모두 메시지 펌프 내부에서 실행됩니다. 외부 프로세스만 실행하는 버튼도 만들 수 있습니다 — 업스트림 프로젝트가 그렇게 합니다 — 그러나 명령은 여전히 소켓을 통해 브리지에 전달되어야 하며, --stop은 그 간접 없이 전달하는 명령입니다.

무엇이 다른가

Origin은 말없이 무시하는 많은 것을 수락합니다.

• set <plot> -zzzz 9 — Origin이 들어본 적 없는 옵션 — true를 반환하고 9.0으로 다시 읽히며 그래프를 픽셀 단위로 동일하게 유지합니다.

• plot:=2003은 플롯 유형이 아닙니다. Origin은 플롯 없이 창을 만들고, 축을 그리며, 범례를 작성합니다.

• 그룹 내 플롯에 작성한 스타일은 요청한 대로 정확히 다시 읽히지만, Origin은 그룹의 스타일을 계속 그려나갑니다.

이 중 어느 것도 응답에서 잡을 수 없으므로, 확인은 쓰기 전과 그림 후에 수행됩니다.

쓰기 전. 옵션은 Origin 자체의 문서화된 목록과 확인되며, 지어낸 옵션은 거부되고 실제로 원래 유용했던 옵션을 제안합니다. 이것이 중요한 이유는 실제 이름을 추측할 수 없기 때문입니다 — 선 굵기는 -w, 막대 채우기 패턴은 -pfp — 그렇기 때문에 그럴듯한 추측은 오타가 아니라 유능한 실패입니다. 그룹화된 플롯 멤버에 쓰기는 바로 거부됩니다. 플롯 유형은 설명서가 아니라 Origin 설치의 oPlotIDs.h에서 가져오며 표의 모든 이름은 그리고 관찰되었습니다.

쓴 후. 호출 단위 확인은 중요한 질문, 즉 그림이 올바른지 맞는지는 닿을 수 없습니다. 그래서 그림을 만드는 작업은 그 자신에 모순될 수 있는 것을 보고합니다:

이 목록은 측정된 실패 때문에 존재합니다. 23단계 모두 성공을 반환했는데 결과를 전혀 쓸 수 없었던 5패널 그림 말입니다. 한 범례가 폭 6432 페이지에 left = 24953에 배치되었습니다 — legend.x는 데이터 좌표이지 백분율이 아니라 — 그리고 Origin의 내보내기에서 그것을 포함하기 위해 캔버스를 확장하여 그림을 구석에 밀어서 넣었습니다. 어떤 응답에서도 문제가 있다는 말이 없었습니다.

다시 읽기는 다시 읽기로 보고될 뿐, 증거로 보고되지 않습니다:

{
  "requested": 60,
  "readback": {"readable": true, "value": 60.0, "matches_request": true},
  "readback_means": "Origin stored this value where 'get' can find it. It is not
                     proof that the graph changed: Origin also stores options it
                     does not recognise."
}

그래프를 내보내는 것만이 성공을 확인하는 방법입니다. 그렇기 때문에 origin_graph_export는 사진 저장 방식이 아니라 근본적으로 중요한 도구입니다.

이 서버가 처리하지 않는 인자는 거부합니다. 이 서버가 처리하는 가장 가까운 이름을 제시합니다. 이 서버가 Origin에서 보호하는 동일한 실패가 여기서 먼저 발견되었습니다: worksheet_read는 max_rows를 받아들이고, rows=3을 전달한 호출은 시트의 모든 행을 반환했으며 인자가 무시된 것에 대한 아무런 표시도 없었습니다.

도구의 표면은 의도적으로 작게 유지합니다. 차트 유형별로 하나가 아닌 plot_type 파라미터를 가진 하나의 plot 도구; 속성별 래퍼가 아닌 하나의 plot_option_get/set 쌍.

Tools

examples/five_panel_figure.py는 5패널 그림을 처음부터 끝까지 만들고 모든 단계에서 그 그림과 모순될 수 있는 값을 출력합니다.

설정

Windows에서 모든 것이 로컬 — 일반적인 경우입니다. 서버와 Origin이 동일한 머신에 있고, 루프백 TCP로 통신합니다.

Windows VM에서 Origin 실행, macOS 또는 Linux에서 작업 — 지원됩니다. 서버는 ssh를 통해 VM 내부에서 실행되고, MCP 클라이언트만 호스트에 있습니다. 서버가 COM이 아닌 루프백 소켓을 통해 Origin에 접근하기 때문에 동작합니다.

MCP client  ──ssh──▶  server (Windows)  ──TCP 127.0.0.1──▶  Origin

docs/remote-origin.md가 그 과정을 안내합니다: ssh 서버, 키(Windows는 관리자의 키를 다른 파일에 넣고 일반 키를 말없이 무시합니다), MCP 클라이언트를 연결하는 방법.

Origin의 동작에 대한 노트

다른 설명서에는 없는 측정 결과:

• originpro는 완전히 단일 스레드입니다. Origin의 UI 스레드를 제외한 어떤 스레드에서 호출하면 GIL을 가진 채 차단하여 임베디드 인터프리터 전체가 교착합니다. Origin의 창은 반응하지만 Python은 없어집니다. 브리지는 해당 스레드에서 서비스하고 요청 사이에 Origin의 메시지 큐를 펌핑합니다.

• 모달 대화 상자는 브리지를 중지합니다. 대화 상자가 브리지가 서비스하는 스레드를 잡고 있기 때문입니다. 핸드셰이크 파일은 계속 켜져 있다고 말하지만. 존재하지 않는 디렉터리에 내보내면 대화 상자가 열리므로, 내보내기를 보내기 전에 확인합니다.

• 범례에는 다른 공간에 있는 두 쌍의 좌표가 있습니다. legend.x/legend.y는 레이어의 데이터 좌표이고; legend.left/.top은 page.width가 보고하는 것과 동일한 페이지 좌표입니다.

• plotxy ogl:=<new>는 새 페이지가 아니라 새 레이어를 만들고 활성 상태가 아닙니다. [<new>]가 새 페이지입니다.

• Origin은 막대 차트에 대해 축을 교체하며 어떤 레이어 속성으로도 보고하지 않습니다. 제목 개체를 이동하여 일치시키고 회전을 유지하므로, 값 축 제목이 아래에서 위로 읽히는 프레임 아래에 오게 합니다.

• -w는 포인트 × 500입니다; -wp는 포인트를 받습니다. 포인트 값을 -w에 전달하면 오류가 아닌 가는 선을 그립니다.

• -pfp만으로 설정한 채우기 패턴은 보이지 않습니다: Origin이 채우기 색상으로 그러므로, -pfc도 필요하고, 둘 중 하나도 단독으로는 아무것도 변경하지 않습니다.

• LabTalk는 첫 번째 거부하는 문에서 중지합니다, 성공을 보고하는 스크립트는 자신이 알지 못하는 접두사를 실행했습니다.

• Origin은 명령이 실행되는 동안 Python을 시작할 수 없으며, 모든 브리지 요청이 명령입니다. run -pyf 또는 py.exec를 포함하는 스크립트는 설명 없는 실패가 아니라 처음부터 거부입니다.

참고 문헌

• Ge-Shun/origin-mcp — 이 프로젝트 아키텍처가 따르는 임베디드 브리지 전송 방식입니다.

• garethbeaumo/originlab-mcp — COM 연결 서버; Origin이 동일한 데스크톱 세션에 있을 때 실행이 더 간단합니다.

• Origin LabTalk reference · originpro

Origin과 OriginPro는 OriginLab Corporation의 제품입니다. 이 프로젝트는 OriginLab과 관련이 없습니다.

라이선스

MIT.