ai·rete·rag

ai·rete·rag MCP 服务器

在 Claude Code、Claude Desktop 或任何 MCP 客户端中使用 ai·rete·rag——基于 RAG 的解释与确定性的规则决策。

裁决始终由 Rete 规则引擎给出（可审计、可复现）；LLM 只负责解释原因，并以你摄取的政策文档为依据。

工具

工具	功能
decide	在某个领域作出决策——输入结构化事实和／或自由文本，可选择使用模式 01（规则限定检索范围）和模式 02（将检索结果载入工作记忆）。as_of 可读取在较早日期生效的政策文档
get_parameters	列出某个领域规则用来作出判断的事实（来自你账户自己的规则），按决定性从高到低排列——在调用 decide 前应收集这些信息
list_rules	查看某个领域的规则——条件、裁决结果、显著性和重叠情况
get_rule_source	以可编辑 YAML 格式获取某个领域的规则集
import_policy_rules	将书面政策文档转换为草拟规则，每条规则都引用其所编码的句子（不会保存任何内容——审核后再调用 put_rules）
put_rules	根据 YAML 创建或替换某个领域的规则集（dry_run 用于验证）
ingest_text	将政策文本添加到某个领域的知识库，可选指定日期（effective_from、effective_until），或替换较早版本（supersedes）
list_documents	浏览某个领域已摄取的文档
get_usage	查看你的套餐和每月剩余决策配额

提示词：decide_case

这是一个可用于你账户中任何领域（包括你自有领域）的 Agent 工作流，用于判断案例。它会调用 get_parameters，了解规则据以作出判断的事实；读取案例——文本、照片、文档扫描件、语音笔记或视频（Agent 会自行读取媒体内容；API 只接收事实）；将案例信息映射到对应字段；调用 decide，并通过 fact_sources 记录每项事实来自哪个文件（这些信息会保留在决策审计记录中）。只要结果中的 missing_parameters 不为空（即仍可能改变裁决结果的事实），它就会按决定性从高到低向你询问这些事实，并再次作出判断。裁决始终由规则给出。

通过 URL 连接（无需安装）

该服务也托管在远程端，这是仅支持通过 URL 连接且没有静态标头输入栏的客户端的唯一连接方式——尤其适用于 claude.ai 和 Claude Desktop 自定义连接器。

URL	身份验证	连接目标
https://ai-rete-rag.com/mcp/auth	在浏览器中使用 Google 登录一次	你的账户——你的领域和套餐配额
https://ai-rete-rag.com/mcp	无，或使用 Authorization: Bearer ik_...	匿名访问共享演示领域；使用密钥访问你的账户

添加 https://ai-rete-rag.com/mcp/auth 作为自定义连接器，并批准提示。连接列表位于 Settings → Connected apps，断开连接后会立即生效。

安装

使用 uv 无需安装——uvx ai-rete-rag-mcp 会按需获取并运行服务（请参阅下方的配置片段）。

也可以将其作为软件包安装：

pip install ai-rete-rag-mcp         # from PyPI
pip install .                       # or from source, in this repo

配置

首先创建 API 密钥：登录 ai-rete-rag.com，打开 Settings → API Keys，然后创建密钥（ik_...——只会显示一次）。

Claude Code

claude mcp add ai-rete-rag -e AI_RETE_RAG_API_KEY=ik_your-key-here -- uvx ai-rete-rag-mcp

（如果通过 pip 安装，请使用 -- ai-rete-rag-mcp，而不是 -- uvx ai-rete-rag-mcp。）

或者完全跳过安装，使用你的密钥连接到托管端点：

claude mcp add --transport http ai-rete-rag https://ai-rete-rag.com/mcp \
  --header "Authorization: Bearer ik_your-key-here"

Claude Desktop / 其他客户端（JSON）

{
  "mcpServers": {
    "ai-rete-rag": {
      "command": "uvx",
      "args": ["ai-rete-rag-mcp"],
      "env": {
        "AI_RETE_RAG_API_KEY": "ik_your-key-here"
      }
    }
  }
}

（使用 pip install 时，设置 "command": "ai-rete-rag-mcp" 并删除 "args"。）

环境变量：

变量	默认值	用途
AI_RETE_RAG_API_KEY	(none)	你的 API 密钥 — 用于验证调用并将其关联到你的套餐额度
AI_RETE_RAG_API_URL	https://ai-rete-rag.com	API 基础 URL — 本地开发时可指向 http://localhost:8000

没有密钥时，你仍然可以探索共享的演示领域（loan、fraud、 clinical 等），但受免费套餐限制。

示例

“使用 ai·rete·rag 判断是否应批准这笔贷款申请： 信用评分 645，年收入 $52k，申请金额 $30k。”

Claude 会调用 decide(domain="loan", facts={...})，并返回基于规则的 判定结果，以及引用承保政策的通俗易懂的解释。