Canlii MCP

🚀 CanLII MCP Server

このサーバーは、Model Context Protocol (MCP) を使用して、CanLII (Canadian Legal Information Institute) API へのアクセスを提供します。AIアシスタントが、判決、法令、法的引用などのカナダの法的情報を検索および取得できるようにします。

🚀 クイックスタート

✨ 主な機能

• CanLII API を通じて、カナダの法的情報を取得できます。
• 様々な法的情報の検索ツールが利用可能です。
• Claude Desktop や Cloudflare AI Playground と連携できます。

📦 インストール

前提条件

• CanLII APIキー ( CanLII API から取得)
• Node.js と npm
• Cloudflare Workersアカウント (デプロイ用)

セットアップ手順

1. リポジトリのクローンと依存関係のインストール

git clone <repository-url>
cd canlii-mcp
npm install

2. 環境変数の設定

.env ファイルを作成するか、Cloudflare Workers環境に以下を設定します。

CANLII_API=your_canlii_api_key_here

Cloudflare Workersにデプロイする場合は、以下のコマンドを使用して環境変数を設定します。

wrangler secret put CANLII_API

3. ローカル開発

npm run dev

これにより、サーバーが http://localhost:8787 でローカルに起動します。

4. Cloudflare Workersへのデプロイ

npm run deploy

💻 使用例

基本的な使用法

// 利用可能な裁判所と審判所のリストを取得
await get_courts_and_tribunals({
  language: "en",
});

// カナダ最高裁判所の最近の判決を閲覧
await get_case_law_decisions({
  language: "en",
  databaseId: "scc-csc",
  offset: 0,
  resultCount: 10,
});

高度な使用法

// 法令データベースを取得
await get_legislation_databases({
  language: "en",
});

// 連邦法令を閲覧
await browse_legislation({
  language: "en",
  databaseId: "cas",
});

// 特定の法律のメタデータを取得
await get_legislation_regulation_metadata({
  language: "en",
  databaseId: "cas",
  legislationId: "criminal-code",
});

📚 ドキュメント

利用可能なツール

1. get_courts_and_tribunals

利用可能な裁判所と審判所のデータベースのリストを取得します。 パラメーター:

• language (必須): "en" または "fr"
• オプションの日付フィルター: publishedBefore, publishedAfter, modifiedBefore, modifiedAfter, changedBefore, changedAfter, decisionDateBefore, decisionDateAfter

2. get_legislation_databases

利用可能な法令データベース (制定法、規則など) を取得します。 パラメーター:

• language (必須): "en" または "fr"
• オプションの日付フィルター (上記と同じ)

3. browse_legislation

特定のデータベース内の法令を閲覧します。 パラメーター:

• language (必須): "en" または "fr"
• databaseId (必須): データベースコード (例: "cas" はカナダ制定法、"car" はカナダ規則)
• オプションの日付フィルター

4. get_legislation_regulation_metadata

特定の法令の詳細なメタデータを取得します。 パラメーター:

• language (必須): "en" または "fr"
• databaseId (必須): データベース識別子
• legislationId (必須): 特定の法令ID

5. get_case_law_decisions

特定のデータベースから判決を取得します。 パラメーター:

• language (必須): "en" または "fr"
• databaseId (必須): データベース識別子
• offset (必須): 開始レコード番号
• resultCount (必須): 結果の数 (最大10,000)
• オプションの日付フィルター

6. get_case_metadata

特定の裁判事件の詳細なメタデータを取得します。 パラメーター:

• language (必須): "en" または "fr"
• databaseId (必須): データベース識別子
• caseId (必須): 事件識別子
• オプションの日付フィルター

7. get_case_citator

事件の引用情報 (この事件を引用する事件、この事件が引用する事件など) を取得します。 パラメーター:

• language (必須): "en" または "fr"
• databaseId (必須): データベース識別子
• caseId (必須): 事件識別子
• metadataType (必須): "citedCases", "citingCases", または "citedLegislations"
• オプションの日付フィルター

Claude Desktopとの接続

1. mcp-remote proxy をインストールします。

npm install -g mcp-remote

2. Claude Desktop で、設定 > 開発者 > 設定の編集 を選択し、以下を追加します。

{
  "mcpServers": {
    "canlii": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:8787/sse"]
    }
  }
}

デプロイされたサーバーの場合は、URLをCloudflare WorkersのURLに置き換えます。

https://your-worker-name.your-account.workers.dev/sse

3. Claude Desktop を再起動します。

Cloudflare AI Playgroundとの接続

1. https://playground.ai.cloudflare.com/ にアクセスします。
2. MCPサーバーのURLを入力します: https://your-worker-name.your-account.workers.dev/sse
3. CanLIIツールがPlaygroundで利用可能になります。

🔧 技術詳細

スクリプト

• npm run dev - ローカル開発サーバーを起動します。
• npm run deploy - Cloudflare Workersにデプロイします。
• npm run format - Biomeでコードを整形します。
• npm run lint:fix - リントエラーを修正します。
• npm run type-check - TypeScriptの型チェックを実行します。

プロジェクト構造

src/
├── index.ts          # メインのMCPサーバー実装
├── schema.ts         # APIレスポンスのZodスキーマ
└── worker-configuration.d.ts  # TypeScript宣言

📄 ライセンス

CanLII APIの利用制限と利用規約に注意してください。このAPIは研究および教育目的で使用することを意図しています。

貢献の方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. テストとリントを実行します。
5. プルリクエストを送信します。