@iflow-mcp/georgejeffers-uk-case-law-mcp 1.0.0

package/dist/formatters.js

@@ -0,0 +1,164 @@
+// src/formatters.ts
+// ============================================================================
+// OUTPUT FORMATTERS
+// ============================================================================
+//
+// Format search results and case content for Claude.
+// Designed to be readable and include proper citations.
+// ============================================================================
+// ============================================================================
+// PARAGRAPH RANGE UTILITIES
+// ============================================================================
+export function parseParaRange(range) {
+    const match = range.match(/^(\d+)\s*-\s*(\d+)$/);
+    if (!match || !match[1] || !match[2])
+        return null;
+    return {
+        start: parseInt(match[1], 10),
+        end: parseInt(match[2], 10),
+    };
+}
+// Maximum characters to return (roughly 8000 tokens)
+const MAX_OUTPUT_CHARS = 32000;
+export function applyParaRange(paragraphs, range) {
+    if (!range) {
+        // No range specified - apply token limit
+        return truncateToLimit(paragraphs);
+    }
+    const parsed = parseParaRange(range);
+    if (!parsed) {
+        return truncateToLimit(paragraphs);
+    }
+    const filtered = paragraphs.filter(p => p.number >= parsed.start && p.number <= parsed.end);
+    return truncateToLimit(filtered);
+}
+function truncateToLimit(paragraphs) {
+    let totalChars = 0;
+    const output = [];
+    for (const para of paragraphs) {
+        if (totalChars + para.text.length > MAX_OUTPUT_CHARS) {
+            break;
+        }
+        output.push(para);
+        totalChars += para.text.length;
+    }
+    return {
+        paragraphs: output,
+        truncated: output.length < paragraphs.length,
+        remaining: paragraphs.length - output.length,
+    };
+}
+// ============================================================================
+// SEARCH RESULTS FORMATTER
+// ============================================================================
+export function formatSearchResults(results) {
+    if (results.length === 0) {
+        return 'No cases found matching your search query.';
+    }
+    let output = `Found ${results.length} case${results.length === 1 ? '' : 's'}:\n\n`;
+    for (const result of results) {
+        // Citation or URI as header
+        const citation = result.neutralCitation || result.documentUri;
+        output += `**${citation}**\n`;
+        // Title
+        output += `${result.title}\n`;
+        // Court and date
+        const parts = [];
+        if (result.court)
+            parts.push(result.court);
+        if (result.date)
+            parts.push(result.date);
+        if (parts.length > 0) {
+            output += `${parts.join(' | ')}\n`;
+        }
+        // Snippet if available
+        if (result.snippet) {
+            const cleanSnippet = result.snippet
+                .replace(/\s+/g, ' ')
+                .trim()
+                .substring(0, 200);
+            output += `> ${cleanSnippet}${cleanSnippet.length >= 200 ? '...' : ''}\n`;
+        }
+        // Add document links
+        output += `[View on TNA](${result.urls.web}) | [PDF](${result.urls.pdf})\n`;
+        output += '\n';
+    }
+    return output.trim();
+}
+export function formatCaseContent(caseData, options = {}) {
+    const { includeMetadata = true, paragraphRange } = options;
+    let output = '';
+    // Metadata header
+    if (includeMetadata) {
+        output += `# ${caseData.metadata.title}\n\n`;
+        if (caseData.metadata.neutralCitation) {
+            output += `**Citation:** ${caseData.metadata.neutralCitation}\n`;
+        }
+        output += `**Court:** ${caseData.metadata.courtName || caseData.metadata.court}\n`;
+        if (caseData.metadata.date) {
+            output += `**Date:** ${caseData.metadata.date}\n`;
+        }
+        if (caseData.judges && caseData.judges.length > 0) {
+            output += `**Judges:** ${caseData.judges.join(', ')}\n`;
+        }
+        if (caseData.parties) {
+            if (caseData.parties.claimants.length > 0) {
+                output += `**Claimant(s):** ${caseData.parties.claimants.join(', ')}\n`;
+            }
+            if (caseData.parties.defendants.length > 0) {
+                output += `**Defendant(s):** ${caseData.parties.defendants.join(', ')}\n`;
+            }
+        }
+        // Add document links
+        output += `\n[View on TNA](${caseData.metadata.urls.web}) | [PDF](${caseData.metadata.urls.pdf})\n`;
+        output += '\n---\n\n';
+    }
+    // Apply paragraph range and truncation
+    const { paragraphs, truncated, remaining } = applyParaRange(caseData.paragraphs, paragraphRange);
+    // Format paragraphs with numbers for citation
+    for (const para of paragraphs) {
+        output += `[${para.number}] ${para.text}\n\n`;
+    }
+    // Truncation notice
+    if (truncated) {
+        output += `---\n\n`;
+        output += `*Output truncated. ${remaining} paragraph${remaining === 1 ? '' : 's'} remaining. `;
+        const lastPara = paragraphs[paragraphs.length - 1];
+        if (lastPara) {
+            output += `Use the paragraphs parameter (e.g., "${lastPara.number + 1}-${lastPara.number + 50}") to retrieve more.*\n`;
+        }
+    }
+    return output.trim();
+}
+// ============================================================================
+// CITATIONS FORMATTER
+// ============================================================================
+export function formatCitations(citations, direction) {
+    let output = '';
+    if (direction === 'citing' || direction === 'both') {
+        output += `## Cases Citing This Decision\n\n`;
+        if (citations.citing.length === 0) {
+            output += `No citing cases found.\n\n`;
+        }
+        else {
+            for (const c of citations.citing) {
+                output += `- **${c.citation || c.title}** (${c.court}, ${c.date})\n`;
+            }
+            output += '\n';
+        }
+    }
+    if (direction === 'cited' || direction === 'both') {
+        output += `## Cases Cited By This Decision\n\n`;
+        if (citations.cited.length === 0) {
+            output += `No cited cases found.\n\n`;
+        }
+        else {
+            for (const c of citations.cited) {
+                output += `- **${c.citation || c.title}** (${c.court}, ${c.date})\n`;
+            }
+            output += '\n';
+        }
+    }
+    return output.trim();
+}
+//# sourceMappingURL=formatters.js.map

