Rival Regulatory Toolkit

Rival 法规工具包

开源 SDK、命令行工具、MCP 服务和架构，用于将 AI Agent 连接到 Rival 基于来源的法规检索 API。

• 公共网站：https://tryrival.ai
• Agent 访问入口：https://tryrival.ai/for-agents
• 托管 API 默认地址：https://api.tryrival.ai

本仓库是 Rival 的开发者和 Agent 连接层。首个版本刻意设为只读：Agent 可以搜索、检索来源文本、追踪引文、列出主管机构并查看近期备案。工作区操作、文档审查、证据请求、备案和任务创建仍须通过 Rival 托管访问，并经过人工审核。

包含内容

• Rival 只读法规检索 API 的 OpenAPI 契约。
• 来源文档、搜索结果、引文、主管机构和近期备案的 JSON Schema。
• 供服务端应用和内部工具使用的 TypeScript 客户端。
• 用于 Shell 操作和自动化的命令行工具。
• 供支持 Model Context Protocol 的 Agent 客户端使用的 MCP 服务。
• Fixture 模式，供团队在没有 Rival API 密钥的情况下评估集成。
• 用于在受控团队环境中运行 MCP 服务的 Dockerfile。

安装

npm install @rival-intelligence/regulatory-toolkit

从源代码进行本地开发：

npm install
npm run build

环境

export RIVAL_API_KEY="rv_live_..."
export RIVAL_API_BASE_URL="https://api.tryrival.ai"

无需 API 访问权限即可进行本地评估：

export RIVAL_FIXTURE_MODE=true

TypeScript 客户端

import { RivalRegulatoryClient } from '@rival-intelligence/regulatory-toolkit';

const rival = new RivalRegulatoryClient({
  apiKey: process.env.RIVAL_API_KEY,
});

const results = await rival.searchRegulatoryCorpus({
  query: '49 CFR 195.573',
  limit: 5,
});

console.log(results.results[0]?.source.citation);

命令行工具

rival-regulatory search "49 CFR 195.573"
rival-regulatory source "cfr-49-195-573"
rival-regulatory trace "49 CFR 195.573"
rival-regulatory authorities

Fixture 模式：

rival-regulatory search "pipeline corrosion" --fixture

MCP 服务

直接运行：

npx @rival-intelligence/regulatory-toolkit mcp

MCP 客户端示例：

{
  "mcpServers": {
    "rival-regulatory": {
      "command": "npx",
  "args": ["-y", "@rival-intelligence/regulatory-toolkit", "mcp"],
      "env": {
        "RIVAL_API_KEY": "rv_live_...",
        "RIVAL_API_BASE_URL": "https://api.tryrival.ai"
      }
    }
  }
}

可用的 MCP 工具：

• search_regulatory_corpus
• retrieve_source_text
• trace_citation
• list_authorities
• get_recent_filings

Docker

本仓库包含 Docker 支持，因为许多合规、法律、咨询、能源和基础设施团队会在受控环境中运行 Agent 工具。该镜像运行 MCP 服务，并从环境变量中读取凭据。

docker build -t rival-regulatory-toolkit .
docker run --rm -i \
  -e RIVAL_API_KEY="$RIVAL_API_KEY" \
  -e RIVAL_API_BASE_URL="https://api.tryrival.ai" \
  rival-regulatory-toolkit

Fixture 模式：

docker run --rm -i -e RIVAL_FIXTURE_MODE=true rival-regulatory-toolkit

部署说明请参阅 docs/self-hosting.md。

API 契约

API 契约从五个只读端点开始：

• GET /api/v1/search
• GET /api/v1/sources/{source_id}
• GET /api/v1/citations/trace
• GET /api/v1/authorities
• GET /api/v1/filings/recent

该契约位于 openapi/rival-regulatory-api.yaml。

安全边界

此工具包不会提交备案、修改合规记录、关闭纠正措施、删除证据或执行工作区操作。它是供 Agent 和开发者系统使用的来源检索与引文层。受监管的工作仍须由具备资质的人员审核。

此工具包不提供法律、工程、环境、安全或合规建议。团队有责任与具备资质的专业人士一起验证适用性、义务、备案和运营决策。

开发

npm install
npm run build
npm test

许可证

Apache-2.0