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 のメートル法と帝国単位）は任意として列挙されます。どの組み合わせが有効かは、各項目の説明を読んで判断してください。
• 出力: 1 行のテキスト要約に加え、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）。
• 複数クライアント、別々のトークン — デバイスごと（ノート PC、サーバー、エージェント）に 1 つずつ発行できます。1 つを失効させても他には影響しません。
• 将来のユーザー別機能の基盤 — レート制限・クォータ・保存済みプリセットを追加した際に、それらは認証済みの呼び出しに紐づきます。

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 & トラブルシューティング