Canlii MCP

🚀 CanLII MCP服務器

CanLII MCP服務器是一個模型上下文協議（MCP）服務器，可提供對加拿大法律信息研究所（CanLII）API的訪問。該服務器允許AI助手搜索和檢索加拿大法律信息，包括法院判決、立法和法律引用。

🚀 快速開始

✨ 前提條件

• 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",
});

// 獲取案件元數據
await get_case_metadata({
  language: "en",
  databaseId: "scc-csc",
  caseId: "2023scc1",
});

// 查找引用此案件的其他案件
await get_case_citator({
  language: "en",
  databaseId: "scc-csc",
  caseId: "2023scc1",
  metadataType: "citingCases",
});

📚 詳細文檔

可用工具

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桌面應用

1. 安裝 mcp-remote代理：

npm install -g mcp-remote

2. 在Claude桌面應用中，轉到“設置”>“開發者”>“編輯配置”，並添加以下內容：

{
  "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桌面應用。

連接到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. 提交拉取請求