gauss-mcp

Python에서 GAUSS를 구동하고, Model Context Protocol을 통해 LLM 클라이언트에 노출합니다.

저자: Dr Merwan Roudane

GAUSS 26.1.1을 대상으로 Windows에서 빌드하고 테스트했습니다.

존재 이유

Aptech는 AI 어시스턴트가 더 나은 GAUSS 코드를 작성하도록 AI 어시스턴트용 레퍼런스를 제공하지만, 작성하는 것과 실행하는 것은 다릅니다. 코드를 실행할 수 없는 어시스턴트는 코드가 작동했는지, 숫자가 무엇이었는지 결코 알 수 없습니다. 이 프로젝트는 어시스턴트를 실제 GAUSS 설치에 연결하므로 결과는 모델이 아니라 GAUSS에서 나옵니다.

Related MCP server: julia-mcp

GAUSS 구동 방식

tgauss를 통해 구동합니다. tgauss는 일반 GAUSS 설치에 포함된 터미널 빌드로, 더 풍부한 기능을 제공하지만 Aptech의 별도 라이선스 키가 필요한 GAUSS Engine이 아닙니다.

각 호출은 자체 tgauss 프로세스이므로 일반적으로 아무것도 이어지지 않습니다. 작업 공간은 나갈 때 저장되고 들어올 때 복원되어, 일련의 호출이 하나의 연속 세션처럼 동작합니다. 한 호출에서 만든 행렬은 다음 호출에도 그대로 있습니다.

설치

배포판은 PyPI의 **gauss-lang-mcp**입니다. 평범한 gauss-mcp는 이미 import 워크플로에 관한 무관한 패키지가 사용 중이며, Aptech 언어와는 아무 관련이 없습니다. import 이름은 gauss_mcp로 유지됩니다.

pip install "gauss-lang-mcp[pandas]"

GAUSS는 C:\gauss* 및 C:\Program Files\gauss*에서 자동으로 찾습니다. GAUSS_HOME을 설정하여 설치 위치를 선택할 수 있습니다.

라이브러리 사용

from gauss_mcp import Gauss

with Gauss() as g:
    g.run("""
        rndseed 90210;
        n = 400;
        x = rndn(n, 1);
        y = 1.25 + 0.8*x + 0.3*rndn(n, 1);
        des = ones(n,1)~x;
        bhat = invpd(des'des)*des'y;
    """)
    print(g.get_matrix("bhat"))     # [[1.2489...], [0.8043...]]

값은 출력된 텍스트가 아닌 CSV로 전달되므로 GAUSS의 표시 반올림 대신 완전한 배정밀도를 유지합니다.

g.run("pi_like = 3.14159265358979;")
g.get_scalar("pi_like")          # 3.14159265358979, every digit

양방향 모두 pandas를 지원합니다.

frame = g.to_dataframe(["x", "y"])
g.from_dataframe(frame)

MCP 서버 사용

{
  "mcpServers": {
    "gauss": { "command": "gauss-lang-mcp" }
  }
}

도구

오류

GAUSS는 자체 코드, 메시지 및 줄 번호를 보고하며, 이러한 정보는 그대로 전달됩니다.

GaussError: G0025: Undefined symbol: 'no_such_thing' on line 2

줄 번호는 사용자의 코드를 기준으로 합니다. 작업 공간 복원 코드가 모든 생성된 프로그램 앞에 추가되어 GAUSS 자체 줄 번호가 한 줄씩 밀리는데, 이 오프셋은 사용자가 보기 전에 보정됩니다.

알아 두면 좋은 동작 방식

이 패키지가 대신 처리해 주는 GAUSS 및 tgauss의 특성들로, 각 항목은 추측이 아니라 실제 설치 환경에서 확인된 것입니다.

• 종료 코드는 항상 0입니다. 프로그램이 성공했든 실패했든 상관없습니다. 종료 코드는 아무 정보도 담지 않으므로 오류는 대신 stderr에서 읽습니다.

• stdout은 깨끗합니다. 배너와 작업 헤더는 stderr로 가므로 프로그램 자체 출력을 필터링할 필요가 없습니다.

• GAUSS는 실행 전에 컴파일합니다. 어디에든 정의되지 않은 심볼이 하나라도 있으면 아무것도 실행되지 않고 출력도 나타나지 않습니다. 런타임 오류가 발생하면 그 시점까지 생성된 출력이 남고 그 뒤에 "Program execute failed"가 이어집니다.

• 심볼 이름은 대소문자를 구분하지 않습니다. X와 x는 같은 심볼이므로 하나에 값을 할당하면 다른 하나도 덮어씁니다. R이나 Python에서 온 사람들에게는 의외입니다.

• 자식 프로세스는 stdin을 상속하면 안 됩니다. MCP에서 서버의 stdin은 JSON-RPC 스트림입니다. stdin을 상속한 tgauss는 프로토콜 자체를 읽어 버릴 것입니다. 모든 서브프로세스 호출은 stdin을 분리합니다.

• 작업 공간 복원은 loadall이 아닌 use를 사용합니다. saveall은 .gcg 파일을 쓰며, use <name>;은 그 파일을 읽는 프로그램의 첫 번째 문장이어야 합니다.

테스트

python tests/test_offline.py   # 10 tests, no GAUSS needed
python tests/test_live.py      # 24 tests, drives a real installation

라이선스

MIT. Copyright (c) 2026 Merwan Roudane.