canlii-mcp

Сервер MCP (Model Context Protocol) для API канадской правовой информации CanLII. Предоставляет ИИ-ассистентам доступ к метаданным канадского прецедентного права и законодательства по всем федеральным, провинциальным и территориальным юрисдикциям.

Примечание: API CanLII предоставляет только метаданные — названия, цитирования, даты, ключевые слова и связи между цитированиями. Полный текст документов через API недоступен.

Инструменты

Related MCP server: courtlistener-mcp

Требования

• Node.js 22+

• API-ключ CanLII — подать заявку можно здесь

Использование

stdio через npx (самый быстрый способ)

{
  "mcpServers": {
    "canlii": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@tomilashy/canlii-mcp"],
      "env": {
        "CANLII_API": "your_api_key"
      }
    }
  }
}

stdio (из исходного кода)

npm install
npm run build
node dist/index.js

Добавьте в конфигурацию MCP:

{
  "mcpServers": {
    "canlii": {
      "command": "node",
      "args": ["/path/to/canlii-mcp/dist/index.js"],
      "env": {
        "CANLII_API": "your_api_key"
      }
    }
  }
}

HTTP-сервер

PORT=3000 CANLII_API=your_api_key node dist/index.js --transport http

Эндпоинт MCP доступен по адресу http://localhost:3000/mcp. Сервер работает в режиме без сохранения состояния — каждый запрос является автономным, сессионный ID или рукопожатие инициализации не требуются. Клиенты могут вызывать инструменты напрямую:

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_case_databases","arguments":{"language":"en"}}}'

Docker

docker run -e CANLII_API=your_api_key -e MCP_AUTH_TOKEN=your_secret -p 3000:3000 ghcr.io/tomilashy/canlii-mcp

Или с помощью Docker Compose:

services:
  canlii-mcp:
    image: ghcr.io/tomilashy/canlii-mcp
    environment:
      CANLII_API: your_api_key
      MCP_AUTH_TOKEN: your_secret  # optional
    ports:
      - "3000:3000"

Cloudflare Workers

Сервер включает точку входа, совместимую с Workers (src/worker.ts).

Развертывание через CLI

npx wrangler secret put CANLII_API
npx wrangler secret put MCP_AUTH_TOKEN  # optional
npx wrangler deploy

Развертывание через панель управления (подключение к Git)

1. Перейдите в панель управления Cloudflare → Workers & Pages → Create → Connect to Git

2. Выберите ваш репозиторий tomilashy/canlii-mcp

3. На странице Set up your application:

   • Project name: canlii-mcp

   • Build command: npm install && npm run build

   • Deploy command: npx wrangler deploy (заполнено по умолчанию)

4. Разверните Advanced settings:

   • Variable name: CANLII_API

   • Variable value: ваш API-ключ CanLII

   • Установите флажок Encrypt, чтобы сохранить его как секрет

5. Нажмите Deploy

Эндпоинт MCP будет доступен по адресу https://canlii-mcp.<your-subdomain>.workers.dev/mcp.

Конфигурация

Ограничения частоты запросов (Rate Limits)

Сервер автоматически соблюдает лимиты API CanLII:

• 1 запрос за раз

• 2 запроса в секунду

• 5 000 запросов в день

Запросы, превышающие дневной лимит, возвращают ошибку, не обращаясь к API.

Разработка

npm install
npm run build      # compile TypeScript
npm run watch      # watch mode

Релиз

Этот проект использует семантическое версионирование через semantic-release. Сообщения коммитов следуют спецификации Conventional Commits:

Пуш в ветку main запускает рабочий процесс релиза. Если релиз создан, Docker-образ автоматически собирается и публикуется в ghcr.io.

Лицензия

MIT