@cyanheads/wikidata-mcp-server 0.1.1

package/dist/services/wikidata/wikidata-rest-service.js

@@ -0,0 +1,293 @@
+/**
+ * @fileoverview Wikidata REST API and MediaWiki wbgetentities client.
+ * @module services/wikidata/wikidata-rest-service
+ */
+import { fetchWithTimeout, httpErrorFromResponse, withRetry, } from '@cyanheads/mcp-ts-core/utils';
+import { getServerConfig } from '../../config/server-config.js';
+const REST_BASE = 'https://www.wikidata.org/w/rest.php/wikibase/v1';
+const MW_API_BASE = 'https://www.wikidata.org/w/api.php';
+/** Checks if an ID is a Q-ID (item). */
+export function isQId(id) {
+    return /^[Qq]\d+$/.test(id);
+}
+/** Checks if an ID is a P-ID (property). */
+export function isPId(id) {
+    return /^[Pp]\d+$/.test(id);
+}
+/** Normalizes a Q/P-ID to uppercase (e.g. q76 → Q76). */
+export function normalizeId(id) {
+    return id.toUpperCase();
+}
+export class WikidataRestService {
+    userAgent;
+    restTimeoutMs;
+    constructor(_config, _storage) {
+        const serverCfg = getServerConfig();
+        this.userAgent = serverCfg.userAgent;
+        this.restTimeoutMs = serverCfg.restTimeoutMs;
+    }
+    get headers() {
+        return {
+            'User-Agent': this.userAgent,
+            Accept: 'application/json',
+        };
+    }
+    getJson(url, ctx) {
+        const rctx = ctx;
+        return withRetry(async () => {
+            const response = await fetchWithTimeout(url, this.restTimeoutMs, rctx, {
+                headers: this.headers,
+                signal: ctx.signal,
+            });
+            if (!response.ok) {
+                throw await httpErrorFromResponse(response, { service: 'Wikidata REST' });
+            }
+            const text = await response.text();
+            if (/^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text)) {
+                const { serviceUnavailable } = await import('@cyanheads/mcp-ts-core/errors');
+                throw serviceUnavailable('Wikidata REST returned HTML — likely rate-limited or under maintenance.');
+            }
+            return JSON.parse(text);
+        }, { operation: 'WikidataRest.getJson', context: rctx, baseDelayMs: 1000, signal: ctx.signal });
+    }
+    /** Search items or properties by text. */
+    async search(query, type, language, limit, offset, ctx) {
+        const path = type === 'item' ? 'search/items' : 'search/properties';
+        const params = new URLSearchParams({
+            q: query,
+            language,
+            limit: String(limit),
+            ...(offset > 0 ? { offset: String(offset) } : {}),
+        });
+        const url = `${REST_BASE}/${path}?${params}`;
+        ctx.log.debug('Searching entities', { type, query, language, limit, offset });
+        const data = await this.getJson(url, ctx);
+        return data.results ?? [];
+    }
+    /** Fetch a single entity by QID or PID. Routes by ID prefix. */
+    fetchEntity(id, ctx) {
+        const normalized = normalizeId(id);
+        const path = isQId(normalized)
+            ? `entities/items/${normalized}`
+            : `entities/properties/${normalized}`;
+        const url = `${REST_BASE}/${path}`;
+        ctx.log.debug('Fetching entity', { id: normalized });
+        return this.getJson(url, ctx);
+    }
+    /** Fetch statements for an entity, optionally filtered to specific P-IDs. */
+    async fetchStatements(id, properties, ctx) {
+        const normalized = normalizeId(id);
+        const basePath = isQId(normalized)
+            ? `entities/items/${normalized}/statements`
+            : `entities/properties/${normalized}/statements`;
+        // The REST API supports a single `property` filter param per request.
+        // For multiple properties we fetch all and client-filter.
+        const url = properties?.length === 1
+            ? `${REST_BASE}/${basePath}?property=${properties[0]?.toUpperCase()}`
+            : `${REST_BASE}/${basePath}`;
+        ctx.log.debug('Fetching statements', { id: normalized, properties });
+        const data = await this.getJson(url, ctx);
+        if (properties && properties.length > 1) {
+            const upperProps = new Set(properties.map((p) => p.toUpperCase()));
+            return Object.fromEntries(Object.entries(data).filter(([key]) => upperProps.has(key.toUpperCase())));
+        }
+        return data;
+    }
+    /** Fetch sitelinks for a Q-ID, optionally filtered to specific site codes. */
+    async fetchSitelinks(id, sites, ctx) {
+        const normalized = normalizeId(id);
+        const url = `${REST_BASE}/entities/items/${normalized}/sitelinks`;
+        ctx.log.debug('Fetching sitelinks', { id: normalized, sites });
+        const data = await this.getJson(url, ctx);
+        if (sites?.length) {
+            const siteSet = new Set(sites);
+            return Object.fromEntries(Object.entries(data).filter(([key]) => siteSet.has(key)));
+        }
+        return data;
+    }
+    /**
+     * Batch-resolve labels and descriptions for up to 50 IDs using the MediaWiki
+     * wbgetentities API (the REST API has no batch label endpoint).
+     */
+    async fetchLabels(ids, languages, ctx) {
+        // Process in batches of 50
+        const batches = [];
+        for (let i = 0; i < ids.length; i += 50) {
+            batches.push(ids.slice(i, i + 50));
+        }
+        const results = {};
+        await Promise.all(batches.map(async (batch) => {
+            const params = new URLSearchParams({
+                action: 'wbgetentities',
+                ids: batch.map(normalizeId).join('|'),
+                props: 'labels|descriptions',
+                languages: languages.join('|'),
+                format: 'json',
+                formatversion: '2',
+            });
+            const url = `${MW_API_BASE}?${params}`;
+            ctx.log.debug('Fetching labels batch', { count: batch.length, languages });
+            const rctx = ctx;
+            const data = await withRetry(async () => {
+                const response = await fetchWithTimeout(url, this.restTimeoutMs, rctx, {
+                    headers: this.headers,
+                    signal: ctx.signal,
+                });
+                if (!response.ok) {
+                    throw await httpErrorFromResponse(response, { service: 'Wikidata MW API' });
+                }
+                const text = await response.text();
+                if (/^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text)) {
+                    const { serviceUnavailable } = await import('@cyanheads/mcp-ts-core/errors');
+                    throw serviceUnavailable('Wikidata MW API returned HTML — likely rate-limited.');
+                }
+                return JSON.parse(text);
+            }, {
+                operation: 'WikidataRest.fetchLabels',
+                context: rctx,
+                baseDelayMs: 1000,
+                signal: ctx.signal,
+            });
+            if (data.entities) {
+                for (const [id, entity] of Object.entries(data.entities)) {
+                    if (entity.missing === '')
+                        continue;
+                    const labelMap = {};
+                    const descMap = {};
+                    if (entity.labels) {
+                        for (const [lang, lb] of Object.entries(entity.labels)) {
+                            labelMap[lang] = lb.value;
+                        }
+                    }
+                    if (entity.descriptions) {
+                        for (const [lang, ds] of Object.entries(entity.descriptions)) {
+                            descMap[lang] = ds.value;
+                        }
+                    }
+                    results[id] = { labels: labelMap, descriptions: descMap };
+                }
+            }
+        }));
+        return results;
+    }
+}
+// ---------------------------------------------------------------------------
+// Statement value normalization
+// ---------------------------------------------------------------------------
+/** Normalize a raw statement value to the domain type. */
+export function normalizeStatementValue(dataType, rawContent) {
+    const effective = dataType ?? 'string';
+    if (effective === 'wikibase-item') {
+        const content = rawContent;
+        if (typeof content === 'object' && content !== null && 'id' in content) {
+            return { type: 'wikibase-item', qid: content.id ?? '' };
+        }
+        if (typeof content === 'string') {
+            return { type: 'wikibase-item', qid: content };
+        }
+        return { type: 'wikibase-item', qid: String(rawContent ?? '') };
+    }
+    if (effective === 'time') {
+        const content = rawContent;
+        if (typeof content === 'object' && content !== null) {
+            return { type: 'time', time: content.time ?? '', precision: content.precision ?? 0 };
+        }
+        return { type: 'other', raw: rawContent };
+    }
+    if (effective === 'quantity') {
+        const content = rawContent;
+        if (typeof content === 'object' && content !== null) {
+            const unit = content.unit;
+            return unit !== undefined
+                ? { type: 'quantity', amount: content.amount ?? '', unit }
+                : { type: 'quantity', amount: content.amount ?? '' };
+        }
+        return { type: 'other', raw: rawContent };
+    }
+    if (effective === 'monolingualtext') {
+        const content = rawContent;
+        if (typeof content === 'object' && content !== null) {
+            return {
+                type: 'monolingualtext',
+                text: content.text ?? '',
+                language: content.language ?? '',
+            };
+        }
+        return { type: 'other', raw: rawContent };
+    }
+    if (effective === 'globe-coordinate') {
+        const content = rawContent;
+        if (typeof content === 'object' && content !== null) {
+            return {
+                type: 'globe-coordinate',
+                latitude: content.latitude ?? 0,
+                longitude: content.longitude ?? 0,
+                ...(content.precision != null ? { precision: content.precision } : {}),
+            };
+        }
+        return { type: 'other', raw: rawContent };
+    }
+    if ([
+        'external-id',
+        'url',
+        'string',
+        'commonsMedia',
+        'geo-shape',
+        'tabular-data',
+        'math',
+        'musical-notation',
+    ].includes(effective)) {
+        return { type: 'string', value: String(rawContent ?? '') };
+    }
+    // Unknown types — preserve as-is
+    return { type: 'other', raw: rawContent };
+}
+/** Normalize a raw statement array to domain statements. */
+export function normalizeStatements(propertyId, rawStatements, labelMap) {
+    return rawStatements.map((raw) => {
+        const dataType = raw.property?.data_type;
+        const rawValue = normalizeStatementValue(dataType, raw.value?.content);
+        // Resolve label for wikibase-item values
+        let value;
+        if (rawValue.type === 'wikibase-item') {
+            const label = labelMap?.[rawValue.qid];
+            value =
+                label !== undefined
+                    ? { type: 'wikibase-item', qid: rawValue.qid, label }
+                    : { type: 'wikibase-item', qid: rawValue.qid };
+        }
+        else {
+            value = rawValue;
+        }
+        const qualifiers = raw.qualifiers?.map((q) => ({
+            property: q.property?.id ?? '',
+            value: normalizeStatementValue(q.property?.data_type, q.value?.content),
+        }));
+        const references = raw.references?.flatMap((ref) => (ref.parts ?? []).map((part) => ({
+            property: part.property?.id ?? '',
+            value: normalizeStatementValue(part.property?.data_type, part.value?.content),
+        })));
+        return {
+            id: raw.id,
+            rank: raw.rank,
+            property: propertyId,
+            value,
+            ...(qualifiers?.length ? { qualifiers } : {}),
+            ...(references?.length ? { references } : {}),
+        };
+    });
+}
+// ---------------------------------------------------------------------------
+// Init / accessor pattern
+// ---------------------------------------------------------------------------
+let _service;
+export function initWikidataRestService(config, storage) {
+    _service = new WikidataRestService(config, storage);
+}
+export function getWikidataRestService() {
+    if (!_service) {
+        throw new Error('WikidataRestService not initialized — call initWikidataRestService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=wikidata-rest-service.js.map

package/dist/services/wikidata/wikidata-rest-service.js.map

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

package/dist/services/wikidata/wikidata-sparql-service.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Wikidata SPARQL Query Service client.
+ * @module services/wikidata/wikidata-sparql-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 { SparqlResponse } from './types.js';
+export declare class WikidataSparqlService {
+    private readonly userAgent;
+    private readonly defaultTimeoutMs;
+    constructor(_config: AppConfig, _storage: StorageService);
+    /**
+     * Execute a SPARQL SELECT query against the Wikidata Query Service.
+     * Injects common prefixes and label SERVICE when appropriate.
+     */
+    query(rawQuery: string, language: string, timeoutMs: number | undefined, ctx: Context): Promise<SparqlResponse>;
+    /** Prepend standard prefixes and inject label SERVICE if needed. */
+    private prepareQuery;
+}
+export declare function initWikidataSparqlService(config: AppConfig, storage: StorageService): void;
+export declare function getWikidataSparqlService(): WikidataSparqlService;
+//# sourceMappingURL=wikidata-sparql-service.d.ts.map

package/dist/services/wikidata/wikidata-sparql-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikidata-sparql-service.d.ts","sourceRoot":"","sources":["../../../src/services/wikidata/wikidata-sparql-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA2CjD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc;IAMxD;;;OAGG;IACH,KAAK,CACH,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,cAAc,CAAC;IAuF1B,oEAAoE;IACpE,OAAO,CAAC,YAAY;CA0BrB;AAQD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAE1F;AAED,wBAAgB,wBAAwB,IAAI,qBAAqB,CAOhE"}

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

@@ -0,0 +1,163 @@
+/**
+ * @fileoverview Wikidata SPARQL Query Service client.
+ * @module services/wikidata/wikidata-sparql-service
+ */
+import { withRetry } from '@cyanheads/mcp-ts-core/utils';
+import { getServerConfig } from '../../config/server-config.js';
+const SPARQL_ENDPOINT = 'https://query.wikidata.org/sparql';
+/** Common SPARQL prefixes pre-pended to every query. */
+const SPARQL_PREFIXES = `PREFIX wd: <http://www.wikidata.org/entity/>
+PREFIX wdt: <http://www.wikidata.org/prop/direct/>
+PREFIX p: <http://www.wikidata.org/prop/>
+PREFIX ps: <http://www.wikidata.org/prop/statement/>
+PREFIX pq: <http://www.wikidata.org/prop/qualifier/>
+PREFIX wikibase: <http://wikiba.se/ontology#>
+PREFIX bd: <http://www.bigdata.com/rdf#>
+PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
+PREFIX schema: <http://schema.org/>
+`;
+/** Label SERVICE snippet injected when language is specified and not already present. */
+const LABEL_SERVICE_SNIPPET = (lang) => `SERVICE wikibase:label { bd:serviceParam wikibase:language "${lang}" }`;
+/**
+ * Extract the human-readable cause from a Blazegraph Java stack trace.
+ * Stack traces look like:
+ *   org.openrdf.query.MalformedQueryException: <reason>
+ *   ... (stack frames)
+ */
+function extractSparqlError(body) {
+    // Try to find the MalformedQueryException message
+    const mqMatch = /MalformedQueryException:\s*(.+?)(?:\r?\n|$)/.exec(body);
+    if (mqMatch?.[1])
+        return mqMatch[1].trim();
+    // Try QueryEvaluationException
+    const qeMatch = /QueryEvaluationException:\s*(.+?)(?:\r?\n|$)/.exec(body);
+    if (qeMatch?.[1])
+        return qeMatch[1].trim();
+    // Try any Exception line
+    const anyMatch = /Exception:\s*(.+?)(?:\r?\n|$)/.exec(body);
+    if (anyMatch?.[1])
+        return anyMatch[1].trim();
+    // Fall back to first 200 chars
+    return body.slice(0, 200).trim();
+}
+export class WikidataSparqlService {
+    userAgent;
+    defaultTimeoutMs;
+    constructor(_config, _storage) {
+        const serverCfg = getServerConfig();
+        this.userAgent = serverCfg.userAgent;
+        this.defaultTimeoutMs = serverCfg.sparqlTimeoutMs;
+    }
+    /**
+     * Execute a SPARQL SELECT query against the Wikidata Query Service.
+     * Injects common prefixes and label SERVICE when appropriate.
+     */
+    query(rawQuery, language, timeoutMs, ctx) {
+        const effectiveTimeout = Math.min(timeoutMs ?? this.defaultTimeoutMs, 55_000);
+        const query = this.prepareQuery(rawQuery, language);
+        ctx.log.debug('Executing SPARQL query', { language, timeoutMs: effectiveTimeout });
+        const rctx = ctx;
+        return withRetry(async () => {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), effectiveTimeout);
+            // Forward cancellation from the caller's signal to our timeout controller
+            const onCallerAbort = () => controller.abort();
+            ctx.signal.addEventListener('abort', onCallerAbort);
+            try {
+                const response = await fetch(SPARQL_ENDPOINT, {
+                    method: 'POST',
+                    headers: {
+                        'User-Agent': this.userAgent,
+                        Accept: 'application/sparql-results+json',
+                        'Content-Type': 'application/x-www-form-urlencoded',
+                    },
+                    body: new URLSearchParams({ query }),
+                    signal: controller.signal,
+                });
+                if (response.status === 429) {
+                    const retryAfter = response.headers.get('Retry-After');
+                    const { rateLimited } = await import('@cyanheads/mcp-ts-core/errors');
+                    throw rateLimited(`Wikidata SPARQL endpoint is rate-limited. ${retryAfter ? `Retry after ${retryAfter}s.` : 'Retry shortly.'}`, { reason: 'throttled', ...(retryAfter ? { retryAfter } : {}) });
+                }
+                if (!response.ok) {
+                    const body = await response.text().catch(() => '');
+                    if (response.status === 400 || response.status === 422) {
+                        const cause = extractSparqlError(body);
+                        const { invalidParams } = await import('@cyanheads/mcp-ts-core/errors');
+                        throw invalidParams(`SPARQL parse error: ${cause}`, { reason: 'parse_error', cause });
+                    }
+                    const { serviceUnavailable } = await import('@cyanheads/mcp-ts-core/errors');
+                    throw serviceUnavailable(`Wikidata SPARQL endpoint returned HTTP ${response.status}.`, {
+                        status: response.status,
+                    });
+                }
+                const text = await response.text();
+                if (/^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text)) {
+                    const { serviceUnavailable } = await import('@cyanheads/mcp-ts-core/errors');
+                    throw serviceUnavailable('SPARQL endpoint returned HTML — likely rate-limited or under maintenance.');
+                }
+                return JSON.parse(text);
+            }
+            catch (err) {
+                if (err instanceof Error && err.name === 'AbortError') {
+                    const { serviceUnavailable } = await import('@cyanheads/mcp-ts-core/errors');
+                    throw serviceUnavailable(`SPARQL query timed out after ${effectiveTimeout / 1000}s. Add a LIMIT clause or simplify the query.`, { reason: 'timeout' });
+                }
+                throw err;
+            }
+            finally {
+                clearTimeout(timeoutId);
+                ctx.signal.removeEventListener('abort', onCallerAbort);
+            }
+        }, {
+            operation: 'WikidataSparql.query',
+            context: rctx,
+            baseDelayMs: 2000,
+            signal: ctx.signal,
+            // Only retry throttle errors (429), not parse errors or timeouts
+            isTransient: (err) => {
+                const e = err;
+                return e?.data?.reason === 'throttled';
+            },
+        });
+    }
+    /** Prepend standard prefixes and inject label SERVICE if needed. */
+    prepareQuery(rawQuery, language) {
+        let query = rawQuery.trim();
+        // Inject label SERVICE if language is set and the SERVICE block is absent
+        const hasLabelService = /SERVICE\s+wikibase:label/i.test(query);
+        if (language && !hasLabelService) {
+            // Insert before closing brace of the last WHERE clause
+            query = query.replace(/\}\s*$/, `  ${LABEL_SERVICE_SNIPPET(language)}\n}`);
+        }
+        // Prepend standard prefixes (only those not already declared)
+        const prefixLines = SPARQL_PREFIXES.split('\n').filter(Boolean);
+        const existingPrefixes = new Set();
+        for (const line of query.split('\n')) {
+            const m = /^PREFIX\s+(\w+:)/i.exec(line.trim());
+            if (m?.[1])
+                existingPrefixes.add(m[1]);
+        }
+        const neededPrefixes = prefixLines
+            .filter((line) => {
+            const m = /^PREFIX\s+(\w+:)/.exec(line);
+            return m?.[1] && !existingPrefixes.has(m[1]);
+        })
+            .join('\n');
+        return neededPrefixes ? `${neededPrefixes}\n${query}` : query;
+    }
+}
+// ---------------------------------------------------------------------------
+// Init / accessor pattern
+// ---------------------------------------------------------------------------
+let _service;
+export function initWikidataSparqlService(config, storage) {
+    _service = new WikidataSparqlService(config, storage);
+}
+export function getWikidataSparqlService() {
+    if (!_service) {
+        throw new Error('WikidataSparqlService not initialized — call initWikidataSparqlService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=wikidata-sparql-service.js.map

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

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

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@cyanheads/wikidata-mcp-server",
+  "version": "0.1.1",
+  "description": "MCP server for Wikidata — entity search and fetch, SPARQL queries, and external ID lookup.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "@cyanheads/wikidata-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "changelog/",
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "CLAUDE.md",
+    "AGENTS.md",
+    "Dockerfile",
+    "server.json"
+  ],
+  "scripts": {
+    "build": "tsx scripts/build.ts",
+    "rebuild": "tsx scripts/clean.ts && tsx scripts/build.ts",
+    "clean": "tsx scripts/clean.ts",
+    "devcheck": "tsx scripts/devcheck.ts",
+    "audit:refresh": "rm -f bun.lock && bun install && bun audit",
+    "tree": "tsx scripts/tree.ts",
+    "list-skills": "tsx scripts/list-skills.ts",
+    "format": "biome check --write --unsafe .",
+    "lint:mcp": "tsx scripts/lint-mcp.ts",
+    "lint:packaging": "tsx scripts/lint-packaging.ts",
+    "bundle": "npm run build && npx -y @anthropic-ai/mcpb pack . dist/wikidata-mcp-server.mcpb",
+    "changelog:build": "tsx scripts/build-changelog.ts",
+    "changelog:check": "tsx scripts/build-changelog.ts --check",
+    "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": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "ai",
+    "llm",
+    "bun",
+    "stdio",
+    "streamable-http",
+    "wikidata",
+    "sparql",
+    "knowledge-graph",
+    "wikibase",
+    "linked-data"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cyanheads/wikidata-mcp-server"
+  },
+  "license": "Apache-2.0",
+  "engines": {
+    "bun": ">=1.3.0",
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cyanheads/mcp-ts-core": "^0.9.7",
+    "pino-pretty": "^13.1.3",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.15",
+    "@types/node": "^25.9.1",
+    "depcheck": "^1.4.7",
+    "ignore": "^7.0.5",
+    "tsc-alias": "^1.8.17",
+    "tsx": "^4.22.3",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  }
+}