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）。
• 工具命名：計算器 slug 使用 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）。
• 多用戶端、各自的權杖 — 為每台裝置（筆電、伺服器、agent）各建立一個。撤銷其中一個不會影響其他。
• 未來各使用者功能的基礎 — 當我們加入速率限制 / 配額 / 已儲存的預設時，它們會繫結到已驗證的呼叫上。

使用 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 環境變數仍可作為單一共用密鑰的旁路。

常見問題 & 疑難排解