weckr

@weckr/mcp

直接通过 Claude、Cursor 或任何其他兼容 MCP 的 AI 助手查询 Weckr AI 成本和利润率数据。

在线体验

连接自己的数据之前，先看看 Weckr 是什么样的。 👉 https://app.useweckr.com/demo

可以询问什么

可以询问：

• "这个月哪些用户让我亏钱？"
• "我现在的 AI 利润率是多少？"
• "应该把哪个功能切换到更便宜的模型？"
• "根据实际 AI 成本，我的定价是否可持续？"
• "显示功能成本明细。"

Claude 会调用 Weckr API，并在对话中向你提供仪表板上的真实数据。

获取 API 密钥

在 app.useweckr.com 注册。创建项目时会显示一次 wk_ 密钥。请复制保存。如果错过了，可以在 app.useweckr.com/dashboard/projects/new 创建新项目。

Claude Desktop

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS） 或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "weckr": {
      "command": "npx",
      "args": ["-y", "@weckr/mcp"],
      "env": {
        "WECKR_API_KEY": "wk_your_key_here"
      }
    }
  }
}

重启 Claude Desktop。试试：“使用 Weckr 工具，向我展示这个月的 AI 成本。”

为什么用 npx 而不是 npm install -g？ 在 macOS 上，Claude Desktop 由 launchd 启动，不会继承交互式 Shell 的 PATH。如果你通过 nvm / asdf / volta 安装了 Node，全局安装的 weckr-mcp 二进制文件通常不在 Claude Desktop 的 PATH 中，导致服务无法启动且没有 任何诊断信息。npx -y @weckr/mcp 可以彻底绕过 PATH 问题。

Cursor

在项目根目录的 .cursor/mcp.json（或全局配置文件 ~/.cursor/mcp.json）中添加：

{
  "mcpServers": {
    "weckr": {
      "command": "npx",
      "args": ["-y", "@weckr/mcp"],
      "env": {
        "WECKR_API_KEY": "wk_your_key_here"
      }
    }
  }
}

提供的工具

工具	可用于询问
get_overview	“这个月的情况如何？”总成本、收入、利润率、请求数、亏损用户数
get_users	“哪些用户在亏钱？”/“显示成本最高的用户。”按用户查看利润率（可筛选）
get_feature_breakdown	“哪些功能的成本最高？”按功能查看成本占比
get_model_recommendations	“如何降低 AI 成本？”同一提供商内更便宜的模型替换方案，并估算节省金额
get_pricing_recommendations	“我的定价是否可持续？”按套餐查看利润率状况及建议价格
get_spending_cap_url	返回编辑支出上限的仪表板 URL（不会修改状态）

配置

环境变量	必需	默认值	说明
WECKR_API_KEY	是	无	你在 app.useweckr.com 获取的 wk_ 密钥
WECKR_PROJECT_ID	否	从 /api/v1/me 解析	可选：预先设置项目 UUID，以便在启动时跳过一次往返请求
WECKR_BASE_URL	否	https://app.useweckr.com	覆盖可自托管 Weckr 的地址。**每次请求都会将你的 wk_ 密钥发送到此处，因此请勿将其设为你不控制的主机。**仅接受 https://（开发环境允许使用环回地址 http://）。

工作原理

MCP 服务是由你的 AI 客户端启动的轻量级 stdio 进程。它使用你的 wk_ 密钥调用 Weckr HTTP API（服务端到服务端，无需 JWT）。 API 密钥可权威地识别一个项目。服务会在启动时使用它解析一次 projectId，随后将每次调用限定在 该项目内。仪表板端点（/api/v1/stats、/users、 /recommendations/*）会验证 URL 中的项目 ID 是否与 API 密钥所属项目相符；若不匹配，则返回 404，因此泄露的 API 密钥无法用于读取 其他项目的数据。

此软件包不会将任何提示词文本或补全文本发送到任何地方。工具只读取汇总统计数据。API 密钥不会离开你的本地 进程，除非发送到通过 WECKR_BASE_URL 配置的 URL（默认为 app.useweckr.com）。如果更改 WECKR_BASE_URL，SDK 会输出 stderr 警告，方便你发现误将配置指向错误主机的复制粘贴错误。

故障排查

Claude Desktop 显示 weckr 服务已断开连接，且没有错误信息。 很可能是 PATH 问题。改用上面的 npx -y @weckr/mcp 形式。要查看启动进程的实际错误，请在终端中手动运行服务： WECKR_API_KEY=wk_... npx -y @weckr/mcp。任何异常（缺少 api key、Weckr 返回 401、网络问题）都会输出到 stderr。

Weckr API 401 on /api/v1/me。 你的 WECKR_API_KEY 为空、格式错误、已撤销，或粘贴时末尾带有空格。访问 app.useweckr.com/dashboard/projects/new 并创建一个新项目，确认密钥是否可用。

工具显示“Project not found or forbidden”（404）。 你设置的 WECKR_PROJECT_ID 是一个 UUID，但它不属于 api key 所有的项目。移除 WECKR_PROJECT_ID，让服务根据 api key 解析正确的项目 id。

本地开发

git clone https://github.com/Ghiles3232/weckr-sdks
cd weckr-sdks/mcp
npm install
npm run build

# Smoke-test against production:
WECKR_API_KEY=wk_... node dist/index.js
# (prints "weckr-mcp running on stdio" to stderr, then waits for JSON-RPC on stdin)

要连接到本地 Weckr 后端：

WECKR_API_KEY=wk_... WECKR_BASE_URL=http://localhost:3000 node dist/index.js

源码

在 github.com/Ghiles3232/weckr-sdks 查看开源代码。

许可证

MIT