@cyanheads/eur-lex-mcp-server 0.1.1

package/dist/services/cellar-sparql/cellar-sparql-service.js

@@ -0,0 +1,123 @@
+/**
+ * @fileoverview CellarSparqlService — HTTP client for the EU Publications Office CELLAR
+ * Virtuoso SPARQL endpoint. Handles POST queries, LIMIT enforcement, and Virtuoso-specific
+ * error detection (HTTP 200 with error body).
+ * @module services/cellar-sparql/cellar-sparql-service
+ */
+import { invalidParams, serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { withRetry } from '@cyanheads/mcp-ts-core/utils';
+/** Required PREFIX declarations for CELLAR CDM ontology queries. */
+const SPARQL_PREFIXES = `PREFIX cdm: <http://publications.europa.eu/ontology/cdm#>
+PREFIX skos: <http://www.w3.org/2004/02/skos/core#>
+PREFIX xsd: <http://www.w3.org/2001/XMLSchema#>
+`;
+/** Pattern matching Virtuoso-specific error responses (HTTP 200 with error body). */
+const VIRTUOSO_ERROR_RE = /Virtuoso\s+\d+\s+Error/i;
+/** Pattern for Virtuoso timeout messages (SP031). */
+const VIRTUOSO_TIMEOUT_RE = /SP031|query execution timed out/i;
+/**
+ * Inject or cap the LIMIT clause in a SPARQL query to `max`.
+ * If the query has no LIMIT, appends one. If it has a LIMIT above `max`, rewrites it.
+ */
+function enforceLimitInQuery(query, max) {
+    const limitRe = /\bLIMIT\s+(\d+)/i;
+    const match = limitRe.exec(query);
+    if (!match) {
+        return `${query.trimEnd()}\nLIMIT ${max}`;
+    }
+    const existing = parseInt(match[1], 10);
+    if (existing > max) {
+        return query.replace(limitRe, `LIMIT ${max}`);
+    }
+    return query;
+}
+export class CellarSparqlService {
+    endpoint;
+    timeoutMs;
+    maxResults;
+    constructor(_config, _storage, serverConfig) {
+        this.endpoint = serverConfig.cellarSparqlEndpoint;
+        this.timeoutMs = serverConfig.sparqlQueryTimeoutMs;
+        this.maxResults = serverConfig.maxSparqlResults;
+    }
+    /**
+     * Execute a raw SPARQL SELECT query. Prefixes are prepended automatically
+     * if not already present. LIMIT is injected/capped at `maxResults`.
+     */
+    async query(rawQuery, ctx) {
+        const withPrefixes = rawQuery.includes('PREFIX cdm:') ? rawQuery : SPARQL_PREFIXES + rawQuery;
+        const cappedQuery = enforceLimitInQuery(withPrefixes, this.maxResults);
+        return withRetry(async () => {
+            const body = new URLSearchParams({
+                query: cappedQuery,
+                format: 'application/sparql-results+json',
+            });
+            const response = await fetch(this.endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                    Accept: 'application/sparql-results+json',
+                },
+                body: body.toString(),
+                signal: AbortSignal.timeout(this.timeoutMs),
+            });
+            const text = await response.text();
+            if (!response.ok) {
+                if (response.status === 400) {
+                    // HTTP 400 = client error (malformed query) — not retryable
+                    throw invalidParams(`CELLAR SPARQL error: ${text.slice(0, 300)}`, {
+                        reason: 'sparql_error',
+                        retryable: false,
+                    });
+                }
+                throw serviceUnavailable(`CELLAR SPARQL HTTP ${response.status}`, {
+                    status: response.status,
+                });
+            }
+            /** Virtuoso returns HTTP 200 even for errors — inspect the body. */
+            if (VIRTUOSO_ERROR_RE.test(text)) {
+                if (VIRTUOSO_TIMEOUT_RE.test(text)) {
+                    throw serviceUnavailable('CELLAR SPARQL query timed out on Virtuoso', {
+                        reason: 'sparql_timeout',
+                    });
+                }
+                // Syntax / semantic error — not transient, fail immediately
+                throw invalidParams(`CELLAR SPARQL error: ${text.slice(0, 300)}`, {
+                    reason: 'sparql_error',
+                    retryable: false,
+                });
+            }
+            let parsed;
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                if (/^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text)) {
+                    throw serviceUnavailable('CELLAR returned HTML instead of SPARQL results — possibly rate-limited.');
+                }
+                throw serviceUnavailable('Failed to parse CELLAR SPARQL response as JSON');
+            }
+            return parsed.results.bindings;
+        }, {
+            operation: 'CellarSparqlService.query',
+            baseDelayMs: 1500,
+            signal: ctx.signal,
+        });
+    }
+    /** Extract a string value from a binding field, returning undefined if absent. */
+    static bindingValue(binding, field) {
+        return binding?.[field]?.value;
+    }
+}
+// --- Init/accessor pattern ---
+let _service;
+export function initCellarSparqlService(config, storage, serverConfig) {
+    _service = new CellarSparqlService(config, storage, serverConfig);
+}
+export function getCellarSparqlService() {
+    if (!_service) {
+        throw new Error('CellarSparqlService not initialized — call initCellarSparqlService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=cellar-sparql-service.js.map

package/dist/services/cellar-sparql/cellar-sparql-service.js.map

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

package/dist/services/cellar-sparql/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview Shared domain types for the CELLAR SPARQL service and EUR-Lex content service.
+ * @module services/cellar-sparql/types
+ */
+/** A single binding row from a SPARQL SELECT result. */
+export type SparqlBinding = Record<string, {
+    type: string;
+    value: string;
+    datatype?: string;
+}>;
+/** The full SPARQL results JSON envelope from Virtuoso. */
+export interface SparqlResultsJson {
+    head: {
+        vars: string[];
+    };
+    results: {
+        bindings: SparqlBinding[];
+    };
+}
+/** A resolved CELLAR work record. */
+export interface CellarWork {
+    authorInstitution?: string;
+    celexNumber: string;
+    date?: string;
+    eurovocConcepts?: string[];
+    inForce?: boolean;
+    resourceType?: string;
+    title?: string;
+    workUri: string;
+}
+/** A search result entry from CELLAR. */
+export interface WorkSearchResult {
+    celexNumber: string;
+    date?: string;
+    resourceType?: string;
+    title?: string;
+    workUri: string;
+}
+/** A CJEU/GC case law result entry. */
+export interface CaseResult {
+    celexNumber: string;
+    court?: string;
+    date?: string;
+    resourceType?: string;
+    title?: string;
+    workUri: string;
+}
+/** A single CDM relation between works. */
+export interface WorkRelation {
+    direction: 'outgoing' | 'incoming';
+    relatedCelexNumber?: string;
+    relatedWorkUri: string;
+    relationType: string;
+}
+/** An EuroVoc concept from the thesaurus. */
+export interface EuroVocConcept {
+    broaderLabel?: string;
+    conceptCode?: string;
+    conceptUri: string;
+    prefLabel: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/cellar-sparql/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/cellar-sparql/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wDAAwD;AACxD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE/F,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACzB,OAAO,EAAE;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;CACxC;AAED,qCAAqC;AACrC,MAAM,WAAW,UAAU;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,uCAAuC;AACvC,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,UAAU,GAAG,UAAU,CAAC;IACnC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/services/cellar-sparql/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Shared domain types for the CELLAR SPARQL service and EUR-Lex content service.
+ * @module services/cellar-sparql/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/cellar-sparql/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/cellar-sparql/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/services/eurlex-content/eurlex-content-service.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview EurLexContentService — HTTP client for the EUR-Lex REST content API.
+ * Fetches full HTML or XML text of EU legal acts via the legal-content URL pattern.
+ * Document content is NOT available via CELLAR work URI content negotiation (returns 400).
+ * @module services/eurlex-content/eurlex-content-service
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import type { AppConfig } from '@cyanheads/mcp-ts-core/config';
+import type { StorageService } from '@cyanheads/mcp-ts-core/storage';
+import type { ServerConfig } from '../../config/server-config.js';
+export type ContentFormat = 'html' | 'xml';
+/** Language codes supported by EUR-Lex (24 official EU languages). */
+export type EurLexLanguage = 'EN' | 'FR' | 'DE' | 'ES' | 'IT' | 'PL' | 'PT' | 'NL' | 'CS' | 'DA' | 'EL' | 'ET' | 'FI' | 'HU' | 'LT' | 'LV' | 'MT' | 'RO' | 'SK' | 'SL' | 'SV' | 'BG' | 'HR' | 'GA';
+export interface FetchContentResult {
+    content: string;
+    contentAvailable: boolean;
+    format: ContentFormat;
+    language: EurLexLanguage;
+    /** Set when a language fallback occurred. */
+    languageFallback?: string;
+}
+export declare class EurLexContentService {
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    constructor(_config: AppConfig, _storage: StorageService, serverConfig: ServerConfig);
+    /**
+     * Build the EUR-Lex legal-content URL for a CELEX number.
+     * Pattern: /legal-content/{LANG}/TXT/{FORMAT}/?uri=CELEX:{celex}
+     */
+    buildContentUrl(celexNumber: string, language: EurLexLanguage, format: ContentFormat): string;
+    /**
+     * Fetch the full text content of an EU act by CELEX number.
+     * If the requested language is unavailable, falls back to English.
+     * Returns `contentAvailable: false` with an empty string if both attempts fail.
+     */
+    fetchContent(celexNumber: string, language: EurLexLanguage, format: ContentFormat, ctx: Context): Promise<FetchContentResult>;
+    /**
+     * Attempt to fetch content for a specific language. Returns null on non-200 or
+     * empty/redirect response rather than throwing — callers handle fallback logic.
+     */
+    private tryFetch;
+}
+export declare function initEurLexContentService(config: AppConfig, storage: StorageService, serverConfig: ServerConfig): void;
+export declare function getEurLexContentService(): EurLexContentService;
+//# sourceMappingURL=eurlex-content-service.d.ts.map

package/dist/services/eurlex-content/eurlex-content-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eurlex-content-service.d.ts","sourceRoot":"","sources":["../../../src/services/eurlex-content/eurlex-content-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,CAAC;AAE3C,sEAAsE;AACtE,MAAM,MAAM,cAAc,GACtB,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;AAET,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,cAAc,CAAC;IACzB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY;IAKpF;;;OAGG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM;IAK7F;;;;OAIG;IACG,YAAY,CAChB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,kBAAkB,CAAC;IAuB9B;;;OAGG;YACW,QAAQ;CA0CvB;AAMD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,YAAY,GACzB,IAAI,CAEN;AAED,wBAAgB,uBAAuB,IAAI,oBAAoB,CAO9D"}

package/dist/services/eurlex-content/eurlex-content-service.js

@@ -0,0 +1,93 @@
+/**
+ * @fileoverview EurLexContentService — HTTP client for the EUR-Lex REST content API.
+ * Fetches full HTML or XML text of EU legal acts via the legal-content URL pattern.
+ * Document content is NOT available via CELLAR work URI content negotiation (returns 400).
+ * @module services/eurlex-content/eurlex-content-service
+ */
+import { serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { withRetry } from '@cyanheads/mcp-ts-core/utils';
+export class EurLexContentService {
+    baseUrl;
+    timeoutMs;
+    constructor(_config, _storage, serverConfig) {
+        this.baseUrl = serverConfig.eurLexContentBaseUrl.replace(/\/$/, '');
+        this.timeoutMs = serverConfig.sparqlQueryTimeoutMs;
+    }
+    /**
+     * Build the EUR-Lex legal-content URL for a CELEX number.
+     * Pattern: /legal-content/{LANG}/TXT/{FORMAT}/?uri=CELEX:{celex}
+     */
+    buildContentUrl(celexNumber, language, format) {
+        const fmt = format === 'xml' ? 'XML' : 'HTML';
+        return `${this.baseUrl}/legal-content/${language}/TXT/${fmt}/?uri=CELEX:${celexNumber}`;
+    }
+    /**
+     * Fetch the full text content of an EU act by CELEX number.
+     * If the requested language is unavailable, falls back to English.
+     * Returns `contentAvailable: false` with an empty string if both attempts fail.
+     */
+    async fetchContent(celexNumber, language, format, ctx) {
+        const primary = await this.tryFetch(celexNumber, language, format, ctx);
+        if (primary !== null) {
+            return { content: primary, language, format, contentAvailable: true };
+        }
+        // Language fallback: try English if primary language failed
+        if (language !== 'EN') {
+            const fallback = await this.tryFetch(celexNumber, 'EN', format, ctx);
+            if (fallback !== null) {
+                return {
+                    content: fallback,
+                    language: 'EN',
+                    format,
+                    contentAvailable: true,
+                    languageFallback: `Requested language ${language} unavailable; returned English content.`,
+                };
+            }
+        }
+        return { content: '', language, format, contentAvailable: false };
+    }
+    /**
+     * Attempt to fetch content for a specific language. Returns null on non-200 or
+     * empty/redirect response rather than throwing — callers handle fallback logic.
+     */
+    async tryFetch(celexNumber, language, format, ctx) {
+        const url = this.buildContentUrl(celexNumber, language, format);
+        return withRetry(async () => {
+            const response = await fetch(url, {
+                headers: { Accept: format === 'xml' ? 'application/xml' : 'text/html' },
+                signal: AbortSignal.timeout(this.timeoutMs),
+                redirect: 'follow',
+            });
+            if (response.status === 404 || response.status === 302 || !response.ok) {
+                return null;
+            }
+            const text = await response.text();
+            // Detect HTML error pages masquerading as success (e.g. rate-limit pages)
+            if (format === 'xml' && /^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text)) {
+                throw serviceUnavailable('EUR-Lex returned HTML instead of XML content.');
+            }
+            // Empty content means unavailable
+            if (text.trim().length < 100) {
+                return null;
+            }
+            return text;
+        }, {
+            operation: 'EurLexContentService.tryFetch',
+            baseDelayMs: 1000,
+            maxRetries: 2,
+            signal: ctx.signal,
+        }).catch(() => null); // Treat fetch failures as unavailable for language fallback
+    }
+}
+// --- Init/accessor pattern ---
+let _service;
+export function initEurLexContentService(config, storage, serverConfig) {
+    _service = new EurLexContentService(config, storage, serverConfig);
+}
+export function getEurLexContentService() {
+    if (!_service) {
+        throw new Error('EurLexContentService not initialized — call initEurLexContentService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=eurlex-content-service.js.map

package/dist/services/eurlex-content/eurlex-content-service.js.map

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

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "@cyanheads/eur-lex-mcp-server",
+  "version": "0.1.1",
+  "mcpName": "io.github.cyanheads/eur-lex-mcp-server",
+  "description": "Search EU legislation, CJEU case law, and treaties; traverse the CELLAR relationship graph; resolve EuroVoc concepts via MCP. STDIO or Streamable HTTP.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "eur-lex-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "changelog/",
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "CLAUDE.md",
+    "AGENTS.md",
+    "Dockerfile",
+    "server.json"
+  ],
+  "scripts": {
+    "build": "bun run scripts/build.ts",
+    "rebuild": "bun run scripts/clean.ts && bun run scripts/build.ts",
+    "clean": "bun run scripts/clean.ts",
+    "devcheck": "bun run scripts/devcheck.ts",
+    "audit:refresh": "rm -f bun.lock && bun install && bun audit",
+    "tree": "bun run scripts/tree.ts",
+    "list-skills": "bun run scripts/list-skills.ts",
+    "format": "biome check --write .",
+    "format:unsafe": "biome check --write --unsafe .",
+    "lint:mcp": "bun run scripts/lint-mcp.ts",
+    "lint:packaging": "bun run scripts/lint-packaging.ts",
+    "bundle": "npm run build && npx -y @anthropic-ai/mcpb pack . dist/eur-lex-mcp-server.mcpb",
+    "changelog:build": "bun run scripts/build-changelog.ts",
+    "changelog:check": "bun run scripts/build-changelog.ts --check",
+    "release:github": "bun run scripts/release-github.ts",
+    "publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
+    "test": "vitest run",
+    "start": "node dist/index.js",
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js"
+  },
+  "keywords": [
+    "eur-lex",
+    "eu-law",
+    "european-union",
+    "cellar",
+    "sparql",
+    "cjeu",
+    "eurovoc",
+    "legislation",
+    "legal",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "typescript",
+    "bun",
+    "stdio",
+    "streamable-http",
+    "ai-agent"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cyanheads/eur-lex-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cyanheads/eur-lex-mcp-server/issues"
+  },
+  "homepage": "https://github.com/cyanheads/eur-lex-mcp-server#readme",
+  "author": "cyanheads <casey@caseyjhand.com> (https://github.com/cyanheads/eur-lex-mcp-server#readme)",
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/cyanheads"
+    },
+    {
+      "type": "buy_me_a_coffee",
+      "url": "https://www.buymeacoffee.com/cyanheads"
+    }
+  ],
+  "license": "Apache-2.0",
+  "packageManager": "bun@1.3.11",
+  "engines": {
+    "bun": ">=1.3.0",
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cyanheads/mcp-ts-core": "0.9.21",
+    "pino-pretty": "^13.1.3",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.16",
+    "@types/node": "^25.9.1",
+    "depcheck": "^1.4.7",
+    "ignore": "^7.0.5",
+    "tsc-alias": "^1.8.17",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  }
+}

package/server.json

@@ -0,0 +1,161 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.cyanheads/eur-lex-mcp-server",
+  "description": "Search EU legislation, CJEU case law, and treaties; traverse CELLAR graph; browse EuroVoc concepts.",
+  "repository": {
+    "url": "https://github.com/cyanheads/eur-lex-mcp-server",
+    "source": "github"
+  },
+  "version": "0.1.1",
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "@cyanheads/eur-lex-mcp-server",
+      "runtimeHint": "bun",
+      "version": "0.1.1",
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "run"
+        },
+        {
+          "type": "positional",
+          "value": "start:stdio"
+        }
+      ],
+      "environmentVariables": [
+        {
+          "name": "CELLAR_SPARQL_ENDPOINT",
+          "description": "CELLAR SPARQL endpoint URL override (e.g., for a local Virtuoso mirror).",
+          "format": "string",
+          "isRequired": false,
+          "default": "http://publications.europa.eu/webapi/rdf/sparql"
+        },
+        {
+          "name": "EURLEX_CONTENT_BASE_URL",
+          "description": "EUR-Lex content API base URL override.",
+          "format": "string",
+          "isRequired": false,
+          "default": "https://eur-lex.europa.eu"
+        },
+        {
+          "name": "SPARQL_QUERY_TIMEOUT_MS",
+          "description": "Client-side timeout for SPARQL requests in milliseconds.",
+          "format": "string",
+          "isRequired": false,
+          "default": "55000"
+        },
+        {
+          "name": "MAX_SPARQL_RESULTS",
+          "description": "Enforced ceiling on LIMIT in all generated SPARQL queries.",
+          "format": "string",
+          "isRequired": false,
+          "default": "100"
+        },
+        {
+          "name": "MCP_LOG_LEVEL",
+          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
+          "format": "string",
+          "isRequired": false,
+          "default": "info"
+        }
+      ],
+      "transport": {
+        "type": "stdio"
+      }
+    },
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "@cyanheads/eur-lex-mcp-server",
+      "runtimeHint": "bun",
+      "version": "0.1.1",
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "run"
+        },
+        {
+          "type": "positional",
+          "value": "start:http"
+        }
+      ],
+      "environmentVariables": [
+        {
+          "name": "MCP_HTTP_HOST",
+          "description": "The hostname for the HTTP server.",
+          "format": "string",
+          "isRequired": false,
+          "default": "127.0.0.1"
+        },
+        {
+          "name": "MCP_HTTP_PORT",
+          "description": "The port to run the HTTP server on.",
+          "format": "string",
+          "isRequired": false,
+          "default": "3010"
+        },
+        {
+          "name": "MCP_HTTP_ENDPOINT_PATH",
+          "description": "The endpoint path for the MCP server.",
+          "format": "string",
+          "isRequired": false,
+          "default": "/mcp"
+        },
+        {
+          "name": "MCP_PUBLIC_URL",
+          "description": "Public origin for deployments behind a TLS-terminating reverse proxy (e.g. https://mcp.example.com).",
+          "format": "string",
+          "isRequired": false
+        },
+        {
+          "name": "MCP_AUTH_MODE",
+          "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
+          "format": "string",
+          "isRequired": false,
+          "default": "none"
+        },
+        {
+          "name": "MCP_LOG_LEVEL",
+          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
+          "format": "string",
+          "isRequired": false,
+          "default": "info"
+        },
+        {
+          "name": "CELLAR_SPARQL_ENDPOINT",
+          "description": "CELLAR SPARQL endpoint URL override (e.g., for a local Virtuoso mirror).",
+          "format": "string",
+          "isRequired": false,
+          "default": "http://publications.europa.eu/webapi/rdf/sparql"
+        },
+        {
+          "name": "EURLEX_CONTENT_BASE_URL",
+          "description": "EUR-Lex content API base URL override.",
+          "format": "string",
+          "isRequired": false,
+          "default": "https://eur-lex.europa.eu"
+        },
+        {
+          "name": "SPARQL_QUERY_TIMEOUT_MS",
+          "description": "Client-side timeout for SPARQL requests in milliseconds.",
+          "format": "string",
+          "isRequired": false,
+          "default": "55000"
+        },
+        {
+          "name": "MAX_SPARQL_RESULTS",
+          "description": "Enforced ceiling on LIMIT in all generated SPARQL queries.",
+          "format": "string",
+          "isRequired": false,
+          "default": "100"
+        }
+      ],
+      "transport": {
+        "type": "streamable-http",
+        "url": "http://localhost:3010/mcp"
+      }
+    }
+  ]
+}