🚀 vaquill-mcp
Vaquill 法務リサーチ API 向け MCP サーバー
Vaquill 法務リサーチ API 向けの MCP サーバーです。米国連邦法および 50 州法(USC、CFR、州法、CourtListener の判例法)を網羅しています。AI を活用した法的質問への回答、法令検索、一次資料に基づく回答を、お使いの AI ツールからすべて実行できます。
🚀 クイックスタート
前提条件
vaquill.ai でサインアップして API キーを取得してください。
Claude.ai(Web)
インストールは不要です。Claude.ai の設定 > インテグレーションでリモート 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
macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Windows の場合は %APPDATA%\Claude\claude_desktop_config.json に追加します:
{
"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
または .claude/settings.json に追加します:
{
"mcpServers": {
"vaquill": {
"command": "uvx",
"args": ["vaquill-mcp"],
"env": {
"VAQUILL_API_KEY": "vq_key_your_key_here"
}
}
}
}
Cursor
Cursor の設定 > 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"
}
}
}
}
🛠️ 利用可能なツール
一般
| ツール |
説明 |
クレジット |
ask_legal_question |
USC、CFR、50 州法、CourtListener の判例法にわたる AI を活用した法的 Q&A。標準(高速)またはディープ(マルチホップ)モード。 |
5 - 20 |
get_pricing |
現在の API クレジット料金を取得(認証不要)。 |
無料 |
米国法(USC + CFR)
| ツール |
説明 |
クレジット |
search_us_statutes |
合衆国法典(USC)および連邦規則集(CFR)全体のセマンティック検索。corpusType および titleNumber でフィルタリング可能。 |
2 |
get_us_statute_section |
特定の USC/CFR セクションのメタデータを act_id で取得(引用、タイトル階層、リンク)。 |
1 |
get_us_statute_section_text |
USC または CFR セクションの完全な HTML + プレーンテキスト。 |
3 |
⚙️ 環境変数
| 変数 |
必須 |
デフォルト |
説明 |
VAQUILL_API_KEY |
はい |
- |
vaquill.ai の API キー(vq_key_...) |
VAQUILL_BASE_URL |
いいえ |
https://api.vaquill.ai |
API ベース URL |
VAQUILL_TIMEOUT |
いいえ |
120 |
リクエストタイムアウト(秒) |
💻 使用例
設定が完了すると、AI アシスタントに次のような質問ができます:
- 「17 CFR 240.10b-5 はインサイダー取引について何と述べていますか?」
- 「憲法修正第 14 条の平等保護に関する USC のセクションを検索して」
- 「FRCP 規則 12(b)(6) とそれを適用した最近の SDNY 判例法を要約して」(ディープモードを使用)
- 「18 USC 1343 に基づく電信詐欺の連邦刑罰は何ですか?」
🔧 開発
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
uv run fastmcp dev src/vaquill_mcp/server.py
🧠 仕組み
このパッケージは、Vaquill Developer API の薄い MCP ラッパーです。起動時に、ライブ API から OpenAPI 仕様を取得し、FastMCP を使用して MCP ツールを自動生成します。ツール名と説明は、LLM のパフォーマンスを最適化するためにカスタマイズされています。
仕様は起動時に取得されるため(バンドルされていない)、パッケージを更新しなくても API の変更が自動的にツールへ反映されます。
💳 クレジットと料金
API 呼び出しはクレジットを消費します。現在の料金は vaquill.ai で確認するか、get_pricing ツールを使用してください。
1 クレジット = 0.10 米ドル
📊 データの出典
米国の判例法は、Free Law Project が運営する CourtListener から提供されています。
📄 ライセンス
MIT