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 环境变量仍可作为单一共享密钥的旁路。

常见问题 & 故障排除