QuReDec

QuReDec MCP 服务

在 Claude Code、Claude Desktop、Cursor 或任何兼容 MCP 的客户端中，运行结构化的 QuReDec 决策简报。

状态： Alpha（2026-04-30）。已接入 QuReDec 公共 API （/api/v1/brief*，使用每用户 Bearer 令牌进行身份验证）。设置 QUREDEC_MOCK=1 可用于 离线开发。

功能说明

工具	描述
decision_brief	提交问题；接收结构化且有证据支持的决策简报，并附带引文
get_brief_status	按 ID 轮询进行中的简报
list_recent_briefs	列出调用者最近的简报

完成后的简报包含：executive_summary、recommendation、 confidence（0–1）、key_facts[].citation_ids、implications[]、actions[] （含 effort + impact）、risks[]（含 severity + citation_ids）， 以及 citations[]（含 citation_id、title、url、source_type）。

安装

pip install quredec-mcp

或从源代码安装：

git clone https://github.com/Advanced-Binary-Operations/QuReDec_MCP
cd QuReDec_MCP
pip install -e .

配置

在 https://quredec.com/account → API keys 中生成 QuReDec API 密钥。 每个密钥在创建时只会显示一次；请立即将其复制到密码管理器中。

将以下内容添加到 MCP 客户端配置中（Claude Desktop 示例）：

{
  "mcpServers": {
    "quredec": {
      "command": "quredec-mcp",
      "env": {
        "QUREDEC_API_KEY": "qrd_live_xxxxxxxxxxxx"
      }
    }
  }
}

可选环境变量：

• QUREDEC_BASE_URL — 默认为 https://quredec.com。
• QUREDEC_MOCK=1 — 使用进程内模拟服务进行开发。

使用示例

在 Claude Code 或 Claude Desktop 中：

使用 decision_brief 工具评估“我应该从 Stripe 迁移到 LemonSqueezy 吗？”

简报将包含：建议、置信度评分、带行内引文 ID 的关键事实、风险、建议采取的行动，以及公开分享 URL。简报通常需要 2–5 分钟；默认情况下，工具会阻塞并轮询（超时时间为 600 秒），若触发超时，则会返回合成的运行状态，并附上轮询提示。

定价

MCP 服务免费。简报会消耗 QuReDec 账户中的额度：

• Starter $4.99 — 3 份简报（一次性）
• Pro $49/mo — 每月 30 份简报

参见 https://quredec.com/pricing。

开发

单元测试使用进程内模拟服务运行（无需网络，也无需密钥）：

pip install -e ".[dev]"
QUREDEC_MOCK=1 pytest

在本地使用模拟服务运行 MCP 服务：

QUREDEC_MOCK=1 quredec-mcp

实时集成测试

scripts/integration_test.py 会针对 quredec.com 测试完整流程： 提交 → 轮询 → 检查简报架构 → 列出。该测试会消耗你传入的密钥所属账户中的 1 个额度，请谨慎运行。

QUREDEC_API_KEY=qrd_live_xxxxxxxxxxxx \
  python scripts/integration_test.py

可选环境变量：

• QUREDEC_BASE_URL — 默认为 https://quredec.com。
• QUREDEC_QUESTION — 覆盖默认的种子问题。
• QUREDEC_TIMEOUT — 轮询超时时间，单位为秒（默认值为 600）。

全部通过时退出代码为 0，首次断言失败时退出代码为 1。

许可证

MIT — 参见 LICENSE。

维护者

Advanced Binary Operations LLC · [email protected]