CalculatorLib MCP

60초 만에 설치

사용하는 클라이언트를 고르고, 스니펫을 붙여넣은 뒤 재시작하면 끝입니다.

Claude Code Claude Desktop Cursor Zed Cline Windsurf 기타 / 일반

claude mcp add --transport http calculatorlib https://calculatorlib.com/mcp

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp"
    }
  }
}

{
  "context_servers": {
    "calculatorlib": {
      "source": "custom",
      "transport": {
        "type": "streamable-http",
        "url": "https://calculatorlib.com/mcp"
      }
    }
  }
}

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp",
      "transportType": "streamableHttp"
    }
  }
}

{
  "mcpServers": {
    "calculatorlib": {
      "serverUrl": "https://calculatorlib.com/mcp"
    }
  }
}

{
  "transport": "streamable-http",
  "endpoint": "https://calculatorlib.com/mcp"
}

curl -X POST https://calculatorlib.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

이런 프롬프트를 시도해 보세요

설치한 뒤에는 평소처럼 Claude에게 말하기만 하면 됩니다 — 알맞은 도구를 알아서 선택합니다.

라이브 플레이그라운드

여기에서 바로 서버를 호출하세요 — https://calculatorlib.com/mcp로 실제 JSON-RPC를 보내고 실제 응답을 받습니다. 가입은 필요 없습니다. 도구를 불러오는 중…

도구 브라우저

계산기 라이브러리와 9개의 변환 카테고리를 이름이나 제목으로 검색하세요. Claude에게 무엇을 요청할지 찾을 때 유용합니다.

작동 방식

• 엔드포인트: https://calculatorlib.com/mcp의 단일 POST 핸들러가 Streamable HTTP 위에서 JSON-RPC 2.0을 처리합니다(전송 사양 2025-06-18).
• 도구 이름 규칙: 계산기 슬러그는 snake_case를 사용합니다(bmi_calculator, compound_interest_calculator). 변환기는 convert_<category> 형식입니다.
• 입력: 각 도구는 계산기 폼 필드(타입, 열거, 최소/최대)에서 도출한 JSON Schema를 제공합니다. 조건부 필드(예: BMI의 미터법 대 야드파운드법)는 선택으로 표시되므로, 어떤 조합이 유효한지는 각 필드의 설명을 확인하세요.
• 출력: 한 줄 텍스트 요약과 함께 LLM이 파싱할 수 있는 structuredContent JSON 객체를 반환합니다(예: { "main": [{...}], "data": [...] }).
• 업데이트: 카탈로그는 5분마다 갱신됩니다 — 새로 게시된 계산기는 자동으로 나타납니다.

다이렉트 API(MCP 클라이언트 불필요)

MCP 클라이언트 없이 통합하고 싶나요? 동일한 데이터를 일반 JSON 엔드포인트로도 제공합니다.

curl -X POST https://calculatorlib.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -X POST https://calculatorlib.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params":{
      "name":"bmi_calculator",
      "arguments":{"unitSystem":"metric","weight":70,"height":170}
    }
  }'

curl -X POST https://calculatorlib.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":3,"method":"tools/call",
    "params":{
      "name":"convert_length",
      "arguments":{"value":5,"from":"Meter","to":"Foot"}
    }
  }'

REST 엔드포인트(JSON-RPC 래퍼 없음):

• /api/calculators/schemas?q=<keywords> — 계산기 검색(입력 스키마가 포함된 제한된 결과)
• /api/converter/categories — 단위가 포함된 변환 카테고리
• POST /api/converter/convert — 직접 변환, 본문 { category, from, to, value }

인증(선택이지만 권장)

익명 호출도 동작합니다 — 인증은 선택입니다. 토큰을 추가하면 /account/mcp-logs에서 사용자별 사용 분석이 활성화됩니다. 토큰으로 보낸 모든 호출이 지연 시간, 오류 사유, 호출한 계산기와 함께 표시됩니다.

토큰 받기(60초)

1. 로그인합니다(또는 먼저 계정을 생성).
2. /account/api-tokens로 이동합니다.
3. Generate token을 클릭합니다. 값은 한 번만 표시되므로 복사하세요.

MCP 클라이언트에 추가하기

공개 설치와 동일한 설정 파일에 headers.Authorization 필드만 추가합니다:

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

왜 사용하나요?

• 개인 사용 로그 — 가장 많이 호출하는 계산기와 실패하는 계산기를, 본인 토큰 범위에서만 확인합니다(/account/mcp-logs).
• 여러 클라이언트, 별도 토큰 — 기기마다(노트북, 서버, 에이전트) 하나씩 발급하세요. 하나를 폐기해도 나머지에는 영향이 없습니다.
• 향후 사용자별 기능의 토대 — 추후 속도 제한 / 할당량 / 저장된 프리셋을 추가하면 인증된 호출에 연결됩니다.

Bearer 토큰을 사용하는 curl

curl -X POST https://calculatorlib.com/mcp \
  -H 'Authorization: Bearer YOUR_TOKEN_HERE' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

서버 운영자에게: MCP_REQUIRE_AUTH=true로 설정하면 모든 호출에 토큰을 요구할 수 있습니다(익명 → 401). 기존 MCP_API_TOKEN 환경 변수는 단일 공유 비밀을 통한 우회 수단으로 계속 동작합니다.

FAQ & 문제 해결