Klave Mcp

@juny-klave/mcp

MCP 服务让 Claude 能够代表你协商价格——自主、私密，并以加密方式证明协商结果。

---

功能介绍

KLAVE 将 Claude 接入双边协商引擎。你只需用通俗的英语描述需求；Claude 会调用 KLAVE，通过多轮协商进行谈判，并向你报告最终价格和 ZK 证明参考信息。你的价格上限会以加密方式绑定到授权令牌中，绝不会出现在任何响应里——卖家永远看不到你的预算。

---

可协商的内容

任何有价格的东西都可以。KLAVE 不需要预先发布的商品信息、平台合作关系或预置场景。只要有要价，而你有价格上限，KLAVE 就能进行协商。

货运与物流

“协商 200 个 FEU 集装箱从上海运到鹿特丹的价格。他们要价 $2,806。我的上限是 $2,700。”

软件与 SaaS

“帮我把这个 CRM 许可证的价格谈低一些。500 个席位，他们要价每年 $75,000。我不会支付超过 $58,000。”

雇佣与合同

“一位承包商要求按小时收费 $185，签约 6 个月。我的预算是每小时 $150。帮我谈谈。”

房地产

“协商续签我们的办公室租约。房东要价每平方英尺 $42。我们需要把价格谈到 $35 或以下。”

法律与和解

“协商和解金额。对方要求 $250,000。我的上限是 $180,000。”

任何双边协商

“他们要价 [X]。我不会支付超过 [Y]。帮我谈谈。”

---

前置条件

• Node.js 18+
• Claude Desktop 或 Claude Code
• KLAVE API 密钥 — 在 klave-platform.vercel.app/docs 获取

---

在 Claude Desktop 中安装

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "klave": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://klave1-production.up.railway.app/mcp/sse",
        "--header",
        "x-api-key:YOUR_API_KEY"
      ]
    }
  }
}

将 YOUR_API_KEY 替换为你从 klave-platform.vercel.app/docs 获取的密钥。

---

在 Claude Code 中安装

claude mcp add klave \
  --transport sse \
  "https://klave1-production.up.railway.app/mcp/sse" \
  --header "x-api-key:YOUR_API_KEY"

---

在本地运行（stdio）

git clone https://github.com/juny-klave/klave-mcp.git
cd klave-mcp
npm install
npm run build

然后将 Claude Desktop 指向本地构建：

{
  "mcpServers": {
    "klave": {
      "command": "node",
      "args": ["/absolute/path/to/klave-mcp/dist/index.js"],
      "env": {
        "KLAVE_API_URL": "https://klave1-production.up.railway.app",
        "KLAVE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

---

4 个工具

工具	功能
klave_negotiate	开始协商——任何主题、任何行业、任何价格范围
klave_advance	推进一轮——循环调用，直到状态变为 SETTLED 或 TERMINATED
klave_status	随时获取当前状态和完整的轮次记录
klave_verify	获取 ZK 证明，确认协商是公平进行的

工具调用顺序

klave_negotiate        ← describe what you're negotiating and your ceiling
klave_advance (loop)   ← advance round by round until SETTLED
klave_status           ← check progress at any time
klave_verify           ← get cryptographic proof after settlement

---

隐私保障

• 你的价格上限（ceiling_price）会传递给协商引擎，绝不会出现在任何工具响应中。
• 卖家的底价由服务端计算，绝不会成为任何 API 响应中的字段。
• 验证响应中的 leaks_detected 数据来自服务端——绝非硬编码。
• 每次协商都会生成可审计的 ZK 证明。

---

环境变量（本地模式）

变量	默认值	说明
KLAVE_API_URL	https://klave1-production.up.railway.app	KLAVE REST API 基础 URL
KLAVE_API_KEY	(空)	API 密钥
TRANSPORT	stdio	stdio（Claude Desktop/Code）或 http（远程/SSE）
PORT	3002	TRANSPORT=http 时使用的 HTTP 端口

---

获取 API 密钥

在 klave-platform.vercel.app/docs 注册。

---

开发者 SDK

如果你正在构建需要以编程方式授权协商的 Agent，请参阅 KLAVE SDK（@juny-klave/sdk）。

---

许可证

MIT