legal-data-hunter 1.0.0

package/README.md

@@ -0,0 +1,60 @@
+# Legal Data Hunter — MCP Setup
+
+Connect your AI to **18M+ legal documents worldwide** with one command.
+
+Works with Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, and any MCP-compatible client.
+
+## Quick Start
+
+```bash
+npx legal-data-hunter setup
+```
+
+This detects your installed AI clients and configures them automatically. On first use, you'll be prompted to sign in via your browser — no API key needed.
+
+## Options
+
+```bash
+npx legal-data-hunter setup              # Interactive setup
+npx legal-data-hunter setup --yes        # Auto-configure all detected clients
+npx legal-data-hunter setup -c cursor    # Configure Cursor only
+npx legal-data-hunter setup --list       # List detected clients
+```
+
+## Alternative: `add-mcp`
+
+```bash
+npx add-mcp https://legaldatahunter.com/mcp
+```
+
+## Alternative: Manual Config
+
+Add to your client's MCP config (`.mcp.json`, `claude_desktop_config.json`, etc.):
+
+```json
+{
+  "mcpServers": {
+    "legal-data-hunter": {
+      "type": "streamable-http",
+      "url": "https://legaldatahunter.com/mcp"
+    }
+  }
+}
+```
+
+## What You Get
+
+| Tool | Description |
+|------|-------------|
+| `search` | Hybrid semantic + keyword search across 18M+ documents |
+| `get_document` | Retrieve full text and metadata by source + ID |
+| `resolve_reference` | Resolve loose citations (ECLI, article numbers, case numbers) |
+| `discover_countries` | List available countries with document counts |
+| `discover_sources` | List data sources for a specific country |
+| `get_filters` | Get available filter values for a source |
+
+## Links
+
+- [Connect Guide](https://legaldatahunter.com/connect)
+- [API Docs](https://legaldatahunter.com/docs)
+- [GitHub](https://github.com/worldwidelaw/legal-sources)

package/bin/setup.js

@@ -0,0 +1,306 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const readline = require("readline");
+
+const MCP_URL = "https://legaldatahunter.com/mcp";
+const SERVER_NAME = "legal-data-hunter";
+const MCP_ENTRY = {
+  type: "streamable-http",
+  url: MCP_URL,
+};
+
+// ── Client definitions ──────────────────────────────────────────────────────
+
+const HOME = os.homedir();
+const IS_WIN = process.platform === "win32";
+const IS_MAC = process.platform === "darwin";
+
+function appData() {
+  if (IS_WIN) return process.env.APPDATA || path.join(HOME, "AppData", "Roaming");
+  if (IS_MAC) return path.join(HOME, "Library", "Application Support");
+  return process.env.XDG_CONFIG_HOME || path.join(HOME, ".config");
+}
+
+const CLIENTS = [
+  {
+    id: "claude-code",
+    name: "Claude Code (global)",
+    path: path.join(HOME, ".claude.json"),
+    wrap: false, // top-level mcpServers
+  },
+  {
+    id: "claude-code-project",
+    name: "Claude Code (project)",
+    path: path.join(process.cwd(), ".mcp.json"),
+    wrap: false,
+  },
+  {
+    id: "claude-desktop",
+    name: "Claude Desktop",
+    path: IS_WIN
+      ? path.join(appData(), "Claude", "claude_desktop_config.json")
+      : IS_MAC
+        ? path.join(appData(), "Claude", "claude_desktop_config.json")
+        : path.join(appData(), "Claude", "claude_desktop_config.json"),
+    wrap: false,
+  },
+  {
+    id: "cursor",
+    name: "Cursor (global)",
+    path: path.join(HOME, ".cursor", "mcp.json"),
+    wrap: false,
+  },
+  {
+    id: "cursor-project",
+    name: "Cursor (project)",
+    path: path.join(process.cwd(), ".cursor", "mcp.json"),
+    wrap: false,
+    requireDir: true, // only if .cursor/ dir exists
+  },
+  {
+    id: "vscode",
+    name: "VS Code (project)",
+    path: path.join(process.cwd(), ".vscode", "mcp.json"),
+    wrap: false,
+    requireDir: true,
+  },
+  {
+    id: "lawvable",
+    name: "Lawvable (project)",
+    path: path.join(process.cwd(), ".vscode", "mcp.json"), // VS Code fork, same config path
+    wrap: false,
+    requireDir: true,
+    aliasOf: "vscode", // skip if VS Code already handled this path
+  },
+  {
+    id: "windsurf",
+    name: "Windsurf",
+    path: path.join(HOME, ".codeium", "windsurf", "mcp_config.json"),
+    wrap: false,
+  },
+  {
+    id: "copilot",
+    name: "GitHub Copilot CLI",
+    path: path.join(HOME, ".copilot", "mcp-config.json"),
+    wrap: false,
+  },
+  {
+    id: "junie",
+    name: "JetBrains Junie (project)",
+    path: path.join(process.cwd(), ".junie", "mcp", "mcp.json"),
+    wrap: false,
+    requireDir: true,
+  },
+  {
+    id: "junie-global",
+    name: "JetBrains Junie (global)",
+    path: path.join(HOME, ".junie", "mcp", "mcp.json"),
+    wrap: false,
+  },
+];
+
+// ── Helpers ──────────────────────────────────────────────────────────────────
+
+function detect() {
+  const seen = new Set();
+  return CLIENTS.filter((c) => {
+    // Deduplicate: skip if another client already claimed this config path
+    if (c.aliasOf && seen.has(c.path)) return false;
+
+    let detected = false;
+    if (c.requireDir) {
+      detected = fs.existsSync(path.dirname(c.path));
+    } else if (c.id === "claude-code") {
+      detected = fs.existsSync(path.join(HOME, ".claude")) || fs.existsSync(c.path);
+    } else if (["claude-desktop", "cursor", "windsurf", "copilot", "junie-global"].includes(c.id)) {
+      detected = fs.existsSync(path.dirname(c.path));
+    } else {
+      detected = fs.existsSync(c.path);
+    }
+
+    if (detected) seen.add(c.path);
+    return detected;
+  });
+}
+
+function readJson(filePath) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+
+function writeJson(filePath, data) {
+  const dir = path.dirname(filePath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", "utf-8");
+}
+
+function configure(client) {
+  const config = readJson(client.path);
+  if (!config.mcpServers) config.mcpServers = {};
+
+  if (config.mcpServers[SERVER_NAME]) {
+    const existing = config.mcpServers[SERVER_NAME];
+    if (existing.url === MCP_URL) {
+      console.log(`  \u2713 ${client.name} — already configured`);
+      return "skipped";
+    }
+    // Update URL if different
+    console.log(`  \u2713 ${client.name} — updated (URL changed)`);
+  } else {
+    console.log(`  \u2713 ${client.name} — configured`);
+  }
+
+  config.mcpServers[SERVER_NAME] = { ...MCP_ENTRY };
+  writeJson(client.path, config);
+  return "configured";
+}
+
+function ask(question) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim().toLowerCase());
+    });
+  });
+}
+
+// ── CLI ──────────────────────────────────────────────────────────────────────
+
+async function main() {
+  const args = process.argv.slice(2);
+  const autoYes = args.includes("--yes") || args.includes("-y");
+  const clientFilter = (() => {
+    const idx = args.indexOf("--client");
+    if (idx !== -1 && args[idx + 1]) return args[idx + 1];
+    const idxC = args.indexOf("-c");
+    if (idxC !== -1 && args[idxC + 1]) return args[idxC + 1];
+    return null;
+  })();
+
+  // Help
+  if (args.includes("--help") || args.includes("-h")) {
+    console.log(`
+legal-data-hunter setup
+
+  Connect your AI to 18M+ legal documents worldwide via MCP.
+  Detects installed AI agents and writes the config automatically.
+
+  Usage:
+    npx legal-data-hunter setup [options]
+
+  Options:
+    --yes, -y        Non-interactive mode (configure all detected clients)
+    --client, -c     Target a specific client (claude-code, cursor, vscode, etc.)
+    --list           List detected clients without configuring
+    --help, -h       Show this help message
+
+  Examples:
+    npx legal-data-hunter setup              # Interactive setup
+    npx legal-data-hunter setup --yes        # Auto-configure all detected clients
+    npx legal-data-hunter setup -c cursor    # Configure Cursor only
+
+  On first use in any client, you'll be prompted to sign in with
+  GitHub or Google via your browser. No API key needed.
+
+  Learn more: https://legaldatahunter.com/connect
+`);
+    return;
+  }
+
+  console.log();
+  console.log("  Legal Data Hunter — MCP Setup");
+  console.log("  Search 18M+ legal documents worldwide from your AI");
+  console.log();
+
+  // Detect clients
+  let clients = detect();
+
+  if (clientFilter) {
+    clients = clients.filter(
+      (c) => c.id === clientFilter || c.id.startsWith(clientFilter)
+    );
+    if (clients.length === 0) {
+      console.log(`  No matching client found for "${clientFilter}".`);
+      console.log(`  Available: ${CLIENTS.map((c) => c.id).join(", ")}`);
+      process.exit(1);
+    }
+  }
+
+  // List mode
+  if (args.includes("--list")) {
+    if (clients.length === 0) {
+      console.log("  No MCP-compatible AI clients detected.");
+    } else {
+      console.log("  Detected clients:");
+      clients.forEach((c) => console.log(`    - ${c.name} (${c.path})`));
+    }
+    console.log();
+    return;
+  }
+
+  if (clients.length === 0) {
+    console.log("  No MCP-compatible AI clients detected.");
+    console.log();
+    console.log("  You can manually add this to your client's MCP config:");
+    console.log();
+    console.log(`  {`);
+    console.log(`    "mcpServers": {`);
+    console.log(`      "${SERVER_NAME}": {`);
+    console.log(`        "type": "streamable-http",`);
+    console.log(`        "url": "${MCP_URL}"`);
+    console.log(`      }`);
+    console.log(`    }`);
+    console.log(`  }`);
+    console.log();
+    console.log("  Learn more: https://legaldatahunter.com/connect");
+    console.log();
+    return;
+  }
+
+  console.log("  Detected clients:");
+  clients.forEach((c, i) => console.log(`    ${i + 1}. ${c.name}`));
+  console.log();
+
+  if (!autoYes) {
+    const answer = await ask("  Configure all detected clients? [Y/n] ");
+    if (answer && answer !== "y" && answer !== "yes") {
+      console.log("  Aborted.");
+      return;
+    }
+    console.log();
+  }
+
+  // Configure
+  let configured = 0;
+  for (const client of clients) {
+    const result = configure(client);
+    if (result === "configured") configured++;
+  }
+
+  console.log();
+  if (configured > 0) {
+    console.log("  Done! On first use, you'll be prompted to sign in via your browser.");
+    console.log("  No API key needed — authentication is handled automatically (OAuth).");
+  } else {
+    console.log("  All clients were already configured. Nothing to do.");
+  }
+  console.log();
+  console.log("  MCP URL: " + MCP_URL);
+  console.log("  Docs:    https://legaldatahunter.com/connect");
+  console.log();
+}
+
+main().catch((err) => {
+  console.error("Error:", err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "legal-data-hunter",
+  "version": "1.0.0",
+  "description": "Connect your AI to 18M+ legal documents worldwide via MCP. One command to configure Claude, Cursor, VS Code, and more.",
+  "bin": {
+    "legal-data-hunter": "bin/setup.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "legal",
+    "ai",
+    "claude",
+    "cursor",
+    "vscode",
+    "law",
+    "case-law",
+    "legislation"
+  ],
+  "homepage": "https://legaldatahunter.com/connect",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/worldwidelaw/legal-sources"
+  },
+  "author": "Legal Data Hunter",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16"
+  },
+  "files": [
+    "bin/setup.js",
+    "README.md"
+  ]
+}