Vaquill MCP

🚀 vaquill-mcp

Vaquill 法律研究 API 的 MCP 服务器。

覆盖美国联邦法律及 50 州法律（USC、CFR、州立法、CourtListener 判例法）。你可以在自己的 AI 工具中直接进行 AI 驱动的法律问答、搜索法规，并以一手资料为依据获得答案。

✨ 主要特性

• ⚖️ 全美法律覆盖：美国联邦法律及 50 州法律（USC、CFR、州立法、CourtListener 判例法）
• 🤖 AI 法律问答：支持标准（快速）与深度（多跳）两种模式
• 🔍 法规检索：对《美国法典》和《联邦法规汇编》进行语义搜索
• 🔗 一手资料依据：以权威法律原始文本为依据回答问题
• 🧩 广泛兼容：无缝接入 Claude.ai、Claude Desktop、Claude Code、Cursor、VS Code 及 Windsurf

🚀 快速开始

📋 前提条件

在 vaquill.ai 注册以获取你的 API 密钥。

Claude.ai（网页版）

无需安装。在 Claude.ai 的 Settings > Integrations 中将其添加为远程 MCP 服务器：

方式 A：简单 URL（API 密钥包含在路径中）

https://mcp.vaquill.ai/s/vq_key_your_key_here

方式 B：Bearer 令牌（推荐）

URL:   https://mcp.vaquill.ai/s/_
Token: vq_key_your_key_here

适用于 Claude Pro、Max、Team 和 Enterprise 套餐。

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "vaquill": {
      "command": "uvx",
      "args": ["vaquill-mcp"],
      "env": {
        "VAQUILL_API_KEY": "vq_key_your_key_here"
      }
    }
  }
}

Claude Code

远程（无需安装）：

claude mcp add-json vaquill '{"type":"http","url":"https://mcp.vaquill.ai/s/_","headers":{"Authorization":"Bearer vq_key_your_key_here"}}'

本地（通过 uvx）：

claude mcp add vaquill -- uvx vaquill-mcp
# 然后在你的 shell 中设置环境变量：export VAQUILL_API_KEY=vq_key_...

或者添加到 .claude/settings.json：

{
  "mcpServers": {
    "vaquill": {
      "command": "uvx",
      "args": ["vaquill-mcp"],
      "env": {
        "VAQUILL_API_KEY": "vq_key_your_key_here"
      }
    }
  }
}

Cursor

添加到 Cursor Settings > MCP Servers：

{
  "mcpServers": {
    "vaquill": {
      "command": "uvx",
      "args": ["vaquill-mcp"],
      "env": {
        "VAQUILL_API_KEY": "vq_key_your_key_here"
      }
    }
  }
}

VS Code (Copilot)

添加到 .vscode/settings.json：

{
  "mcp": {
    "servers": {
      "vaquill": {
        "command": "uvx",
        "args": ["vaquill-mcp"],
        "env": {
          "VAQUILL_API_KEY": "vq_key_your_key_here"
        }
      }
    }
  }
}

Windsurf

添加到 ~/.windsurf/settings.json：

{
  "mcpServers": {
    "vaquill": {
      "command": "uvx",
      "args": ["vaquill-mcp"],
      "env": {
        "VAQUILL_API_KEY": "vq_key_your_key_here"
      }
    }
  }
}

🛠️ 可用工具

通用

美国法律（USC + CFR）

⚙️ 环境变量

💻 使用示例

配置完成后，你可以向 AI 助手提出以下问题：

• “17 CFR 240.10b-5 对内部交易（insider trading）是如何规定的？”
• “查找第十四修正案平等保护条款相关的 USC 条文”
• “总结 FRCP Rule 12(b)(6) 及近期适用该规则的 SDNY 判例法”（使用深度模式）
• “18 USC 1343 规定的电信欺诈（wire fraud）的联邦刑罚是什么？”

🔧 开发

# 克隆并安装
git clone https://github.com/Vaquill-AI/vaquill-mcp.git
cd vaquill-mcp
uv sync --all-extras

# 本地运行
VAQUILL_API_KEY=vq_key_... uv run vaquill-mcp

# 运行测试
uv run pytest

# 使用 FastMCP inspector 测试
uv run fastmcp dev src/vaquill_mcp/server.py

🔍 工作原理

本包是 Vaquill 开发者 API 的一个轻量 MCP 封装。启动时，它会从实时 API 获取 OpenAPI 规范，并使用 FastMCP 自动生成 MCP 工具。工具名称和描述均经过定制，以达到最佳的 LLM 表现。

由于规范是在启动时获取（而非打包内置），工具会自动反映任何 API 变更，无需更新软件包。

💳 积分与定价

API 调用会消耗积分。在 vaquill.ai 查看当前定价，或使用 get_pricing 工具。

1 积分 = 0.10 美元

📊 数据来源

美国判例法来源于 CourtListener，由 Free Law Project 维护。

📄 许可证

MIT