Perf MCP

perf-mcp

事实核查并修复 AI 输出。在内容到达用户之前，捕捉幻觉、修复损坏的 JSON 并纠正错误。

适用于 Claude Code、Cursor、Windsurf、Cline 及任何兼容 MCP 的客户端。

快速开始

将其添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "perf": {
      "command": "npx",
      "args": ["-y", "perf-mcp"],
      "env": {
        "PERF_API_KEY": "pk_live_xxx"
      }
    }
  }
}

在 dashboard.withperf.pro 获取 API 密钥——可免费验证 200 次，无需信用卡。

工具

perf_verify

检测并修复 LLM 生成文本中的幻觉。采用多通道验证（网络搜索、NLI 模型、交叉引用），而非仅仅再进行一次 LLM 检查。

perf_verify({ content: "The Eiffel Tower was built in 1887." })
→ Corrected: "built in 1887" → "inaugurated in 1889" (89% confidence)

perf_validate

根据架构验证 LLM 生成的 JSON，并自动修复违规内容。修复格式错误的枚举、错误的类型、缺失字段和幻觉属性。

perf_validate({
  content: '{"name": "John", "age": "twenty"}',
  target_schema: { type: "object", properties: { name: { type: "string" }, age: { type: "number" } } }
})
→ Rejected: /age must be number

perf_correct

通用输出纠正工具。识别错误类型并应用相应修复——幻觉、架构违规、语义不一致或指令偏移。

perf_correct({ content: "The Great Wall was built in 1950.", correction_budget: "fast" })
→ Corrected: temporal_error + factual_error detected (87% confidence)

perf_chat

自动将 LLM 请求路由到最佳模型。根据任务复杂度，从 GPT-4o、Claude、Gemini 及 20 多种模型中进行选择。兼容 OpenAI 格式。

按客户端配置

Claude Code

将其添加到项目的 .mcp.json：

{
  "mcpServers": {
    "perf": {
      "command": "npx",
      "args": ["-y", "perf-mcp"],
      "env": {
        "PERF_API_KEY": "pk_live_xxx"
      }
    }
  }
}

Cursor

设置 → MCP → 添加服务：

{
  "mcpServers": {
    "perf": {
      "command": "npx",
      "args": ["-y", "perf-mcp"],
      "env": {
        "PERF_API_KEY": "pk_live_xxx"
      }
    }
  }
}

Windsurf

将其添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "perf": {
      "command": "npx",
      "args": ["-y", "perf-mcp"],
      "env": {
        "PERF_API_KEY": "pk_live_xxx"
      }
    }
  }
}

环境变量

变量	必需	说明
PERF_API_KEY	是	你的 Perf API 密钥（pk_live_xxx）
PERF_BASE_URL	否	覆盖 API URL（用于测试）

定价

方案	点数	价格
免费	200 次验证	$0（永不过期）
Pro	1,000 次/月	$19/月
按量付费	不限量	$0.02/次验证

1 次工具调用 = 1 点数。在 dashboard.withperf.pro 开始使用。

许可证

MIT