casemargin-mcp-server

CaseMargin MCP 服务

CaseMargin MCP 服务提供支持案例推理工具——可从任何兼容 MCP 的 AI 客户端（Claude Desktop、Claude Code、Cursor 等）生成结构化案例摘要并检查升级准备情况。它位于帮助台数据层之上：不会从 Zendesk 或任何工单系统读取工单——你传入工单内容，它会返回由运行 casemargin.com 的同一 AI 提供支持的结构化分析。

工具

generate_case_brief

根据支持工单对话生成结构化案例摘要。返回评估结果、已尝试的处理方法、当前状态和建议的下一步。

输入： ticket_content（字符串）——完整的工单对话：消息、内部备注，以及你粘贴或通过管道传入的任何内容。10–50,000 个字符。

输出（结构化 JSON）：

{
  "quick_scan": {
    "assessment": "…what this case is about and how serious it is…",
    "next_step": "…the single action the receiving agent should take now…",
    "status": "Waiting on customer"
  },
  "full_brief": {
    "current_problem": "…symptoms, blockers, business impact…",
    "actions_taken": ["action → outcome", "…"],
    "key_context": "…customer plan, history, logs, error codes…"
  },
  "metadata": {
    "input_length": 4210,
    "brief_length": 1250,
    "compression_ratio": 0.3
  }
}

check_escalation_readiness

分析支持工单是否已准备好升级至 L2。返回准备度评分（0–100）、各维度细分、预测的 L2 问题以及缺失项目。

输入： ticket_content（字符串）——待评估的工单备注。10–20,000 个字符。

输出（结构化 JSON）：

{
  "overall_score": 62,
  "readiness": "borderline",
  "dimensions": {
    "problem_clarity": { "score": 80, "note": "…" },
    "troubleshooting_evidence": { "score": 55, "note": "…" },
    "business_impact": { "score": 40, "note": "…" },
    "next_action": { "score": 70, "note": "…" },
    "billing_defensibility": { "score": 65, "note": "…" }
  },
  "predicted_l2_questions": ["…", "…"],
  "missing_items": ["…", "…"]
}

安装

无需预先安装——首次运行时，npx 会获取软件包。将以下内容添加到 claude_desktop_config.json，然后重启 Claude Desktop：

{
  "mcpServers": {
    "casemargin": {
      "command": "npx",
      "args": ["-y", "casemargin-mcp-server"],
      "env": {
        "CASEMARGIN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor 和 Claude Code 在各自的配置文件中使用相同形式的配置。在 macOS 上，配置文件位于 ~/Library/Application Support/Claude/；在 Windows 上，位于 %APPDATA%\Claude\。请退出并重新打开应用，而不是只关闭窗口——配置会在进程启动时读取。

API 密钥为可选项——不提供密钥时，摘要生成会使用按 IP 匿名计量的套餐。前往 casemargin.com/signup 获取免费密钥（每月 8 份摘要）。升级准备度检查免费且无需密钥。移除整个 env 块即可在不使用密钥的情况下运行。

此外，还可在 MCP Registry（名称为 com.casemargin/casemargin-mcp-server）和 npm 上找到。

从源代码运行

仅在修改服务时需要：

git clone https://github.com/Casemargin/casemargin-mcp-server.git
cd casemargin-mcp-server
npm install
npm run build

然后将 command 指向 node，并将 args 指向构建所得 dist/index.js 的绝对路径。

使用示例

“这个工单是什么情况？”

将工单对话粘贴到 AI 客户端，并询问问题情况：

你： 这个工单是什么情况？

客户反馈自周一以来，VPN 每隔约 30 分钟就会断开。已重启路由器、重新安装 v4.2 客户端，问题仍然存在。防火墙日志显示 DHCP 租约每 30 分钟续订一次。客户使用 Premium SLA，受影响者包括 CFO。已告知客户，如果周五前无法解决，我们就会升级处理……

Claude 会调用 generate_case_brief 并返回结构化摘要：

快速概览 — Premium SLA 账户反复出现 VPN 断连，原因与 30 分钟的 DHCP 租约续订有关，且有高管受到影响；紧急程度中高。 下一步： 延长受影响作用域上的 DHCP 租约时间，并确认断连是否与租约续订同步发生。 状态： 正在积极处理。

……此外还包括当前问题、已采取的措施（及其结果）和关键信息的完整细分。

“这个工单准备好升级了吗？”

你： 这个工单准备好升级至 L2 了吗？

（粘贴相同的对话）

Claude 会调用 check_escalation_readiness 并返回评分及细分：

62/100——临界。 问题描述清晰（80），但故障排查证据不足（55）——未附数据包捕获或客户端日志——且业务影响只有陈述，没有量化（40）。升级前，L2 会询问：“VPN 客户端日志显示断连发生时是什么情况？”以及“用户换用其他网络后，问题是否仍然存在？”

安全与隐私

该服务会发起网络请求并读取环境变量，因此供应链扫描器会对这两项发出警告。SECURITY.md 详细说明了全部情况：一个出站来源、两个环境变量，并且完全不会访问文件系统、子进程、动态代码、安装脚本或遥测数据。

有两点值得提前了解。只有你传递给工具的 ticket_content 会离开你的设备——不会收集其他任何内容，原始工单文本也绝不会存储在服务端。此外，由于 API 密钥会通过请求标头传输，如果 CASEMARGIN_API_URL 指向的不是回环地址，且来源不使用 https，服务就会拒绝启动，而不会悄悄以明文发送你的密钥。

发布版本通过 GitHub Actions 使用 npm provenance 发布，因此你可以验证 tarball 来自此仓库：

npm audit signatures

关于 CaseMargin

CaseMargin 会将原始支持工单转化为结构化案例摘要，让接手的 Agent 在几秒内就能快速了解情况，而不是花上几分钟。Web 应用、Zendesk 集成和免费的升级准备度评分工具位于 casemargin.com。