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