MCP

calculate-mcp: 고정밀 계산 및 이진 데이터 MCP 서버 시작 가이드

고정밀 정수 연산, 비트 조작 또는 IEEE 754 부동소수점 분해를 자주 해야 한다면 calculate-mcp를 먼저 시도해 볼 만합니다. npx를 통해 MCP 클라이언트에서 설치 없이 바로 실행할 수 있지만, 클라이언트가 MCP 서버 설정을 지원해야 합니다.

Official source · KonghuanSmart/calculate-mcp

Install

{"mcpServers":{"calculate-mcp":{"command":"npx","args":["-y","calculate-mcp"]}}}

누구에게 적합한가

  • 고정밀 정수 연산이 필요한 개발자: 네이티브 BigInt 기반으로 64비트, 128비트 이상 정수를 정밀도 손실 없이 다루며, 8/16/32/64비트 부호 있음/없음 2의 보수 표현을 지원합니다.
  • 저수준 디버깅, 리버싱 또는 프로토콜 분석을 하는 사람: 비트 연산, 바이트 오더(엔디안) 스왑, IEEE 754 부동소수점 레이아웃 분해를 하나의 MCP 서버에서 바로 처리할 수 있습니다.
  • 여러 단계의 계산을 한 번에 실행하고 싶은 사람: batch_calc 체인형 배치 실행 엔진이 {"$step": index, "field": "..."}로 이전 단계 결과를 참조하여 중간값을 손으로 복사할 필요가 없습니다.
  • 적합하지 않은 경우: 이것은 범용 채팅이나 검색 도구가 아닙니다. Node.js에서 실행되며, 클라이언트가 stdio 모드의 MCP 설정을 지원해야 합니다. README는 브라우저나 Node 없는 환경에서의 사용 가능 여부를 언급하지 않으며, 이 점은 확인되지 않았습니다.

3분 만에 첫 사용 완료하기

전제 조건: 로컬에 Node.js가 설치되어 있고, 사용 중인 MCP 클라이언트가 mcpServers 설정을 지원해야 합니다(README에 해당 설정 형식이 제공됨).

권장 기본 경로(README에서 Option A, Recommended로 표시): 클라이언트 설정에 다음을 추가합니다.

{"mcpServers":{"calculate-mcp":{"command":"npx","args":["-y","calculate-mcp"]}}}

저장 후 클라이언트를 재시작하거나 새로고침하면, 클라이언트가 npx를 통해 서버를 자동으로 가져와 실행합니다(stdio 모드). 별도 설치는 필요 없습니다.

첫 호출은 읽기 전용 성격의 순수 계산 기능을 권장합니다. 예를 들어 int_convert로 임의 정밀도 정수 변환을 한 번 해보거나, ieee754_convert로 부동소수점 수를 분해해 보세요. 이들은 로컬 수치 계산이며 파일 쓰기나 원격 제출이 없습니다.

성공 신호: 클라이언트 도구 목록에 calculate-mcp가 제공하는 도구가 나타나고(README에 따르면 총 29개의 전용 도구), 계산 요청이 올바른 결과를 반환하면 됩니다. 도구 목록이 비어 있다면 클라이언트 설정 형식이 위와 일치하는지 확인하세요.

보조 방법(참고용, 기본 경로 아님): README는 로컬에서 stdio 모드로 실행하는 방법(npm start, 먼저 TypeScript를 build/로 빌드해야 함)도 언급합니다. 소스를 수정하거나 오프라인으로 실행하려는 사용자에게 적합합니다.

참고: npx -y는 npm에서 패키지를 가져와 실행하는 방식으로, 첫 실행 시 네트워크 다운로드가 발생합니다. 이는 공식 README가 명시적으로 권장하는 방법입니다.

사용 사례

사례 1: 128비트 정수의 비트 수준 표현 검증. 상황: 프로토콜 필드에서 64비트를 초과하는 정수를 확인하고 있습니다. int_convert로 임의 정밀도 정수 변환을 호출하고, 큰 정수를 입력한 뒤 목표 진법/폭을 지정합니다. 내부적으로 네이티브 BigInt를 사용하기 때문에 64비트, 128비트 이상 정수도 정밀도 손실이 없고 8/16/32/64비트 부호 있음/없음 보수 표현을 지원하므로, 보수 출력이 예상과 일치하는지 바로 비교할 수 있습니다.

사례 2: 한 번에 여러 단계를 이어가는 이진 데이터 분석. 상황: 같은 수에 대해 비트 연산을 하고, 이어서 바이트 오더를 스왑하고, 다시 IEEE 754 분해를 해야 합니다. batch_calc 체인형 배치 실행을 사용하세요. 각 단계를 한 번의 배치 호출에 작성하고, 이후 단계에서 {"$step": index, "field": "..."}로 이전 단계 결과를 참조합니다. 기대 결과: 한 번의 호출로 모든 중간 결과와 최종 결과가 반환됩니다. 각 단계의 구체적인 파라미터 이름은 클라이언트에서 해당 도구의 schema 안내를 따르며, README는 각 도구의 파라미터 세부 사항을 일일이 나열하지 않으므로 이 부분은 실행 시 확인이 필요합니다.

사용 경계

  • 읽기/쓰기 성격: 위 도구들은 모두 로컬 수치/인코딩 계산입니다. README는 파일 쓰기, 네트워크 제출 또는 계정 작업의 존재를 언급하지 않으며, 실행 취소 경로에 대한 설명도 없으므로 어떤 "되돌릴 수 있음"도 주장할 수 없습니다.
  • 자격 증명: 없음. 설정에 키나 토큰이 포함되지 않습니다.
  • 실행 전제: Node.js 환경. 구현은 순수 TypeScript + Node.js 표준 라이브러리 + Zod이며, 무거운 네이티브 바인딩 의존성이 없습니다.
  • 공식 명시 제한: README는 속도 제한, 권한 경계, 데이터 프라이버시에 대한 설명을 제공하지 않습니다. 이 핵심 정보는 확인되지 않았으므로, 사용 시 프라이버시 경계에 대해 어떤 가정도 해서는 안 됩니다.
  • 아직 확인되지 않음: 각 도구의 완전한 파라미터 목록, 운영체제 호환성, npx 패키지의 구체적인 버전 번호.