package/dist/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"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"}

package/dist/search.d.ts

@@ -0,0 +1,13 @@
+import type { SearchResult } from './types.js';
+export interface SearchParams {
+    query: string;
+    legalArea?: string;
+    court?: string;
+    yearFrom?: number;
+    yearTo?: number;
+    limit?: number;
+    page?: number;
+}
+export declare function searchCaseLaw(params: SearchParams): Promise<SearchResult[]>;
+export declare function reciprocalRankFusion(resultLists: SearchResult[][], limit: number, k?: number): SearchResult[];
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAkCjF;AAcD,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,YAAY,EAAE,EAAE,EAC7B,KAAK,EAAE,MAAM,EACb,CAAC,GAAE,MAAW,GACb,YAAY,EAAE,CA8BhB"}

package/dist/search.js

@@ -0,0 +1,81 @@
+// src/search.ts
+// ============================================================================
+// UNIFIED SEARCH LAYER
+// ============================================================================
+//
+// Combines results from:
+// 1. TNA API (2003+)
+// 2. Local PostgreSQL (pre-2003 BAILII content) - optional, when database configured
+//
+// Results are merged using Reciprocal Rank Fusion (RRF).
+// ============================================================================
+import { searchTna, COURT_CODE_MAP, LEGAL_AREA_COURTS } from './tna-client.js';
+export async function searchCaseLaw(params) {
+    const limit = params.limit || 10;
+    // Determine which TNA courts to search
+    let tnaCourts;
+    if (params.court && params.court !== 'any') {
+        tnaCourts = COURT_CODE_MAP[params.court];
+    }
+    if (params.legalArea && params.legalArea !== 'any') {
+        const areaCourts = LEGAL_AREA_COURTS[params.legalArea];
+        if (areaCourts) {
+            // Intersect with court filter if both specified
+            if (tnaCourts) {
+                tnaCourts = tnaCourts.filter(c => areaCourts.includes(c));
+            }
+            else {
+                tnaCourts = areaCourts;
+            }
+        }
+    }
+    // For MVP, only use TNA API
+    // TODO: Add local database search when PostgreSQL is configured
+    const tnaResults = await searchTna({
+        query: params.query,
+        courts: tnaCourts,
+        yearFrom: params.yearFrom,
+        yearTo: params.yearTo,
+        limit: limit,
+        page: params.page,
+    });
+    return tnaResults.slice(0, limit);
+}
+// ============================================================================
+// RECIPROCAL RANK FUSION (for future use with multiple sources)
+// ============================================================================
+//
+// Combines ranked lists from different sources.
+// Each document gets a score based on its rank in each list:
+//   score = sum(1 / (k + rank)) for each list
+//
+// k=60 is a standard constant that prevents top results from
+// dominating too heavily.
+// ============================================================================
+export function reciprocalRankFusion(resultLists, limit, k = 60) {
+    const scores = new Map();
+    const docMap = new Map();
+    for (const results of resultLists) {
+        for (let rank = 0; rank < results.length; rank++) {
+            const result = results[rank];
+            if (!result)
+                continue;
+            const docId = result.documentUri || result.neutralCitation || result.title;
+            const currentScore = scores.get(docId) || 0;
+            scores.set(docId, currentScore + 1 / (k + rank + 1));
+            // Keep the first occurrence (usually has more complete metadata)
+            if (!docMap.has(docId)) {
+                docMap.set(docId, result);
+            }
+        }
+    }
+    // Sort by RRF score
+    const sortedIds = [...scores.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .map(([id]) => id);
+    return sortedIds
+        .slice(0, limit)
+        .map(id => docMap.get(id))
+        .filter((r) => r !== undefined);
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}

package/dist/server.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+// src/server.ts
+// ============================================================================
+// UK CASE LAW MCP SERVER
+// ============================================================================
+//
+// Provides Claude with tools to search and retrieve UK case law.
+//
+// Tools provided:
+// - uklaw_search: Search across all case law
+// - uklaw_get_case: Get full text of a specific case
+// ============================================================================
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { searchCaseLaw } from './search.js';
+import { getCaseByUri, getCaseByCitation } from './cases.js';
+import { formatSearchResults, formatCaseContent } from './formatters.js';
+// ============================================================================
+// SERVER INITIALIZATION
+// ============================================================================
+const server = new McpServer({
+    name: 'uk-case-law',
+    version: '1.0.0',
+});
+// ============================================================================
+// TOOL: uklaw_search
+// ============================================================================
+//
+// Primary search tool. Searches TNA API (2003+).
+// ============================================================================
+server.tool('uklaw_search', `Search UK case law across all courts and tribunals.
+
+Returns ranked results with:
+- Neutral citations (e.g., [2024] UKSC 1)
+- Case titles
+- Courts and dates
+- Brief snippets
+
+Use filters to narrow results by court, legal area, or date range.
+
+Examples:
+- "patent obviousness test" - finds patent validity cases
+- "unfair dismissal procedure" - finds employment cases
+- "breach of fiduciary duty director" - finds company law cases`, {
+    query: z.string()
+        .min(2)
+        .describe('Search terms - legal concepts, party names, or keywords'),
+    legal_area: z.enum([
+        'any',
+        'intellectual_property',
+        'commercial',
+        'company',
+        'employment',
+        'property',
+        'family',
+        'criminal',
+        'public_law',
+        'immigration',
+        'personal_injury'
+    ])
+        .default('any')
+        .describe('Filter by area of law'),
+    court: z.enum([
+        'any',
+        'supreme_court',
+        'court_of_appeal',
+        'high_court',
+        'crown_court',
+        'tribunals'
+    ])
+        .default('any')
+        .describe('Filter by court level'),
+    year_from: z.number()
+        .int()
+        .min(1800)
+        .max(2025)
+        .optional()
+        .describe('Earliest decision year'),
+    year_to: z.number()
+        .int()
+        .min(1800)
+        .max(2025)
+        .optional()
+        .describe('Latest decision year'),
+    limit: z.number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(10)
+        .describe('Maximum results to return'),
+    page: z.number()
+        .int()
+        .min(1)
+        .default(1)
+        .describe('Page number for pagination. If results seem truncated or date range is not met, try next page.'),
+}, async ({ query, legal_area, court, year_from, year_to, limit, page }) => {
+    try {
+        const params = {
+            query,
+            legalArea: legal_area === 'any' ? undefined : legal_area,
+            court: court === 'any' ? undefined : court,
+            yearFrom: year_from,
+            yearTo: year_to,
+            limit,
+            page,
+        };
+        const results = await searchCaseLaw(params);
+        const formatted = formatSearchResults(results);
+        return {
+            content: [{ type: 'text', text: formatted }]
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Search failed: ${error instanceof Error ? error.message : 'Unknown error'}`
+                }],
+            isError: true
+        };
+    }
+});
+// ============================================================================
+// TOOL: uklaw_get_case
+// ============================================================================
+//
+// Retrieves full text of a specific case. For TNA cases, fetches from API.
+//
+// Output includes numbered paragraphs for precise citation.
+// ============================================================================
+server.tool('uklaw_get_case', `Retrieve the full text of a specific UK case.
+
+Accepts either:
+- Neutral citation: "[2007] EWCA Civ 588"
+- Document URI: "ewca/civ/2007/588"
+
+Returns the judgment with numbered paragraphs. Use paragraph numbers
+when citing specific passages, e.g., "as stated at [23]".
+
+For long judgments, use the paragraphs parameter to request a specific
+range (e.g., "1-50" for the first 50 paragraphs).`, {
+    citation: z.string()
+        .describe('Neutral citation (e.g., "[2024] UKSC 1") or document URI (e.g., "uksc/2024/1")'),
+    paragraphs: z.string()
+        .optional()
+        .describe('Paragraph range to retrieve, e.g., "1-50" or "23-45". Omit for full text.'),
+    include_metadata: z.boolean()
+        .default(true)
+        .describe('Include case metadata (judges, date, court)')
+}, async ({ citation, paragraphs, include_metadata }) => {
+    try {
+        // Determine if this is a neutral citation or URI
+        const isNeutralCitation = citation.startsWith('[');
+        const caseData = isNeutralCitation
+            ? await getCaseByCitation(citation)
+            : await getCaseByUri(citation);
+        if (!caseData) {
+            return {
+                content: [{ type: 'text', text: `Case not found: ${citation}` }],
+                isError: true
+            };
+        }
+        const formatted = formatCaseContent(caseData, {
+            includeMetadata: include_metadata,
+            paragraphRange: paragraphs,
+        });
+        return {
+            content: [{ type: 'text', text: formatted }]
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to retrieve case: ${error instanceof Error ? error.message : 'Unknown error'}`
+                }],
+            isError: true
+        };
+    }
+});
+// ============================================================================
+// START SERVER
+// ============================================================================
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('UK Case Law MCP server running');
+}
+main().catch(console.error);
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/test.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=test.d.ts.map

package/dist/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../src/test.ts"],"names":[],"mappings":""}